Getting Started with the Agent
Datadog’s integrated APM tool eliminates the traditional separation between infrastructure and application performance monitoring. This not only provides greater visibility, but also allows you to see the relationship between application code and the underlying infrastructure.
The Datadog APM is included in our Enterprise plan or as an upgrade to our Pro plan. A free 14-day trial is available. Registered users can visit the APM page of the Datadog app to get started.
APM is available as part of the Datadog Agent with versions 5.11+ as part of the one line install for the Linux and Docker Agents. Currently, Mac and Windows users must perform a manual install of the APM Agent (aka Trace Agent) via a separate install process. The Agent can be enabled by including the following in your Datadog agent configuration file:
apm_enabled: noin your Datadog agent configuration file.
With our infrastructure monitoring, metrics are sent to the Datadog Agent, which then forwards them to Datadog. Similarly, tracing metrics are also sent to the Datadog agent. To enable tracing:
Install the latest Datadog Agent (version 5.11.0 or above is required).
To trace applications in Docker containers, you can use the docker-dd-agent image (tagged version 11.0.5110 or higher) and enable tracing by passing
DD_APM_ENABLED=true as an environment variable.
For additional information, please reference the Docker page
To instrument your application, please select one of the following supported languages.
To instrument an application written in a language that does not yet have official library support, please reference the Tracing API.
The Datadog Agent uses the
/etc/dd-agent/datadog.conf 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 will override the settings defined in the configuration file.
|File setting||Env variable||Description|
|The Datadog Agent will accept trace metrics when the value is set to |
|-||Use this setting to adjust the trace sample rate. The value should be a float between |
|-||The maximum number of traces to sample per second. To disable the limit (not recommended), set to |
|The port that the Datadog Agent’s trace receiver should listen on. The default value is |
|-||The number of unique client connections to allow during one 30 second lease period. The default value is |
|A blacklist of regular expressions to filter out Traces by their Resource name.|
For additional help from Datadog staff and other Datadog community members, join the apm channel in our Datadog Slack. Visit http://chat.datadoghq.com to join the Slack. We maintain a list of community tracing libraries.
You can also reach our APM team via email at firstname.lastname@example.org.