APM & Continuous Profiler with Agent v5
Getting started
APM is available with Datadog Agent versions 5.11+ as part of the one-line installation command for the Linux and Docker Agents. Mac and Windows users must perform a manual installation of the APM Agent (also known as Trace Agent) through a separate installation process.
The Agent can be enabled by including the following in your Datadog Agent configuration file:
APM is enabled by default after Datadog Agent 5.13 (on Linux and Docker), but can be disabled by adding the parameter: apm_enabled: no in your Datadog Agent configuration file.
Installing the Agent
Tracing metrics are sent to the Datadog through the Datadog Agent. To enable tracing:
Install the latest Datadog Agent (version 5.11.0+ is required).
Running the Agent in Docker
To trace applications in Docker containers, use the docker-dd-agent image (tagged version 11.0.5110+) and enable tracing by passing DD_APM_ENABLED=true as an environment variable.
For additional information, reference the Docker page.
Instrument your application
Select one of the following supported languages:
To instrument an application written in a language that does not yet have official library support, reference the Tracing API.
Configuration
The Datadog Agent uses the configuration file for both infrastructure monitoring and APM configuration options.
Additionally, some configuration options may be set as environment variables. Note that options set as environment variables overrides the settings defined in the configuration file.
| File setting | Environment variable | Description |
|---|
apm_enabled | DD_APM_ENABLED | The Datadog Agent accepts trace metrics when the value is set to true. The default value is true. |
receiver_port | DD_RECEIVER_PORT | The port that the Datadog Agent’s trace receiver should listen on. The default value is 8126. |
connection_limit | DD_CONNECTION_LIMIT | The number of unique client connections to allow during one 30 second lease period. The default value is 2000. |
resource | DD_IGNORE_RESOURCE | An exclude list of regular expressions to filter out traces by their resource name. |
For more information about the Datadog Agent, see the dedicated doc page or refer to the datadog.conf.example file.
Trace search
Trace search is available for Agent 5.25.0+. For more information, see the set up instructions in the main APM documentation.
Troubleshooting
Need help? Contact Datadog support.
