The following functionality is in Preview.

Overview

On Linux hosts that use Single Step Instrumentation (SSI), you can enable or disable Datadog SDK-dependent products at the host level with the application_monitoring.yaml file. 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. To enable or disable products, define them under the apm_configuration_default block and set them to true or false.

    Note: If a product is enabled through environment variables set on the SDK, 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
    

Supported products and configuration keys

The following table lists the products and their respective configuration keys:

ProductConfiguration key
APM TracingDD_APM_TRACING_ENABLED
Continuous ProfilerDD_PROFILING_ENABLED
Data Streams MonitoringDD_DATA_STREAMS_ENABLED
App and API Protection (AAP)DD_APPSEC_ENABLED
Code Security (IAST)DD_IAST_ENABLED
Data Jobs MonitoringDD_DATA_JOBS_ENABLED
Software Composition AnalysisDD_APPSEC_SCA_ENABLED

SDK version requirements

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

LanguageMinimum SDK version
Javav1.47.0
Pythonv3.2.0
Node.jsv5.41.0
.NETNot yet supported
PHPv1.8.0
RubyNot yet supported
GoNot yet supported

Further reading

Additional helpful documentation, links, and articles: