Datadog SDK 환경 변수

Datadog SDK 환경 변수

1. Datadog SDK 환경 변수

Datadog SDK에서는 다음의 환경 변수를 기본적으로 사용한다.

환경 변수용도Default
DD_ENVAlpha, Prod와 같은 동작 환경을 지정null
DD_SERVICEApplication Service 이름 지정Auto Detection
DD_VERSIONApplication의 Version 지정null
DD_AGENT_HOSTDataDog Agent의 IP 지정localhost
DD_TRACE_AGENT_PORTDataDog Agent의 Trace Port 지정8126 TCP Port
DD_TRACE_AGENT_URLDataDog Agent의 Trace URL 지정unix:///var/run/datadog/apm.socket가 이용 가능한 경우 unix:///var/run/datadog/apm.socket 사용, 그렇지 않으면 http://localhost:8126 사용
DD_DOGSTATSD_PORTDataDog Agent의 DogStatsD Port 지정8125 UDP Port
DD_DOGSTATSD_URLDataDog Agent의 DogStatsD URL 지정unix:///var/run/datadog/dsd.socket가 이용 가능한 경우 unix:///var/run/datadog/dsd.socket 사용, 그렇지 않으면 udp://localhost:8125 사용
  • DD_TRACE_AGENT_URL 환경 변수의 우선 순위가 DD_AGENT_HOST, DD_TRACE_AGENT_PORT 환경 변수의 우선 순위보다 높다.
  • DD_DOGSTATSD_URL 환경 변수의 우선 순위가 DD_DOGSTATSD_PORT 환경 변수의 우선 순위보다 높다.

1.1. DD Trace SDK 환경 변수 지원 현황

Trace 수집을 지원하는 DD Trace SDK에서는 다음의 환경 변수를 지원한다.

환경 변수JavaGolangPythonRubyNodeJS
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 지원dd-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 지원
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 환경 변수 지원 현황

Metric 수집을 지원하는 DogStatsD SDK에서는 다음의 환경 변수를 지원한다.

환경 변수JavaGolangPythonRubyNodeJS
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 이상지원 Xdogstatsd-ruby-5.6.0 이상지원 X