Docs
Record
Datadog SDK Environment Variables

Datadog SDK Environment Variables

1. Datadog SDK Environment Variables

The Datadog SDK uses the following environment variables by default.

Environment VariablePurposeDefault
DD_ENVSpecifies the operating environment such as Alpha, Prodnull
DD_SERVICESpecifies the Application Service nameAuto Detection
DD_VERSIONSpecifies the Application Versionnull
DD_AGENT_HOSTSpecifies the IP of DataDog Agentlocalhost
DD_TRACE_AGENT_PORTSpecifies the Trace Port of DataDog Agent8126 TCP Port
DD_TRACE_AGENT_URLSpecifies the Trace URL of DataDog AgentUses unix:///var/run/datadog/apm.socket if available, otherwise uses http://localhost:8126
DD_DOGSTATSD_PORTSpecifies the DogStatsD Port of DataDog Agent8125 UDP Port
DD_DOGSTATSD_URLSpecifies the DogStatsD URL of DataDog AgentUses unix:///var/run/datadog/dsd.socket if available, otherwise uses udp://localhost:8125
  • The priority of the DD_TRACE_AGENT_URL environment variable is higher than the priority of the DD_AGENT_HOST and DD_TRACE_AGENT_PORT environment variables.
  • The priority of the DD_DOGSTATSD_URL environment variable is higher than the priority of the DD_DOGSTATSD_PORT environment variable.

1.1. DD Trace SDK Environment Variable Support Status

DD Trace SDKs that support Trace collection support the following environment variables.

Environment VariableJavaGolangPythonRubyNodeJS
DD_ENVdd-trace-java v0.48.0+dd-trace-go v1.24.0+dd-trace-py v0.36.0+dd-trace-rb v0.34.0+dd-trace-js v0.20.0+
DD_SERVICEdd-trace-java v0.48.0+dd-trace-go v1.24.0+dd-trace-py v0.36.0+dd-trace-rb v0.34.0+dd-trace-js v0.20.0+
DD_VERSIONdd-trace-java v0.48.0+dd-trace-go v1.24.0+dd-trace-py v0.36.0+dd-trace-rb v0.34.0+dd-trace-js v0.20.0+
DD_AGENT_HOSTdd-trace-java supporteddd-trace-go v1.6.0+dd-trace-py v0.17.0+dd-trace-rb v0.18.0+dd-trace-js v0.7.0+
DD_TRACE_AGENT_PORTdd-trace-java 0.18.0+dd-trace-go v1.6.0+dd-trace-py v0.17.0+dd-trace-rb v0.18.0+dd-trace-js supported
DD_TRACE_AGENT_URLdd-trace-java v0.65.0+dd-trace-go v1.44.0+dd-trace-py v0.48.0+dd-trace-rb 1.11.0+dd-trace-js v5.32.0+

1.2. DogStatsD SDK Environment Variable Support Status

DogStatsD SDKs that support Metric collection support the following environment variables.

Environment VariableJavaGolangPythonRubyNodeJS
DD_ENVjava-dogstatsd-client v2.10.0+datadog-go v3.5.0+datadogpy v0.36.0+dogstatsd-ruby-4.8.0+hot-shots v9.1.0+
DD_SERVICEjava-dogstatsd-client v2.10.0+datadog-go v3.5.0+datadogpy v0.36.0+dogstatsd-ruby-4.8.0+hot-shots v9.1.0+
DD_VERSIONjava-dogstatsd-client v2.10.0+datadog-go v3.5.0+datadogpy v0.36.0+dogstatsd-ruby-4.8.0+hot-shots v9.1.0+
DD_AGENT_HOSTjava-dogstatsd-client v2.8.0+datadog-go v2.2.0+datadogpy v0.28.0+dogstatsd-ruby-5.6.0+hot-shots v6.2.0+
DD_DOGSTATSD_PORTjava-dogstatsd-client v2.8.0+datadog-go v2.2.0+datadogpy v0.28.0+dogstatsd-ruby-5.6.0+hot-shots v6.2.0+
DD_DOGSTATSD_URLjava-dogstatsd-client v4.2.1+datadog-go v5.3.0+Not supporteddogstatsd-ruby-5.6.0+Not supported
ClangFormat Style File, ApplicationDocker Installation and Setting / WSL1 Environment / Windows 10 Environment