Type to search.

Troubleshoot APM PHP Agent

Serverless Observability

Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Stack

The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats.

Availability

  • Generally available

    This functionality is generally available and ready for production usage.

Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments.

This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes.

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.

If you’re an existing Elastic customer with a support contract, create a ticket in the Elastic Support portal. Other users can post in the APM discuss forum.

Important

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.

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 enabled to false. You’ll need to restart your application for the changes to apply.

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 compatibility guarantee for these options so any one can be changed and/or removed even in a minor or patch release.

Configuration 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
ELASTIC_APM_DEV_INTERNAL_BACKEND_COMM_LOG_VERBOSE elastic_apm.dev_internal_backend_comm_log_verbose
Default Type
false Boolean

The log is written under INFO level - see Logging.

Also see Disclaimer for dev_internal_* configuration options.