Is 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.
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 Agentedit
In the unlikely event the agent causes disruptions to a production application, you can disable the agent while you troubleshoot.
Disable the agent by setting
You’ll need to restart your application for the changes to apply.
dev_internal_* configuration optionsedit
Configuration 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 communicationedit
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
The log is written under
INFO level - see Logging.