파이썬(Python) 추적 라이브러리 설정하기

문서 > APM > 애플리케이션 계측 > Datadog 추적 라이브러리 설정 > 파이썬(Python) 추적 라이브러리 설정하기

코드로 추적 라이브러리를 설정한 다음 에이전트를 설정하여 애플리케이션 성능 모니터링(APM) 데이터를 수집합니다. 옵션으로 통합 서비스 태깅 설정 등, 원하는 대로 추적 라이브러리를 설정합니다.

ddtrace-run을 사용하는 경우 다음 환경 변수 옵션을 사용할 수 있습니다.

통합 서비스 태깅

서비스를 위해 env, service 및 version을 설정하는 데 DD_ENV, DD_SERVICE 및 DD_VERSION를 사용할 것을 권장합니다. 통합 서비스 태깅 설명서를 참조하여 이러한 환경 변수 설정 방법에 대한 권장 사항을 확인하세요.

DD_ENV: 애플리케이션 환경을 설정합니다. 예: prod, pre-prod, staging. 환경 설정 방법에서 자세히 알아보세요. 버전 0.38 이상에서 사용할 수 있습니다.
DD_SERVICE: 이 애플리케이션에서 사용되는 서비스 이름입니다. Pylons, Flask 또는 Django와 같은 웹 프레임워크 통합을 위한 미들웨어를 설정할 때 통과된 값입니다. 웹 통합 없이 추적하려면 서비스 이름을 코드로 설정하는 것이 좋습니다(예를 들어 Django 문서를 참조하세요). 버전 0.38 이상에서 사용할 수 있습니다.
DD_VERSION: 애플리케이션 버전을 설정합니다. 예: 1.2.3, 6c44da20, 2020.02.13. 버전 0.38 이상에서 사용할 수 있습니다.

트레이스

DD_TRACE_ENABLED

Default: true
Enable web framework and library instrumentation. When false, the application code doesn’t generate any traces.
See also DD_APM_TRACING_ENABLED.

DD_TRACE_DEBUG

기본값: false
트레이서에서 디버그 로깅을 활성화합니다.

DD_SERVICE_MAPPING

트레이스에서 서비스 이름을 바꾸는 것을 허용하려면 서비스 이름 매핑을 정의하세요. 예: postgres:postgresql,defaultdb:postgresql. 버전 0.47 이상에서 사용할 수 있습니다.

DD_TRACE_RATE_LIMIT

파이썬(Python) 프로세스별로 초당 샘플링하기 위한 최대 스팬 개수입니다 . 기본값은 DD_TRACE_SAMPLE_RATE이 설정된 경우 100입니다. 또는 비율 제한을 Datadog 에이전트에 위임할 수 있습니다.

DD_TRACE_HEADER_TAGS

기본값: null
루트 스팬에서 태그로 보고된 헤더 이름의 쉼표로 구분된 목록입니다. 예: DD_TRACE_HEADER_TAGS="User-Agent:http.user_agent,Referer:http.referer,Content-Type:http.content_type,Etag:http.etag".

DD_TRACE_AGENT_URL

트레이서가 제출하는 트레이스 에이전트의 URL입니다. 설정되면, 호스트 이름 및 포트보다 우선순위를 갖습니다. Datadog 에이전트에서 설정된 datadog.yaml 파일 또는 DD_APM_RECEIVER_SOCKET 환경 변수에서 apm_config.receiver_socket 설정과 결합된 UDS(Unix Domain Socket)를 지원합니다. 예를 들어, HTTP URL을 위한 DD_TRACE_AGENT_URL=http://localhost:8126 및 UDS를 위한 DD_TRACE_AGENT_URL=unix:///var/run/datadog/apm.socket이 있습니다. 에이전트 설정은 receiver_port 또는 DD_APM_RECEIVER_PORT를 기본값 8126 외 다른 값으로 설정하면 DD_AGENT_PORT 또는 DD_TRACE_AGENT_URL이 일치해야 합니다.

DD_SPAN_SAMPLING_RULES

기본값: []
SON 개체 어레이입니다. 스팬의 샘플 비율을 결정하기 위해 규칙은 설정된 순서로 적용됩니다. sample_rate 값은 0.0~1.0(포함)이어야 합니다. 자세한 정보는 수집 메커니즘을 참조하세요.
예:

다음과 같이 서비스 my-service 및 작업 이름 http.request의 스팬(span) 샘플 속도를 50%로 설정하고, 최대 초당 50 트레이스로 설정합니다: '[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]'

Agent

DD_PATCH_MODULES: 이 애플리케이션 실행에 대해 패치된 모듈을 재정의합니다. 다음 형식을 따릅니다. DD_PATCH_MODULES=module:patch,module:patch...
DD_TAGS: 모든 스팬과 프로파일에 추가되는 기본 태그 목록입니다 예: layer:api,team:intake,key:value. 0.38 버전 이상에서 사용할 수 있습니다.
DD_AGENT_HOST: 기본값: localhost
기본 트레이서가 트레이스를 전송하려는 트레이스 에이전트 호스트의 주소를 재정의합니다.
DD_AGENT_PORT: 기본값: 8126
기본 트레이서가 트레이스를 전송하는 포트를 재정의합니다. 에이전트 설정에서 receiver_port 또는 DD_APM_RECEIVER_PORT를 기본값 8126 외 다른 값으로 설정하면 DD_AGENT_PORT 또는 DD_TRACE_AGENT_URL이 일치해야 합니다.
DD_DOGSTATSD_URL: DogStatsD 메트릭을 위한 Datadog 에이전트에 연결하는 데 사용되는 URL입니다. 설정된 경우 호스트 이름과 포트 대비 우선순위를 갖습니다. Datadog 에이전트에 설정된 datadog.yaml 파일 또는 DD_DOGSTATSD_SOCKET 환경 변수에서 dogstatsd_socket 설정과 결합된 USD(Unix Domain Socket)을 지원합니다. 예를 들어 UDP URL을 위한 DD_DOGSTATSD_URL=udp://localhost:8126 및 UDS를 위한 DD_DOGSTATSD_URL=unix:///var/run/datadog/dsd.socket가 있습니다. 에이전트 설정에서 dogstatsd_port 또는 DD_DOGSTATSD_PORT를 기본값 8125 외 다른 값으로 설정하면, 트레이싱 라이브러리 DD_DOGSTATSD_URL 또는 DD_DOGSTATSD_PORT가 일치해야 합니다.
DD_DOGSTATSD_HOST: 기본값: localhost
기본 트레이서가 DogStatsD 메트릭을 전송하려는 트레이스 에이전트 호스트의 주소를 재정의합니다. DD_DOGSTATSD_HOST를 재정의하려면 DD_AGENT_HOST를 사용합니다.
DD_DOGSTATSD_PORT: 기본값: 8125
기본 트레이서가 DogStatsD 메트릭을 제출하려는 포트를 재정의합니다. 에이전트 설정에서 dogstatsd_port 또는 DD_DOGSTATSD_PORT를 기본값 8125 외 다른 값으로 설정하면, 이 추적 라이브러리 DD_DOGSTATSD_PORT 또는 DD_DOGSTATSD_URL이 일치해야 합니다.

로그

DD_LOGS_INJECTION: 기본값: false
로그 및 트레이스 수집 연결을 활성화합니다.

트레이스 컨텍스트 전파

DD_TRACE_PROPAGATION_STYLE_INJECT: Default: tracecontext,Datadog,baggage
Propagation styles to use when injecting tracing headers. For example, use DD_TRACE_PROPAGATION_STYLE_INJECT=Datadog,B3 to inject both Datadog and B3 format headers.
DD_TRACE_PROPAGATION_STYLE_EXTRACT: Default: Value of DD_TRACE_PROPAGATION_STYLE_INJECT (tracecontext,Datadog,baggage)
Propagation styles to use when extracting tracing headers. When multiple values are given, it uses the first header match found. The order of matching is based on the order of values given. For example, DD_TRACE_PROPAGATION_STYLE_EXTRACT=B3,Datadog looks for B3 headers first, and only uses Datadog headers if those are not available.