Overview

On Linux hosts, you can configure Datadog SDKs at the host level using the application_monitoring.yaml file. The file works for any SDK loaded on the host, including those loaded through Single Step Instrumentation (SSI). All instrumented services on the host inherit these settings.

Configuration steps

1. Ensure the application_monitoring.yaml file exists at the following path:

   /etc/datadog-agent/application_monitoring.yaml
   

2. Define configuration values under the apm_configuration_default block.

   Note: If a configuration value is set through environment variables, those values override the settings in application_monitoring.yaml.

   As an example, the following enables profiling and Data Streams Monitoring, and disables tracing:

   apm_configuration_default:
     DD_PROFILING_ENABLED: true
     DD_DATA_STREAMS_ENABLED: true
     DD_APM_TRACING_ENABLED: false
   

3. Restart services on the host to apply the configuration changes.

Supported configuration options

You can set any library configuration environment variable in application_monitoring.yaml.

Note: The Go SDK only supports APM tracing configuration options.

SDK version requirements

The following minimum SDK versions support configuration through application_monitoring.yaml:

Further reading

Additional helpful documentation, links, and articles:

Library configuration optionsDOCUMENTATION