Troubleshooting
editTroubleshooting
editIs something not working as expected? Don’t worry if you can’t figure out what the problem is; we’re here to help! As a first step, ensure your app is compatible with the agent’s supported technologies.
If you’re an existing Elastic customer with a support contract, please create a ticket in the Elastic Support portal. Other users can post in the APM discuss forum.
Please upload your complete debug logs to a service like GitHub Gist so that we can analyze the problem. Logs should include everything from when the application starts up until the first request executes.
Disable the Agent
editIn the unlikely event the agent causes disruptions to a production application, you can disable the agent while you troubleshoot.
Disable the agent by setting enabled
to false
.
You’ll need to restart your application for the changes to apply.
Disclaimer for dev_internal_*
configuration options
editConfiguration options starting with dev_internal_
should be used only for supportability.
It’s recommended to have these options in the configuration for the short periods of time
while resolving an issue with the agent.
There is no backward compatability guarantee for these options
so any one can be changed and/or removed even in a minor or patch release.
Enable verbose log for backend communication
editConfiguration option dev_internal_backend_comm_log_verbose
can be used
to enable verbose log for the agent’s communication with Elastic APM Server.
Environment variable name | Option name in php.ini |
---|---|
|
|
Default | Type |
---|---|
|
Boolean |
The log is written under INFO
level - see Logging.
Also see Disclaimer for dev_internal_*
configuration options.