This documentation covers Agent v6 only, to know how to set up APM tracing with Agent v5, refer to the dedicated APM with Agent v5 doc.
With our infrastructure monitoring, metrics are sent to the Agent, which then forwards them to Datadog. Similarly, tracing metrics are also sent to the Agent: the application code instrumentation flushes to the Agent every 1 s (see here for the Python client for instance) and the Agent flushes to the Datadog API every 10s.
To start tracing your application:
Install the Trace Agent:
On Linux,Windows, and Docker the Trace Agent is pre-packaged with the standard Datadog Agent and no extra configuration is needed.
On Heroku, Deploy the Datadog Trace Agent via the Datadog Heroku Buildpack.
Configure your environment:
An environment is a first class dimension used to scope a whole Datadog APM application. A common use case is to disaggregate metrics from stage environments such as production, staging, and pre-production. Learn how to configure environments.
Note: if you do not configure your own environments, all data will default to
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, visit our list of community tracing libraries.
The APM Agent (also known as trace Agent) is shipped by default with the
Agent 6 in the Linux, MacOS, and Windows packages. The APM Agent is enabled by default on Linux. To enable the check on other platforms or disable it on Linux, update the
apm_config key in your
apm_config: enabled: true
|File setting||Environment variable||Description|
||The Datadog Agent accepts 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.|
Additional helpful documentation, links, and articles: