Python SDK 구성 (Configuring the Python SDK)

원문 보기 위키 갱신 2026.10.05

코드로 SDK를 설정하고 Agent가 APM 데이터를 수집하도록 구성한 뒤, 필요에 따라 SDK를 원하는 대로 구성할 수 있어요. 여기에는 Unified Service Tagging 설정도 포함돼요.

출처: 문서

본문

런타임 구성을 확인하고 설정을 검증하려면 Datadog에서 서비스의 현재 구성을 확인하세요. APM Service Page로 이동해 Service Config를 클릭하고 SDK Configuration 탭을 선택하세요.

ddtrace-run을 사용할 때 다음 환경 변수 옵션을 사용할 수 있어요.

구성 키 (Configuration keys)

이 라이브러리에 사용 가능한 구성 키는 491개예요.

일반 설정 (General Settings)

(26)

최상위 Datadog 구성: API 키, 서비스 식별, Agent 연결, 인테이크 사이트, 호스트명, 전역 태그, 프록시 설정.

DD_AGENT_HOST

타입: string 트레이스 제출을 위한 기본 트레이스 Agent 호스트 주소를 재정의해요. DD_TRACE_AGENT_URL이 설정되면 무시돼요.

DD_API_KEY

타입: string 별칭:DATADOG_API_KEY 에이전트리스 방식(로컬 Agent 없이 Datadog에 직접 데이터 전송)으로 실행할 때 나가는 요청을 인증하는 데 사용하는 Datadog API 키를 설정해요. 에이전트리스 CI 테스트 보고와 LLM Observability 에이전트리스 방식에 필요해요.

DD_APM_FLUSH_DEADLINE_MILLISECONDS

타입: int 기본값: 100 스팬이 일찍 완료되고 임박한 타임아웃에 도달했을 때 충돌하지 않아요.

DD_APM_TRACING_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACING_ENABLED APM 트레이스 데이터 전송을 활성화하거나 비활성화해요. 비활성화하면 다른 제품을 지원하기 위해 트레이싱은 계속 실행되지만, 주기적인 하트비트 트레이스와 수동으로 유지된 트레이스만 전송돼요.

DD_APP_KEY

타입: string 에이전트리스 방식에서 LLM Observability 데이터셋과 실험 요청을 인증하는 데 사용하는 애플리케이션 키를 설정해요. 에이전트리스 방식이 활성화되고 이 키가 설정되지 않으면 애플리케이션 키가 필요한 데이터셋/실험 작업이 실패해요.

DD_CARGO_ARGS

타입: string 설치 시 번들 네이티브 Rust 확장을 빌드할 때 cargo에 전달되는 추가 명령줄 인자. 값은 셸 분할되며(예: --locked --offline과 같이 여러 플래그 제공 가능) Rust 빌드에 직접 전달돼요. 설정하지 않으면 추가 인자가 전달되지 않아요.

DD_DURABLE_CROSS_INVOCATION_TRACING_ENABLED

타입: boolean 기본값: true AWS Durable Execution SDK 통합이 동일한 durable execution의 일시 중지/재개 호출 전반에 걸쳐 트레이스 컨텍스트를 유지하는지 여부를 제어해요.

활성화(기본값)하면 통합이 SDK의 종료 관리자에 훅을 설치해요. 워크플로가 비종료 이유(예: CALLBACK_PENDING)로 일시 중지될 때마다 현재 트레이스 컨텍스트가 실행 상태에 합성 _datadog_{N} STEP 작업으로 저장돼요. 업스트림 Datadog Lambda 래퍼는 재개 호출 시 이 체크포인트를 사용하므로 재개된 aws.durable.execute 스팬이 연결이 끊긴 트레이스를 시작하는 대신 동일한 트레이스를 계속해요.

DD_ENTITY_ID

타입: string 임베디드 DogStatsD 클라이언트를 통해 메트릭을 보내는 클라이언트 엔터티(일반적으로 Kubernetes pod UID)를 식별해요. 설정하면 그 값이 나가는 메트릭에 dd.internal.entity_id 태그로 부착되어 Agent가 올바른 pod/컨테이너 태그로 보강할 수 있고, 클라이언트는 그 옆에 컨테이너 ID를 보내지 않아요. 설정하지 않으면 클라이언트는 컨테이너 ID 출처 감지로 대체돼요(DD_ORIGIN_DETECTION_ENABLED로 제어).

DD_ENV

타입: string 트레이서가 방출하는 모든 텔레메트리(트레이스, 메트릭, 로그, 프로파일)에 적용되는 전역 env 태그를 설정해요. prod, staging, dev 같은 환경을 구분하는 데 사용하세요.

DD_EXTERNAL_ENV

타입: string 출처와 환경 귀속을 위해 방출된 텔레메트리에 부착되는 외부 환경 식별자를 설정해요.

DD_FFE_INTAKE_ENABLED

타입: boolean 기본값: true OpenFeature 통합이 Datadog Agent의 EVP 프록시 엔드포인트에 기능 플래그 노출 이벤트를 보내는지 제어해요. 활성화(기본값)하면 노출 라이터가 Datadog에서 분석하기 위해 각 평가된 기능 플래그 노출을 보고해요. 참이 아닌 값으로 설정하면 노출 보고를 비활성화하면서 OpenFeature 통합의 나머지는 활성 상태로 유지해요.

DD_HOSTNAME

타입: string 호스트명 자동 감지가 신뢰할 수 없을 때 태깅과 텔레메트리에 사용되는 호스트명을 재정의해요. 값은 유효한 호스트명이어야 하며, 잘못된 값은 무시되고 대신 호스트명 자동 감지가 사용돼요.

DD_LIVE_DEBUGGING_ENABLED

타입: boolean 기본값: false Live Debugger를 활성화해 재배포 없이 동적 계측이 실행 중인 애플리케이션에서 런타임 데이터를 캡처할 수 있게 해 줘요. 설정하지 않으면 Live Debugger는 비활성화돼요.

DD_MAIN_PACKAGE

타입: string 애플리케이션의 기본 Python 패키지 이름을 지정해요. 설정하면 트레이서가 해당 패키지의 메타데이터(예: Project-URL: source_code_link 항목)를 읽어 Source Code Integration 태깅에 사용되는 저장소 URL과 커밋 SHA를 도출하고, 프로파일러는 코드 출처(provenance)에서 해당 패키지의 프레임을 사용자 코드로 표시할 때 사용해요. DD_GIT_REPOSITORY_URL과 DD_GIT_COMMIT_SHA가 설정되지 않았을 때 대체값으로 사용돼요. 설정하지 않으면 패키지 기반 Git 메타데이터 조회가 수행되지 않아요.

DD_ML_JOB_ENV

타입: map Ray 작업 워커 환경에 그대로 전달되는 세미콜론 구분 KEY:VALUE 쌍. Ray 작업 제출 API로 시작된 워커에 ddtrace 구성(예: DD_SERVICE:my-svc;DD_AGENT_HOST:10.0.0.1)을 전파하는 데 사용해요.

DD_MODEL_LAB_ENABLED

타입: boolean 기본값: false 활성화하면 MLflow 통합을 자동으로 활성화하고(DD_TRACE_MLFLOW_ENABLED=true 설정과 동일) 기본적으로 MLflow 로그 주입을 켜요. DD_API_KEY와 DD_APP_KEY도 설정되면 MLflow 인증 플러그인이 나가는 MLflow tracking-server 요청에 DD-API-KEY와 DD-APPLICATION-KEY 헤더를 주입해 Datadog의 Model Lab에 대해 인증될 수 있게 해 줘요.

DD_PATCH_MODULES

타입: string ddtrace.auto를 가져올 때(또는 ddtrace-run을 사용할 때) 자동 패치할 통합을 제어하는 쉼표 구분 재정의. 각 항목은 <integration>:<bool> 형식, 예: DD_PATCH_MODULES="redis:true,requests:false". 여기의 항목은 기본 통합별 패치 동작을 재정의해 기본적으로 꺼진 통합을 켜거나 기본적으로 켜진 통합을 끌 수 있어요. 통합 이름은 ddtrace 통합이 사용하는 이름과 일치해요(예: redis, kombu, httplib, urllib3, ray).

DD_SCCACHE_PATH

타입: string 네이티브 확장 빌드 시 C/C++ 및 Rust 컴파일러 호출을 캐시하는 데 사용되는 sccache 바이너리의 절대 경로. 설정하면 빌드가 이를 CMake에 C 및 C++ 컴파일러 런처로 전달해 재빌드를 가속화해요. 설정하지 않으면 컴파일러 캐싱 런처가 구성되지 않고 소스가 직접 컴파일돼요.

DD_SERVERLESS_BUILD

타입: boolean 기본값: false 활성화하면 패키지 이름에 -serverless 접미사를 추가하고 네이티브 확장에서 crashtracker와 ffe Rust 기능을 제외해 서버리스용 wheel을 빌드해요. 서버리스 환경을 위한 더 작은 아티팩트를 만드는 데 사용돼요.

DD_SERVICE

타입: string 별칭:DD_SERVICE_NAME, OTEL_SERVICE_NAME 모든 스팬의 service 태그로 사용되는 서비스 이름을 설정해요. 지정하지 않으면 SDK가 서비스 이름을 자동으로 결정하려 시도해요.

언어별 참고:

.NET: IIS 애플리케이션 이름, 프로세스 시작 어셈블리, 또는 프로세스 이름으로 대체돼요.
Java: 애플리케이션 클래스에 기반한 Java 에이전트의 자동 감지 서비스 이름으로 대체돼요.
Node.js: package.json의 name 필드로 대체돼요.

DD_SERVICE_MAPPING

타입: map 각 플러그인에 서비스 이름을 제공해요. 공백이 있거나 없는 쉼표 구분 plugin:service-name 쌍을 받아요.

DD_SITE

타입: string 기본값: datadoghq.com 에이전트리스 인테이크 URL을 만드는 데 사용되는 사이트 도메인을 설정해요. 설정하지 않으면 기본 사이트가 사용돼요.

DD_TAGS

타입: map 별칭:OTEL_RESOURCE_ATTRIBUTES 쉼표로 구분된 key:value 쌍(예: layer:api,team:intake)으로 제공되는, 트레이스에 적용되는 사용자 지정 태그.

DD_TESTING_RAISE

타입: boolean 기본값: false 활성화하면 애플리케이션을 계속 실행하기 위해 일반적으로 삼켜지는 내부 ddtrace 오류를 대신 다시 발생시켜요. 현재는 트레이서가 등록한 atexit 핸들러와 종료 신호 핸들러가 발생시킨 예외에 영향을 주며, 이는 조용히 무시되는 대신 실제 예외(또는 stderr 트레이스백)로 표면화돼요. 트레이서 자체를 테스트·디버깅하기 위한 것이며, 프로덕션에서는 비활성화 두세요.

DD_USE_SCCACHE

타입: boolean 기본값: false 활성화하면 빌드 중 트레이서 네이티브(C/C++/Rust) 확장 컴파일을 캐시·가속화하기 위해 sccache를 사용해요. 빈번한 재빌드나 다중 컨테이너 배포에 유용해요. sccache가 설치되어 PATH 또는 SCCACHE_PATH / SCCACHE 환경 변수를 통해 발견될 수 있어야 해요. 기본값은 비활성화.

DD_VERSION

타입: string 트레이스와 로그의 version 태그로 사용되는 애플리케이션 버전을 설정해요(예: 1.2.3, 6c44da20, 2020.02.13).

언어별 참고:

PHP: 0.90.0 버전부터 ini_set('datadog.version', ...)를 통한 런타임 변경도 현재 루트 스팬에 적용돼요.

폐기된 키 (Retired keys)

(7)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE

v4.13.3에서 제거됨. 타입: string 기본값: agentless 시작 버전: v4.14.0 기능 플래그 구성 소스 선택: 에이전트리스 백엔드, 원격 구성 또는 오프라인 초기화.

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URL

v4.13.3에서 제거됨. 타입: string 시작 버전: v4.14.0 에이전트리스 구성 소스의 사용자 지정 기본 URL.

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_POLL_INTERVAL_SECONDS

v4.13.3에서 제거됨. 타입: int 기본값: 30 시작 버전: v4.14.0 에이전트리스 모드에서 구성 소스를 요청하는 폴링 간격.

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_REQUEST_TIMEOUT_SECONDS

v4.13.3에서 제거됨. 타입: int 기본값: 5 시작 버전: v4.14.0 에이전트리스 모드에서 구성 소스의 요청 타임아웃.

DD_FEATURE_FLAGS_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.14.0 전역 Feature Flags 킬 스위치. false는 공급자, CDN 폴링, Feature Flags RC 구독을 비활성화해요. true는 소스 해석을 허용하지만 트래픽을 독립적으로 시작하지는 않아요.

DD_FLAGGING_EVALUATION_COUNTS_ENABLED

v4.12.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.13.0 OpenFeature 플래그 평가 횟수의 서버 측 보고를 활성화해요. 활성화(기본값)하면 트레이서가 플래그 평가를 집계하고 기존 feature_flag.evaluations 메트릭과 함께 첫·마지막 평가 타임스탬프를 포함한 플래그별 평가 횟수를 주기적으로 Datadog의 플래그 평가 트랙으로 보내요. 평가 횟수 데이터 전송을 중지하려면 false로 설정하세요. Datadog OpenFeature 플래깅 공급자가 활성화된 경우에만 적용돼요.

DD_TRAINING_STEP_PROFILING

v4.11.4에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.12.0 Pytorch 학습 단계 프로파일링.

트레이싱 코어 (Tracing Core)

(38)

핵심 분산 트레이싱 엔진: Agent 연결, 트레이스·스팬 ID 생성, 스팬 수명주기 관리, 피어 서비스 매핑, 리소스 정규화, 쿼리 문자열 난독화, DB 클라이언트 구성.

DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED

타입: boolean 기본값: true 트레이서가 128비트 W3C 트레이스 ID(32자 hex)를 생성할지, 64비트 Datadog 트레이스 ID(16자 hex)를 생성할지 제어해요. 완전한 W3C traceparent 상호운용성을 위해 128비트 ID가 필요해요.

DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED

타입: boolean 기본값: false 128비트 트레이스 ID를 전체 32자 형식으로 로깅할지, 아니면 16자로 줄일지 제어해요. 더 짧은 형식을 기대하는 시스템과의 호환성을 위해 false로 설정하세요.

DD_TRACE_AGENT_HOSTNAME

타입: string 트레이서가 트레이스를 제출하는 Datadog Agent의 호스트 이름을 설정해요. 둘 다 설정되면 DD_AGENT_HOST보다 우선하고, DD_TRACE_AGENT_URL이 제공되면 무시돼요. 설정하지 않으면 트레이서는 DD_AGENT_HOST로, 그다음 사용 가능하면 /var/run/datadog/apm.socket의 Unix 소켓으로, 마지막으로 localhost로 대체돼요.

DD_TRACE_AGENT_PORT

타입: int 기본값: 8126 트레이서가 제출하는 Trace Agent의 포트예요. Agent 구성에서 receiver_port나 DD_APM_RECEIVER_PORT를 기본값 8126이 아닌 값으로 설정했다면 DD_TRACE_AGENT_PORT 또는 DD_TRACE_AGENT_URL이 그 값과 일치해야 해요.

DD_TRACE_AGENT_PROTOCOL_VERSION

타입: string 기본값: 0.4 Agent에 대한 요청에 사용할 프로토콜 버전. 구성된 버전은 설치된 Agent 버전이 지원해야 하며, 그렇지 않으면 모든 트레이스가 버려져요.

DD_TRACE_AGENT_TIMEOUT_SECONDS

타입: decimal 기본값: 2.0 트레이스 데이터를 보낼 때 Datadog Agent에 연결하는 타임아웃(초).

DD_TRACE_AGENT_URL

타입: string 이 라이브러리가 트레이스 데이터를 Datadog Agent에 보내는 URL 엔드포인트. HTTP 또는 Unix 도메인 소켓을 사용할 수 있어요. agent.host와 agent.port보다 우선해요. Agent 구성에서 receiver_port나 DD_APM_RECEIVER_PORT를 기본값 8126이 아닌 값으로 설정했다면 DD_TRACE_AGENT_PORT 또는 DD_TRACE_AGENT_URL이 그 값과 일치해야 해요.

DD_TRACE_API_VERSION

타입: string 트레이스를 인코딩·전송하는 데 사용되는 트레이스 API 버전을 선택해요. 지원 값은 v0.4와 v0.5예요(v0.3은 더 이상 지원되지 않으며 무시됨). 설정하지 않으면 트레이서는 v0.5를 사용하며, Windows, GCP 또는 Azure Functions, 또는 ASM·IAST·AI Guard가 활성화된 경우에는 v0.4로 대체돼요.

DD_TRACE_CLIENT_IP_ENABLED

타입: boolean 기본값: false HTTP 요청 헤더에서 클라이언트 IP 주소의 자동 수집을 활성화하거나 비활성화해요. 활성화하면 IP 주소가 http.client_ip 스팬 태그에 저장돼요.

DD_TRACE_CLIENT_IP_HEADER

타입: string 클라이언트 IP 주소를 해석하는 데 사용되는 선택적 사용자 지정 HTTP 헤더 이름.

DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH

타입: int 기본값: 10 AWS 페이로드 태깅에 사용할 AWS SDK 요청/응답 페이로드의 최대 깊이를 나타내는 정수.

DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_TAGS

타입: int 기본값: 758 AWS 페이로드 태깅에 사용할 스팬당 추출할 최대 태그 수를 나타내는 정수.

DD_TRACE_CLOUD_PAYLOAD_TAGGING_SERVICES

타입: string 기본값: s3,sns,sqs,kinesis,eventbridge,dynamodb 추가 서비스에 대해 AWS 페이로드 태깅을 활성화하려면 이 설정을 사용하세요.

DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING

타입: string AWS SDK 요청에서 편집할 JSONPath 항목의 쉼표 구분 문자열. 설정하면 요청에 대한 AWS 페이로드 태깅을 활성화해요.

DD_TRACE_CLOUD_RESPONSE_PAYLOAD_TAGGING

타입: string AWS SDK 응답에서 편집할 JSONPath 항목의 쉼표 구분 문자열. 설정하면 응답에 대한 AWS 페이로드 태깅을 활성화해요.

DD_TRACE_ENABLED

타입: boolean 기본값: true 별칭:OTEL_TRACES_EXPORTER 트레이싱을 활성화하거나 비활성화해요. 비활성화하면 계측은 계속 실행되지만 트레이스 데이터는 전송되지 않아요.

DD_TRACE_EXPERIMENTAL_FEATURES_ENABLED

타입: string 지원 입력: 실험적 기능을 지원하는 구성 옵션의 쉼표 구분 목록. 지원 값: all, DD_TAGS (Java, .NET) 주의 사항: Java와 .NET에서만 지원됨 설명: 특정 구성 옵션에 대한 실험적 기능을 활성화해요. 활성화하면 이러한 기능이 추가 기능을 제공할 수 있지만 아직 안정적이지 않으며 향후 릴리스에서 변경되거나 제거될 수 있어요. all 키워드로 모든 실험적 기능을 활성화하거나 개별 기능을 명시적으로 나열할 수 있어요.

DD_TRACE_HEALTH_METRICS_ENABLED

타입: boolean 기본값: false true로 설정하면 트레이서 헬스 메트릭을 전송해요.

DD_TRACE_METHODS

타입: string 추적할 메서드 목록. 각 항목이 Namespace.TypeName[MethodNames] 형식인 세미콜론(;) 구분 목록을 받아요. 여기서 MethodNames는 쉼표(,) 구분 메서드 이름 목록 또는 * 와일드카드예요.

제네릭 타입의 경우 꺾쇠 괄호와 타입 매개변수 이름을 백틱(`)과 제네릭 타입 매개변수 수로 바꾸세요. 예: Dictionary<TKey, TValue>는 Dictionary`2로 작성해야 해요. 제네릭 메서드의 경우 메서드 이름만 지정하면 돼요.

참고: 와일드카드 메서드 지원([*])은 생성자, 속성 getter/setter, Equals, Finalize, GetHashCode, ToString을 제외한 타입의 모든 메서드를 선택해요.

DD_TRACE_NATIVE_SPAN_EVENTS

타입: boolean 기본값: false 스팬 이벤트를 meta.events JSON 대신 네이티브 span_events 페이로드 형식으로 인코딩해요.

DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP

타입: string 별칭:DD_OBFUSCATION_QUERY_STRING_REGEXP 들어오는 요청의 쿼리 문자열에서 http.url 태그에 보고되는 민감한 데이터를 편집하는 정규식(일치 항목은 <redacted>로 대체됨).

DD_TRACE_PARTIAL_FLUSH_ENABLED

타입: boolean 기본값: true 큰 트레이스를 Agent에 증분 플러시하여 Agent의 거부 가능성을 줄여요. 오래 지속되는 트레이스나 스팬이 많은 트레이스가 있을 때만 사용하세요. 유효한 값은 true 또는 false예요. 버전 1.26.0에서 추가되었으며 Datadog Agent 7.26.0+와만 호환돼요.

DD_TRACE_PARTIAL_FLUSH_MIN_SPANS

타입: int 기본값: 300 부분 플러시가 트리거되기 전 트레이스의 최소 스팬 수.

DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED

타입: boolean 기본값: false 활성화하면 트레이서가 Naming Schema v0에서 v1 피어 서비스 기본 알고리즘을 사용해 적격 스팬에 대한 기본 peer.service 값을 계산해요. 비활성화하면 Naming Schema v0는 peer.service를 설정하지 않은 채 둬요.

DD_TRACE_PEER_SERVICE_MAPPING

타입: map 감지된 피어 서비스 이름을 스팬에 부착하기 전에 정규화된 값으로 매핑해요.

DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED

타입: boolean 기본값: false 활성화하면 Naming Schema v0에서 통합이 inferred 서비스 이름 사용을 중지하고 애플리케이션 서비스 이름으로 대체해요. 통합과 무관하게 모든 스팬이 DD_SERVICE 아래에 보고되도록 하려면 이 옵션을 사용하세요.

DD_TRACE_REPORT_HOSTNAME

타입: boolean 기본값: false 각 트레이스에 대해 시스템 호스트명을 보고할지 여부. 비활성화하면 Agent의 호스트명이 대신 사용돼요.

DD_TRACE_RESOURCE_RENAMING_ALWAYS_SIMPLIFIED_ENDPOINT

타입: boolean 기본값: false 활성화하면 명시적 엔드포인트를 사용할 수 있는 경우에도 항상 Resource Renaming 단순화 알고리즘의 결과로 http.endpoint 태그를 설정해요.

DD_TRACE_RESOURCE_RENAMING_ENABLED

타입: boolean 기본값: false 들어오는 HTTP 요청에 대해 http.endpoint 태그가 계산·추가되는지 제어해요. 시작 시 애플리케이션 보안이 활성화되지 않는 한 기본적으로 비활성화되며, 이 설정으로 명시적으로 활성화하거나 비활성화할 수 있어요.

DD_TRACE_SPAN_ATTRIBUTE_SCHEMA

타입: string 기본값: v0 통합이 사용하는 스팬 속성 및 명명 스키마 버전을 선택해요. 허용 값: v0, v1.

DD_TRACE_SPAN_TRACEBACK_MAX_SIZE

타입: int 기본값: 30 오류 스팬에 기록된 예외 트레이스백을 포함해 스팬에 첨부된 트레이스백에 포함되는 최대 스택 프레임 수를 설정해요. 트레이스백이 이 한도를 초과하면 가장 최근 프레임이 유지되고 오래된 프레임은 버려져요. 기본값은 30.

DD_TRACE_STATS_COMPUTATION_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACE_TRACER_METRICS_ENABLED, DD_TRACE_COMPUTE_STATS 클라이언트 측 트레이스 통계 계산이 활성화되는지 제어해요. 새 버전의 Python(3.14+) 또는 Serverless에서 실행할 때 기본적으로 true예요.

DD_TRACE_WRAP_SPAN_NAME_INCLUDE_CLASS

타입: boolean 기본값: false 활성화하면 메서드에서 @tracer.wrap()가 만드는 기본 스팬 이름이 module.method 대신 클래스 이름(module.ClassName.method 등)을 포함해요. 설정되지 않거나 비활성화되면 레거시 일반 이름 형식이 사용되고 더 이상 사용되지 않음 경고가 발생하며, 이 동작은 5.0.0에서 기본값이 될 거예요.

DD_TRACE_WRITER_BUFFER_SIZE_BYTES

타입: int 기본값: 20971520 Datadog Agent로 플러시되기 전 인코딩된 트레이스를 보관하는 데 트레이스 라이터가 사용하는 인메모리 버퍼의 최대 크기(바이트)를 설정해요. 버퍼가 가득 차면 공간이 생길 때까지 새 트레이스가 버려져요. 설정하지 않으면 기본값은 20971520(20MB)이에요.

DD_TRACE_WRITER_INTERVAL_SECONDS

타입: decimal 기본값: 1.0 트레이스 라이터가 버퍼링된 트레이스를 Datadog Agent로 플러시하는 간격(초)을 설정해요. 낮은 값은 추가 오버헤드 대가로 트레이스를 더 자주 보내고, 높은 값은 플러시당 더 많은 트레이스를 일괄 처리해요. 설정하지 않으면 1.0초를 기본값으로 해요.

DD_TRACE_WRITER_MAX_PAYLOAD_SIZE_BYTES

타입: int 기본값: 20971520 Datadog Agent로 보내는 단일 트레이스 페이로드의 최대 크기(바이트)를 설정해요. 버퍼링된 페이로드가 이 한도를 초과하면 라이터가 요청을 한도 아래로 유지하기 위해 일찍 플러시해요. 기본값은 20971520(20MB)이에요.

DD_TRACE_WRITER_REUSE_CONNECTIONS

타입: boolean 기본값: false 활성화하면 트레이스 라이터가 매 플러시마다 새 연결을 여는 대신 단일 HTTP 연결(keep-alive)을 재사용해 트레이스 페이로드를 Datadog Agent로 보내요. 기본적으로 비활성화되며, Agent에 지속 소켓을 유지하는 비용으로 연결 설정 오버헤드를 줄이려면 true로 설정하세요.

DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH

타입: int 기본값: 512 트레이스 태그 전파를 위한 x-datadog-tags 헤더의 최대 길이. 비활성화하려면 0으로 설정하세요.

폐기된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_TRACE_STATS_ADDITIONAL_TAGS

v4.13.3에서 제거됨. 타입: string 시작 버전: v4.15.0 클라이언트 측 통계를 사용할 때 스팬 태그에서 추출되어 APM 통계의 추가 집계 차원(스팬 파생 기본 태그)으로 사용되는 태그 키의 쉼표 구분 목록. 사용자 지정 계측을 사용해 스팬에 직접 추가된 태그 또는 DD_TAGS로 설정된 태그만 지원돼요. 클라이언트 측 통계가 활성화된 경우에만 적용돼요.

트레이스 샘플링 (Trace Sampling)

(6)

어떤 트레이스와 스팬을 유지하거나 버릴지 결정하는 샘플링 규칙과 비율. 서비스별 규칙, 비율 제한, 우선순위 샘플링을 포함해요.

DD_SPAN_SAMPLING_RULES

타입: string 스팬 샘플링: 스팬별 샘플링 우선순위(단일 스팬 샘플링)를 결정하는 데 사용되는 JSON 규칙. DD_SPAN_SAMPLING_RULES와 DD_SPAN_SAMPLING_RULES_FILE이 모두 설정되면 파일 설정은 무시돼요. 규칙은 서비스/이름으로 스팬을 매칭하고 샘플 비율과 선택적 초당 최대 한도를 적용할 수 있어요.

DD_SPAN_SAMPLING_RULES_FILE

타입: string 스팬 샘플링 규칙이 포함된 JSON 파일을 가리켜요. DD_SPAN_SAMPLING_RULES가 이 변수보다 우선해요. 규칙 형식은 DD_SPAN_SAMPLING_RULES를 참고하세요.

DD_TRACE_RATE_LIMIT

타입: int 기본값: 100 초당 샘플링할 최대 트레이스 수를 설정해요. DD_TRACE_SAMPLING_RULES 또는 DD_TRACE_SAMPLE_RATE 중 하나가 설정된 경우에만 적용돼요.

DD_TRACE_SAMPLE_RATE

타입: decimal 별칭:OTEL_TRACES_SAMPLER Agent와 백엔드 사이의 수집 샘플 비율(0.0~1.0)을 제어해요. 별칭으로 OTEL_TRACES_SAMPLER를 사용하세요.

DD_TRACE_SAMPLING_RULES

타입: string 트레이스 수집을 세밀하게 제어할 수 있게 해 주며, 특정 서비스·운영·리소스·태그 트레이스를 대상으로 삼을 수 있어요. 각 객체가 0.0~1.0(포함) 사이의 sample_rate를 포함해야 하는 JSON 배열로 정의돼요. 선택적으로 service, name, resource, tags, max_per_second 필드를 포함할 수 있어요. 객체는 나열된 순서대로 평가되며, 첫 번째 일치하는 객체가 트레이스의 샘플 비율을 결정해요. 자세한 내용은 수집 메커니즘을 참고하세요.

예시:

모든 트레이스의 20% 샘플링: [{"sample_rate": 0.2}]
서비스 이름이 a로 시작하고 운영 이름이 b인 트레이스의 10%, 나머지의 20% 샘플링: [{"service": "a.*", "name": "b", "sample_rate": 0.1}, {"sample_rate": 0.2}]
리소스 이름 HTTP GET 트레이스의 40% 샘플링: [{"resource": "HTTP GET", "sample_rate": 0.4}]
태그 tier=premium 트레이스의 100% 샘플링: [{"tags": {"tier": "premium"}, "sample_rate": 1}]
서비스 my-service와 운영 이름 http.request에 대해 50% 비율로 초당 최대 50 트레이스 샘플링: [{"service": "my-service", "name": "http.request", "sample_rate": 0.5, "max_per_second": 50}]

DD_TRACE_WEBSOCKET_MESSAGES_INHERIT_SAMPLING

타입: boolean 기본값: true 기본적으로 websocket 메시지는 핸드셰이크 중 캡처된 스팬과 동일한 샘플링을 유지해요. 이는 핸드셰이크 스팬이 샘플링되면 세션의 모든 메시지도 샘플링되도록 보장해요. 이 동작을 비활성화하고 각 websocket 메시지를 독립적으로 샘플링하려면 이 구성을 false로 설정하세요.

트레이스 전파 (Trace Propagation)

(11)

분산 트레이스 컨텍스트 전파, 추출·주입 동작, 배기지(baggage) 처리, 헤더 태깅, HTTP 클라이언트·서버 구성, Database Monitoring을 위한 SQL 주석 주입.

DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED

타입: boolean 기본값: true 프로세스 수준 태그(예: 진입점 메타데이터)가 수집되어 트레이싱 페이로드에 부착되는지 제어해요.

DD_HTTP_SERVER_TAG_QUERY_STRING

타입: boolean 기본값: true 서버 스팬에 쿼리 문자열을 보고할지 활성화하거나 비활성화해요. 기본값은 true예요.

DD_TRACE_BAGGAGE_TAG_KEYS

타입: array 기본값: user.id, session.id, account.id 스팬 태그에 복사할 baggage 키의 쉼표 구분 목록. 모든 baggage 항목에 태그를 붙이려면 *로 설정하고, 설정하지 않으면 기본 허용 목록이 사용돼요.

DD_TRACE_HEADER_TAGS

타입: map 지정된 HTTP 헤더를 스팬 태그로 자동 적용해요. 사용자 지정 태그 이름을 지정하지 않으면 태그 키는 요청 헤더에 대해 http.request.headers., 응답 헤더에 대해 http.response.headers.로 기본 설정돼요.

DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING

타입: boolean 기본값: true 별칭:DD_HTTP_CLIENT_TAG_QUERY_STRING 기본적으로 쿼리 문자열 매개변수와 프래그먼트가 웹 클라이언트 스팬의 http.url 태그에 추가돼요. 이 데이터 수집을 방지하려면 false로 설정하세요.

DD_TRACE_HTTP_SERVER_ERROR_STATUSES

타입: string 기본값: 500-599 별칭:DD_HTTP_SERVER_ERROR_STATUSES HTTP 서버 스팬에서 오류로 처리할 HTTP 상태 코드 또는 범위의 쉼표 구분 목록(예: 500-599,404). 5xx 응답만을 오류로 표시하는 기본 동작을 재정의해요.

DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED

타입: boolean 기본값: false 별칭:DD_TRACE_INFERRED_SPANS_ENABLED 활성화하면 트레이서가 추론 프록시 프로파게이터를 등록하는데, 이는 x-dd-proxy* 헤더(현재 x-dd-proxy=aws-apigateway)를 읽고 서버 스팬의 부모로 추론 프록시 스팬을 시작하며 서비스·리소스·태그에 헤더 값을 사용해요.

DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT

타입: string 기본값: continue 들어오는 분산 트레이싱 헤더가 서비스 수준에서 처리되는 방식을 지정해요. 허용 값: continue: 들어오는 분산 트레이싱 헤더가 유효한 트레이스 컨텍스트를 나타내면 SDK가 분산 트레이스를 계속해요. restart: SDK가 항상 새 트레이스를 시작해요. 들어오는 분산 트레이싱 헤더가 유효한 트레이스 컨텍스트를 나타내면 그 트레이스 컨텍스트는 서비스 진입 스팬의 스팬 링크로 표시돼요(continue 구성의 부모 스팬 대신). ignore: SDK가 항상 새 트레이스를 시작하고 모든 들어오는 분산 트레이싱 헤더를 무시해요.

DD_TRACE_PROPAGATION_EXTRACT_FIRST

타입: boolean 기본값: false true로 설정하면 첫 번째 성공적인 트레이스 컨텍스트 추출 후 추출을 중지해요.

DD_TRACE_PROPAGATION_STYLE_EXTRACT

타입: array 기본값: datadog,tracecontext,baggage 별칭:DD_PROPAGATION_STYLE_EXTRACT, DD_TRACE_PROPAGATION_STYLE 분산 트레이싱 전파 데이터를 추출하려 시도할 헤더 형식의 쉼표 구분 목록. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요.

DD_TRACE_PROPAGATION_STYLE_INJECT

타입: array 기본값: datadog,tracecontext,baggage 별칭:DD_PROPAGATION_STYLE_INJECT, DD_TRACE_PROPAGATION_STYLE 서비스 간 분산 트레이스를 전파하기 위해 포함할 헤더 형식의 쉼표 구분 목록. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요.

폐기된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_TRACE_PROPAGATION_AS_SPAN_LINKS

v4.13.3에서 제거됨. 타입: string 시작 버전: v4.15.0 추출된 업스트림 트레이스 컨텍스트가 해당 스팬의 부모로 사용되는 대신 스팬 링크로 생성된 스팬에 부착되는 통합 이름의 쉼표 구분 목록. 예: google_cloud_pubsub,kafka. 설정되지 않거나 비어 있으면 모든 통합이 기본 전파 동작을 사용해요.

트레이스 통합 (Trace Integrations)

(213)

통합별 트레이스 구성: 활성화/비활성화, 애널리틱스, 서비스 이름, 라이브러리 통합에 대한 피어 서비스 재정의 및 특정 계측 비활성화 제어.

구성 종류 (Configuration Kinds)

각 통합은 이러한 구성 패턴 중 하나 이상을 지원할 수 있어요. <INTEGRATION>을 통합 이름(예: GRPC, AWS, REDIS)으로 바꾸세요.

`DD_TRACE_<INTEGRATION>_ENABLED`

(100개 통합)

특정 통합의 트레이싱을 활성화하거나 비활성화해요.

사용 가능한 통합:AIOBOTOCORE, AIOHTTP, AIOHTTP_JINJA2, AIOKAFKA, AIOMYSQL, AIOPG, ALGOLIASEARCH, ANTHROPIC, AREDIS, ASYNCIO, ASYNCPG, AVRO, AWS_LAMBDA, AZURE_COSMOS, AZURE_DURABLE_FUNCTIONS, AZURE_EVENTHUBS, AZURE_EVENTHUBS_BATCH_LINKS, AZURE_SERVICEBUS, AZURE_SERVICEBUS_BATCH_LINKS, BOTO, BOTOCORE, BOTTLE, CELERY, CLAUDE_AGENT_SDK, CONSUL, COVERAGE, CREWAI, DJANGO, DOGPILE_CACHE, DRAMATIQ, ELASTICSEARCH, FALCON, FASTAPI, FLASK, FUTURES, GENAI, GEVENT, GOOGLE_ADK, GOOGLE_CLOUD_PUBSUB, GOOGLE_GENAI, GRAPHQL, GRAPHQL_RESOLVERS, GRPC, GRPC_CLIENT, GRPC_SERVER, HTTPLIB, HTTPX, JINJA2, KAFKA, KOMBU, LANGCHAIN, LANGGRAPH, LITELLM, LOGBOOK, LOGGING, LOGURU, MAKO, MARIADB, MCP, MEMCACHED_COMMAND, MOLTEN, MYSQL, MYSQLDB, OPENAI, OPENAI_AGENTS, OTEL_CTX, PROPAGATION_HTTP_BAGGAGE, PROTOBUF, PSYCOPG, PYDANTIC_AI, PYLIBMC, PYMEMCACHE, PYMONGO, PYMYSQL, PYNAMODB, PYODBC, PYRAMID, RAY, RAY_SUBMISSION_SPANS, REDIS, REDISCLUSTER, REQUESTS, RQ, SAFE_INSTRUMENTATION, SANIC, SNOWFLAKE, SQLALCHEMY, SQLITE3, STARLETTE, STRUCTLOG, SUBPROCESS, TORNADO, UNITTEST, URLLIB3, VALKEY, VERTEXAI, VERTICA, VLLM, WEBSOCKET_MESSAGES, YAAREDIS

`DD_<INTEGRATION>_SERVICE`

(99개 통합)

이 통합이 생성한 스팬의 서비스 이름을 재정의해요.

사용 가능한 통합:AIOBOTOCORE, AIOHTTP, AIOHTTP_CLIENT, AIOKAFKA, AIOMYSQL, AIOPG, ALGOLIASEARCH, ANTHROPIC, AREDIS, ASGI, ASYNCIO, ASYNCPG, AVRO, AWS_LAMBDA, AZURE_COSMOS, AZURE_EVENTHUBS, AZURE_FUNCTIONS, BOTO, BOTTLE, CELERY, CHERRYPY, CONSUL, COVERAGE, CREWAI, DBAPI2, DJANGO, DOGPILE_CACHE, DRAMATIQ, ELASTICSEARCH, FALCON, FASTAPI, FLASK, FLASK_CACHE, FUTURES, GENAI, GEVENT, GOOGLE_ADK, GOOGLE_CLOUD_PUBSUB, GOOGLE_GENAI, GRAPHQL, GRPC_AIO_CLIENT, GRPC_AIO_SERVER, GRPC_CLIENT, GRPC_SERVER, HTTPLIB, HTTPX, JINJA2, KAFKA, KOMBU, LANGCHAIN, LANGGRAPH, LITELLM, LLAMA_INDEX, LOGBOOK, LOGURU, MAKO, MARIADB, MCP, MLFLOW, MOLTEN, MYSQL, MYSQLDB, OPENAI, OPENAI_AGENTS, PROTOBUF, PYDANTIC_AI, PYLIBMC, PYMEMCACHE, PYMONGO, PYMYSQL, PYNAMODB, PYODBC, PYRAMID, PYTEST, PYTEST_BDD, RAY, REDIS, REDISCLUSTER, REQUESTS, RQ, RQ_WORKER, SANIC, SELENIUM, SNOWFLAKE, SQLALCHEMY, SQLITE, SQLITE3, STARLETTE, STRUCTLOG, SUBPROCESS, TORNADO, UNITTEST, URLLIB3, VALKEY, VERTEXAI, VERTICA, VLLM, WSGI, YAAREDIS

통합별 설정 (Per-Integration Settings) (117개 통합)

각 섹션은 특정 통합에 사용 가능한 모든 구성 키를 나열해요.

AIOBOTOCORE

(2)

DD_AIOBOTOCORE_SERVICE

타입: string 별칭:DD_AIOBOTOCORE_SERVICE_NAME aiobotocore 통합이 추적하는 AWS 호출에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 스팬은 호출되는 AWS 엔드포인트에서 파생된 서비스 이름(예: aws.s3, aws.sqs)으로 대체돼요.

DD_TRACE_AIOBOTOCORE_ENABLED

타입: boolean 기본값: false ddtrace가 애플리케이션을 자동 계측할 때 aiobotocore 통합이 활성화되는지 제어해요. true로 설정하면 aiobotocore 클라이언트를 통한 호출이 추적되어 Datadog에 보고돼요. 설정되지 않거나 false면 통합이 패치되지 않고 aiobotocore 스팬이 생성되지 않아요.

AIOHTTP

(2)

DD_AIOHTTP_SERVICE

타입: string 별칭:DD_AIOHTTP_SERVICE_NAME aiohttp 통합이 생성한 aiohttp 서버 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "aiohttp-web"으로 대체돼요.

DD_TRACE_AIOHTTP_ENABLED

타입: boolean 기본값: true 트레이싱이 활성화될 때 aiohttp 통합이 자동으로 패치되는지 제어해요. 참이 아닌 값으로 설정하면 aiohttp 서버 요청과 미들웨어가 계측되지 않고 통합에 대한 스팬이 생성되지 않아요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

AIOHTTP_CLIENT

(1)

DD_AIOHTTP_CLIENT_SERVICE

타입: string 별칭:DD_AIOHTTP_CLIENT_SERVICE_NAME aiohttp 통합이 생성한 나가는 HTTP 클라이언트 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역으로 구성된 서비스 이름으로 대체돼요.

AIOHTTP_JINJA2

(1)

DD_TRACE_AIOHTTP_JINJA2_ENABLED

타입: boolean 기본값: true aiohttp_jinja2 통합이 활성화되는지 제어해요. 활성화하면 aiohttp_jinja2.render_template을 통해 수행된 템플릿 렌더링이 자동으로 추적돼요. 비활성화하면 aiohttp_jinja2를 사용하는 aiohttp 애플리케이션에서 템플릿 렌더링에 대한 스팬이 생성되지 않아요.

AIOKAFKA

(2)

DD_AIOKAFKA_SERVICE

타입: string 기본값: kafka 별칭:DD_AIOKAFKA_SERVICE_NAME aiokafka 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "kafka"으로 대체돼요.

DD_TRACE_AIOKAFKA_ENABLED

타입: boolean 기본값: true aiokafka 통합이 활성화되는지 제어해요. 활성화하면 ddtrace가 aiokafka 프로듀서와 컨슈머를 자동으로 계측해 send, getone, getmany, 오프셋 커밋 작업에 대한 스팬을 생성해요. 통합을 제거하지 않고 aiokafka 호출 추적을 중지하려면 비활성화하세요.

AIOMYSQL

(2)

DD_AIOMYSQL_SERVICE

타입: string 기본값: mysql 별칭:DD_AIOMYSQL_SERVICE_NAME aiomysql 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "mysql"으로 대체돼요.

DD_TRACE_AIOMYSQL_ENABLED

타입: boolean 기본값: true aiomysql 통합이 자동 패치되는지 제어하며, 이는 aiomysql 비동기 클라이언트를 통해 실행된 MySQL 쿼리를 추적해요. 설정하지 않으면 통합은 기본적으로 활성화되고, 참이 아닌 값으로 설정하면 aiomysql 트레이싱을 비활성화해요.

AIOPG

(2)

DD_AIOPG_SERVICE

타입: string 기본값: postgres 별칭:DD_AIOPG_SERVICE_NAME aiopg 통합이 생성한 스팬에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "postgres"으로 대체돼요.

DD_TRACE_AIOPG_ENABLED

타입: boolean 기본값: true aiopg 통합이 활성화되어 aiopg를 통해 실행된 각 Postgres 쿼리에 대한 스팬을 생성하는지 제어해요. false로 설정하면 통합이 패치되지 않고 aiopg 스팬이 방출되지 않아요. 기본적으로 활성화돼요.

ALGOLIASEARCH

(2)

DD_ALGOLIASEARCH_SERVICE

타입: string 별칭:DD_ALGOLIASEARCH_SERVICE_NAME algoliasearch 통합이 생성한 Algoliasearch 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "algoliasearch"으로 대체돼요.

DD_TRACE_ALGOLIASEARCH_ENABLED

타입: boolean 기본값: true algoliasearch 통합이 자동 패치되어 Algolia 검색 클라이언트 호출에 대한 트레이스를 생성하는지 제어해요. 활성화(기본값)하면 algoliasearch 라이브러리를 통해 수행된 검색 작업이 계측되어 algoliasearch 서비스 아래에 보고돼요. 이 라이브러리의 계측을 비활성화하려면 false로 설정하세요.

ANTHROPIC

(2)

DD_ANTHROPIC_SERVICE

타입: string 별칭:DD_ANTHROPIC_SERVICE_NAME anthropic 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로 대체돼요.

DD_TRACE_ANTHROPIC_ENABLED

타입: boolean 기본값: true anthropic에 대한 계측을 활성화해요. 비활성화하면 anthropic 작업에 대한 스팬이 생성되지 않아요.

AREDIS

(2)

DD_AREDIS_SERVICE

타입: string 기본값: redis 별칭:DD_AREDIS_SERVICE_NAME aredis 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "redis"으로 대체돼요.

DD_TRACE_AREDIS_ENABLED

타입: boolean 기본값: true aredis 통합이 가져오기 시 자동 패치되어 비동기 Redis 클라이언트 호출을 추적하는지 제어해요. 활성화(기본값)하면 aredis 명령이 계측되어 명령, 호스트, 포트 정보로 태그된 스팬을 생성해요. aredis의 자동 패치를 비활성화하려면 false로 설정하세요.

ASGI

(1)

DD_ASGI_SERVICE

타입: string 기본값: asgi 별칭:DD_ASGI_SERVICE_NAME ASGI 기반 애플리케이션이 생성한 트레이스에 대해 asgi 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_ASGI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

ASYNCIO

(2)

DD_ASYNCIO_SERVICE

타입: string 별칭:DD_ASYNCIO_SERVICE_NAME asyncio 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_ASYNCIO_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_ASYNCIO_ENABLED

타입: boolean 기본값: true asyncio 통합이 가져오기 시 패치되어 asyncio.Task의 동시 실행을 추적하는지 제어해요. 활성화(기본값)하면 이벤트 루프를 통해 생성된 작업이 계측되어 스팬이 그 사이에서 컨텍스트를 전파해요. 다른 통합에 영향 없이 asyncio 작업 계측을 비활성화하려면 참이 아닌 값으로 설정하세요.

ASYNCPG

(2)

DD_ASYNCPG_SERVICE

타입: string 기본값: postgres 별칭:DD_ASYNCPG_SERVICE_NAME asyncpg 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "postgres"으로 대체돼요.

DD_TRACE_ASYNCPG_ENABLED

타입: boolean 기본값: true asyncpg 통합이 활성화되어 asyncpg 연결·커서 객체를 통해 이루어진 PostgreSQL 데이터베이스 요청을 추적하는지 제어해요. 활성화(기본값)하면 asyncpg가 트레이서 시작 시 자동 패치되고, 이 라이브러리의 계측을 비활성화하려면 false로 설정하세요.

AVRO

(2)

DD_AVRO_SERVICE

타입: string 별칭:DD_AVRO_SERVICE_NAME avro 라이브러리로 이루어진 Avro 읽기/쓰기 호출을 추적하는 avro 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_AVRO_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_AVRO_ENABLED

타입: boolean 기본값: true 별칭:DD_INTEGRATION_AVRO_ENABLED, DD_TRACE_INTEGRATION_AVRO_ENABLED AVRO 계측을 활성화해요.

AWS_LAMBDA

(2)

DD_AWS_LAMBDA_SERVICE

타입: string 별칭:DD_AWS_LAMBDA_SERVICE_NAME aws_lambda 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_AWS_LAMBDA_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_AWS_LAMBDA_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACE_INTEGRATION_AWS_LAMBDA_ENABLED, DD_INTEGRATION_AWS_LAMBDA_ENABLED AWS Lambda(LambdaHandler) 계측을 활성화해요.

AZURE_COSMOS

(2)

DD_AZURE_COSMOS_SERVICE

타입: string 별칭:DD_AZURE_COSMOS_SERVICE_NAME azure.cosmos(동기·비동기) 클라이언트 작업 주변에 생성된 스팬에 대해 azure_cosmos 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로 대체돼요.

DD_TRACE_AZURE_COSMOS_ENABLED

타입: boolean 기본값: true 트레이서에서 Azure CosmosDB SDK의 계측을 활성화해요. 계측은 기본적으로 활성화돼요.

AZURE_DURABLE_FUNCTIONS

(1)

DD_TRACE_AZURE_DURABLE_FUNCTIONS_ENABLED

타입: boolean 기본값: true durable-functions 트레이싱을 활성화하거나 비활성화해요.

AZURE_EVENTHUBS

(2)

DD_AZURE_EVENTHUBS_SERVICE

타입: string 기본값: azure_eventhubs 별칭:DD_AZURE_EVENTHUBS_SERVICE_NAME azure.eventhub와 azure.eventhub.aio 클라이언트를 패치할 때 생성된 스팬에 대해 azure_eventhubs 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "azure_eventhubs"으로 대체돼요(스키마화에 따라 다름).

DD_TRACE_AZURE_EVENTHUBS_ENABLED

타입: boolean 기본값: true azure_eventhubs 통합이 활성화되어 azure.eventhub와 azure.eventhub.aio 클라이언트를 계측해 Event Hubs 프로듀서 작업에 대한 스팬을 생성하는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화되고, 참이 아닌 값으로 설정하면 다른 통합에 영향 없이 Event Hubs 트레이싱을 비활성화해요.

AZURE_EVENTHUBS_BATCH_LINKS

(1)

DD_TRACE_AZURE_EVENTHUBS_BATCH_LINKS_ENABLED

타입: boolean 기본값: true azure eventhubs 배치 링크에 대한 계측을 활성화해요. 비활성화하면 azure eventhubs 배치 링크 작업에 대한 스팬이 생성되지 않아요.

AZURE_FUNCTIONS

(1)

DD_AZURE_FUNCTIONS_SERVICE

타입: string 기본값: azure_functions 별칭:DD_AZURE_FUNCTIONS_SERVICE_NAME Azure Function 앱이 생성한 트레이스에 대해 azure_functions 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "azure_functions"으로 대체돼요.

AZURE_SERVICEBUS

(1)

DD_TRACE_AZURE_SERVICEBUS_ENABLED

타입: boolean 기본값: true azure_servicebus 통합이 활성화되는지 제어해요. 활성화(기본값)하면 ddtrace가 azure.servicebus(및 그 azure.servicebus.aio 비동기 대응)를 패치해 Service Bus 프로듀서에서 메시지 전송, 예약, 일괄 처리를 위한 스팬을 생성하고 나가는 메시지에 분산 트레이싱 컨텍스트를 주입해요. 참이 아닌 값으로 설정하면 azure-servicebus SDK의 계측을 비활성화해요.

AZURE_SERVICEBUS_BATCH_LINKS

(1)

DD_TRACE_AZURE_SERVICEBUS_BATCH_LINKS_ENABLED

타입: boolean 기본값: true azure servicebus 배치 링크에 대한 계측을 활성화해요. 비활성화하면 azure servicebus 배치 링크 작업에 대한 스팬이 생성되지 않아요.

BOTO

(2)

DD_BOTO_SERVICE

타입: string 별칭:DD_BOTO_SERVICE_NAME AWS API 호출을 추적하는 스팬에 대해 boto 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 통합의 핀(aws)과 호출 중인 AWS 엔드포인트를 결합한 기본 서비스 이름(예: aws.s3)으로 대체돼요.

DD_TRACE_BOTO_ENABLED

타입: boolean 기본값: true boto 통합이 시작 시 자동 패치되는지 제어해요. false로 설정하면 레거시 AWS boto 클라이언트 라이브러리를 통한 호출이 추적되지 않아요. 기본적으로 활성화돼요.

BOTOCORE

(3)

DD_BOTOCORE_EMPTY_POLL_ENABLED

타입: boolean 기본값: true botocore 통합이 AWS SQS와 Kinesis에 대한 빈 폴 호출(즉, 메시지나 레코드를 반환하지 않는 ReceiveMessage/GetRecords 호출)을 계측하는지 제어해요. 활성화(기본값)하면 빈 것을 포함한 모든 폴에 대해 스팬이 생성돼요. 비활성화하면 메시지를 반환하지 않는 폴이 추적되지 않아, 처리량이 높은 큐를 long-poll하는 서비스에서 스팬 볼륨을 줄일 수 있어요.

DD_BOTOCORE_PROPAGATION_ENABLED

타입: boolean 기본값: false 활성화하면 botocore 통합이 들어오는 SQS ReceiveMessage와 Kinesis GetRecords 페이로드에서 업스트림 Datadog 트레이스 컨텍스트를 추출해 소비자 스팬을 프로듀서 트레이스에 연결해요. 비활성화(기본값)하면 들어오는 메시지가 전파된 컨텍스트를 갖고 있어도 새 트레이스를 시작해요.

DD_TRACE_BOTOCORE_ENABLED

타입: boolean 기본값: true botocore(및 boto3)를 통해 이루어진 AWS SDK 호출에 대해 botocore 통합이 자동 패치되고 트레이스가 생성되는지 제어해요. 활성화하면 S3, DynamoDB, SQS, SNS, Lambda 등 AWS 서비스에 대한 호출이 추적돼요. 비활성화하면 botocore 작업에 대한 스팬이 방출되지 않아요. 표준 boolean 값을 받으며 기본값은 활성화.

BOTTLE

(2)

DD_BOTTLE_SERVICE

타입: string 기본값: bottle 별칭:DD_BOTTLE_SERVICE_NAME bottle 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로, 그다음 기본 서비스 이름 "bottle"으로 대체돼요.

DD_TRACE_BOTTLE_ENABLED

타입: boolean 기본값: true bottle 통합이 시작 시 자동 패치되는지 제어해요. 활성화(기본값)하면 Bottle 애플리케이션이 처리하는 들어오는 요청이 추적돼요. 다른 통합은 그대로 두고 Bottle 계측을 비활성화하려면 false로 설정하세요.

CELERY

(2)

DD_CELERY_SERVICE

타입: string 별칭:DD_CELERY_SERVICE_NAME celery 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_CELERY_SERVICE_NAME으로, 그다음 Celery 트레이스의 기본 서비스 이름으로 대체돼요.

DD_TRACE_CELERY_ENABLED

타입: boolean 기본값: true ddtrace가 애플리케이션을 계측할 때 celery 통합이 자동 패치되는지 제어해요. 활성화(기본값)하면 Celery 클라이언트와 워커가 추적되고, 다른 통합은 그대로 두고 Celery 계측을 비활성화하려면 false로 설정하세요.

CHERRYPY

(1)

DD_CHERRYPY_SERVICE

타입: string 기본값: cherrypy 별칭:DD_CHERRYPY_SERVICE_NAME cherrypy 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "cherrypy"으로 대체돼요.

CLAUDE_AGENT_SDK

(1)

DD_TRACE_CLAUDE_AGENT_SDK_ENABLED

타입: boolean 기본값: true Claude Code SDK의 트레이싱을 활성화해요.

CONSUL

(2)

DD_CONSUL_SERVICE

타입: string 별칭:DD_CONSUL_SERVICE_NAME consul 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_CONSUL_SERVICE_NAME으로, 그다음 기본 서비스 이름 "consul"으로 대체돼요.

DD_TRACE_CONSUL_ENABLED

타입: boolean 기본값: true consul 통합이 자동 패치되어 Consul KV 작업(get, put, delete)을 추적하는지 제어해요. 비활성화하면 python-consul 클라이언트에 대한 스팬이 생성되지 않아요. 기본적으로 활성화돼요.

COVERAGE

(2)

DD_COVERAGE_SERVICE

타입: string 별칭:DD_COVERAGE_SERVICE_NAME coverage 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_COVERAGE_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_COVERAGE_ENABLED

타입: boolean 기본값: false Coverage.py를 패치해 보고서가 생성될 때 커버리지 백분율을 캡처하는 coverage 통합을 활성화해요. 기본적으로 비활성화되며, 활성화하려면 true로 설정하세요.

CREWAI

(2)

DD_CREWAI_SERVICE

타입: string 별칭:DD_CREWAI_SERVICE_NAME CrewAI 라이브러리에서 crew, task, agent, tool 실행을 계측하는 crewai 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_CREWAI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_CREWAI_ENABLED

타입: boolean 기본값: true crewai가 가져올 때 crewai 통합이 자동 패치·계측되는지 제어해요. 활성화(기본값)하면 CrewAI 에이전트, 태스크, crew 실행에 대한 스팬이 생성돼요. 다른 통합은 그대로 두고 crewai 라이브러리의 계측을 비활성화하려면 false로 설정하세요.

DBAPI2

(1)

DD_DBAPI2_SERVICE

타입: string 별칭:DD_DBAPI2_SERVICE_NAME PEP 249 호환 데이터베이스 드라이버(예: sqlite3, mysql, psycopg 등 dbapi 위에 구축된 것들)에 대한 공유 트레이싱을 제공하는 일반 dbapi2 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 통합의 기본 서비스 이름으로 대체돼요.

DJANGO

(6)

DD_DJANGO_INCLUDE_USER_EMAIL

타입: boolean 기본값: false Django 통합이 App and API Protection(AAP)의 로그인, 가입, 계정 탈취 감지 같은 사용자 이벤트에 대해 방출된 루트 요청 스팬에 인증된 사용자의 이메일(가능하면)을 태그로 부착하는지 제어해요. 설정하지 않으면 이메일이 수집되지 않아요.

DD_DJANGO_INCLUDE_USER_LOGIN

타입: boolean 기본값: true django 통합이 App and API Protection 사용자 이벤트(로그인 성공/실패 등)에 대해 방출된 루트 요청 스팬에 인증된 사용자의 로그인(가능하면)을 태그로 포함하는지 제어해요. 설정하지 않으면 true를 기본값으로 해요.

DD_DJANGO_INCLUDE_USER_NAME

타입: boolean 기본값: true django 통합이 인증된 사용자의 이름 또는 id를 루트 요청 스팬의 태그로 추가하는지 제어해요. 활성화(기본값)하면 사용자 식별자가 Django 요청 스팬에 부착되고, 비활성화하면 사용자 이름/id 태그가 추가되지 않아요.

DD_DJANGO_INCLUDE_USER_REALNAME

타입: boolean 기본값: false django 통합이 ASM 사용자 이벤트(로그인, 가입 등)에 대해 인증된 사용자의 실명(가능하면)을 루트 요청 스팬의 태그로 포함하는지 제어해요. 설정하지 않으면 실명이 사용자 이벤트 태그에 부착되지 않아요.

DD_DJANGO_SERVICE

타입: string 기본값: django 별칭:DD_DJANGO_SERVICE_NAME Django 애플리케이션이 생성한 트레이스에 대해 django 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 DD_DJANGO_SERVICE_NAME으로, 그다음 전역 서비스 이름(예: DD_SERVICE)으로 대체돼요.

DD_TRACE_DJANGO_ENABLED

타입: boolean 기본값: true django 통합이 트레이서 초기화 시 자동 패치되는지 제어해요. false로 설정하면 Django 요청 처리, ORM 쿼리, 템플릿, 캐시 작업이 계측되지 않고 스팬을 생성하지 않아요. 기본값은 활성화.

DOGPILE_CACHE

(2)

DD_DOGPILE_CACHE_SERVICE

타입: string 별칭:DD_DOGPILE_CACHE_SERVICE_NAME dogpile.cache 조회를 계측하는 dogpile_cache 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 dogpile.cache에서 파생된 기본 서비스 이름으로 대체돼요.

DD_TRACE_DOGPILE_CACHE_ENABLED

타입: boolean 기본값: true dogpile.cache 통합이 활성화되는지 제어해요. 활성화하면 dogpile.cache 영역을 통해 수행된 캐시 조회(get_or_create, get_or_create_multi 포함)가 추적되고, 스팬은 캐시 키, 영역, 백엔드로 태그돼요.

DRAMATIQ

(2)

DD_DRAMATIQ_SERVICE

타입: string 별칭:DD_DRAMATIQ_SERVICE_NAME @dramatiq.actor 데코레이터로 정의된 백그라운드 작업을 계측하는 dramatiq 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_DRAMATIQ_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_DRAMATIQ_ENABLED

타입: boolean 기본값: true dramatiq 통합이 활성화되는지 제어해요. 활성화하면 @dramatiq.actor로 장식된 dramatiq 액터가 자동 추적되어 Actor.send_with_options 호출에 대한 스팬을 생성하므로 백그라운드 작업 실행이 Datadog에 나타나요. dramatiq 계측을 거부하려면 비활성화하세요.

ELASTICSEARCH

(2)

DD_ELASTICSEARCH_SERVICE

타입: string 기본값: elasticsearch 별칭:DD_ELASTICSEARCH_SERVICE_NAME elasticsearch 통합이 생성한 Elasticsearch 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "elasticsearch"으로 대체돼요.

DD_TRACE_ELASTICSEARCH_ENABLED

타입: boolean 기본값: true elasticsearch에 대한 계측을 활성화해요. 비활성화하면 elasticsearch 작업에 대한 스팬이 생성되지 않아요.

FALCON

(2)

DD_FALCON_SERVICE

타입: string 별칭:DD_FALCON_SERVICE_NAME Falcon 웹 애플리케이션이 생성한 트레이스에 대해 falcon 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_FALCON_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_FALCON_ENABLED

타입: boolean 기본값: true falcon 통합이 활성화되는지 제어해요. true(기본값)로 설정하면 Falcon 애플리케이션이 처리하는 들어오는 요청이 자동 추적돼요. Falcon 계측을 완전히 비활성화하려면 false로 설정하세요.

FASTAPI

(2)

DD_FASTAPI_SERVICE

타입: string 기본값: fastapi 별칭:DD_FASTAPI_SERVICE_NAME fastapi 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_FASTAPI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 "fastapi"으로 대체돼요.

DD_TRACE_FASTAPI_ENABLED

타입: boolean 기본값: true ddtrace가 애플리케이션 라이브러리를 자동 패치할 때 fastapi 통합이 활성화되는지 제어해요. 활성화하면 들어오는 FastAPI HTTP 요청이 fastapi.request 스팬으로 추적되며 라우트, 상태, 요청 메타데이터를 포함해요. 통합을 제거하지 않고 FastAPI 추적을 중지하려면 비활성화하세요.

FLASK

(2)

DD_FLASK_SERVICE

타입: string 기본값: flask 별칭:DD_FLASK_SERVICE_NAME flask 통합이 생성한 트레이스가 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_FLASK_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_FLASK_ENABLED

타입: boolean 기본값: true 트레이싱이 활성화될 때 flask 통합이 자동 패치되는지 제어해요. false로 설정하면 Flask 요청, 뷰, 템플릿 렌더링이 계측되지 않고 Flask 스팬이 생성되지 않아요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

FLASK_CACHE

(1)

DD_FLASK_CACHE_SERVICE

타입: string 별칭:DD_FLASK_CACHE_SERVICE_NAME Flask-Cache / Flask-Caching 작업의 트레이스에 대해 flask_cache 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_FLASK_CACHE_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 "flask-cache"으로 대체돼요.

FUTURES

(2)

DD_FUTURES_SERVICE

타입: string 별칭:DD_FUTURES_SERVICE_NAME concurrent.futures 스레드·프로세스 풀 실행기 간에 트레이스 컨텍스트를 전파하는 futures 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_FUTURES_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_FUTURES_ENABLED

타입: boolean 기본값: true concurrent.futures.ThreadPoolExecutor를 통해 스폰된 작업에 활성 트레이싱 컨텍스트를 전파해 워커 스레드 내부에서 생성된 스팬이 출발 트레이스를 계속하도록 하는 futures 통합을 제어해요. 기본적으로 활성화되며, ThreadPoolExecutor 작업에 대한 스레드 컨텍스트 전파를 비활성화하려면 false로 설정하세요.

GENAI

(2)

DD_GENAI_SERVICE

타입: string 별칭:DD_GENAI_SERVICE_NAME genai 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_GENAI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_GENAI_ENABLED

타입: boolean Google GenAI 플러그인을 활성화해요.

GEVENT

(2)

DD_GEVENT_SERVICE

타입: string 별칭:DD_GEVENT_SERVICE_NAME gevent 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_GEVENT_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_GEVENT_ENABLED

타입: boolean 기본값: true gevent 통합이 시작 시 패치되어 greenlet 기반 동시성의 자동 추적을 활성화하는지 제어해요. 기본적으로 활성화되며, 비활성화하려면 false로 설정하세요. gevent가 DD_PATCH_MODULES에도 나열되면 그 값이 이 변수보다 우선해요.

GOOGLE_ADK

(2)

DD_GOOGLE_ADK_SERVICE

타입: string 별칭:DD_GOOGLE_ADK_SERVICE_NAME 에이전트 요청에 대해 Google ADK Python SDK를 계측하는 google_adk 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로 대체돼요.

DD_TRACE_GOOGLE_ADK_ENABLED

타입: boolean 기본값: true Google ADK Python SDK를 계측해 에이전트 요청에 대한 스팬(모델과 공급자로 태그)을 생성하는 google_adk 통합이 활성화되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

GOOGLE_CLOUD_PUBSUB

(2)

DD_GOOGLE_CLOUD_PUBSUB_SERVICE

타입: string 별칭:DD_GOOGLE_CLOUD_PUBSUB_SERVICE_NAME google-cloud-pubsub 라이브러리를 통한 Google Cloud Pub/Sub 게시·소비를 추적하는 google_cloud_pubsub 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_GOOGLE_CLOUD_PUBSUB_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_GOOGLE_CLOUD_PUBSUB_ENABLED

타입: boolean 기본값: true google cloud pubsub에 대한 계측을 활성화해요. 비활성화하면 google cloud pubsub 작업에 대한 스팬이 생성되지 않아요.

GOOGLE_GENAI

(2)

DD_GOOGLE_GENAI_SERVICE

타입: string 별칭:DD_GOOGLE_GENAI_SERVICE_NAME google_genai 통합(Google GenAI SDK)이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_GOOGLE_GENAI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_GOOGLE_GENAI_ENABLED

타입: boolean 기본값: true google genai에 대한 계측을 활성화해요. 비활성화하면 google genai 작업에 대한 스팬이 생성되지 않아요.

GRAPHQL

(3)

DD_GRAPHQL_SERVICE

타입: string 기본값: graphql 별칭:DD_GRAPHQL_SERVICE_NAME graphql 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_GRAPHQL_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_GRAPHQL_ENABLED

타입: boolean 기본값: true graphql에 대한 계측을 활성화해요. 비활성화하면 graphql 작업에 대한 스팬이 생성되지 않아요.

DD_TRACE_GRAPHQL_ERROR_EXTENSIONS

타입: array 스팬 태그로 캡처할 GraphQL 오류 확장 키의 쉼표 구분 목록. 설정하지 않으면 확장이 캡처되지 않아요.

GRAPHQL_RESOLVERS

(1)

DD_TRACE_GRAPHQL_RESOLVERS_ENABLED

타입: boolean 기본값: false 활성화하면 graphql 통합이 표준 query/parse/validate/execute 스팬 외에 해결된 각 GraphQL 필드에 대해 graphql.resolve 스팬을 생성해요. 복잡한 GraphQL 쿼리는 필드당 하나의 스팬으로 매우 큰 트레이스를 만들 수 있어 기본적으로 비활성화돼요.

GRPC

(1)

DD_TRACE_GRPC_ENABLED

타입: boolean 기본값: true grpc에 대한 계측을 활성화해요. 비활성화하면 grpc 작업에 대한 스팬이 생성되지 않아요.

GRPC_AIO_CLIENT

(1)

DD_GRPC_AIO_CLIENT_SERVICE

타입: string 별칭:DD_GRPC_AIO_CLIENT_SERVICE_NAME gRPC asyncio 클라이언트 통합(grpc_aio_client)이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_GRPC_AIO_CLIENT_SERVICE_NAME으로, 그다음 기본 서비스 이름 "grpc-aio-client"으로 대체돼요.

GRPC_AIO_SERVER

(1)

DD_GRPC_AIO_SERVER_SERVICE

타입: string 별칭:DD_GRPC_AIO_SERVER_SERVICE_NAME asyncio gRPC 서버가 생성한 스팬에 대해 grpc_aio_server 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "grpc-aio-server"으로 대체돼요.

GRPC_CLIENT

(2)

DD_GRPC_CLIENT_SERVICE

타입: string 별칭:DD_GRPC_CLIENT_SERVICE_NAME 나가는 gRPC 클라이언트 호출에 대해 grpc_client 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 DD_GRPC_CLIENT_SERVICE_NAME으로, 그다음 기본 "grpc-client"으로 대체돼요.

DD_TRACE_GRPC_CLIENT_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACE_INTEGRATION_GRPC_CLIENT_ENABLED, DD_INTEGRATION_GRPC_CLIENT_ENABLED gRPC 클라이언트 트레이싱을 활성화해요(나가는 RPC에 대한 스팬 생성, 전파 메타데이터 주입, 클라이언트 호출/스트림/메시지 콜백 추적).

GRPC_SERVER

(2)

DD_GRPC_SERVER_SERVICE

타입: string 별칭:DD_GRPC_SERVER_SERVICE_NAME grpc 통합이 생성한 gRPC 서버 측 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름(DD_SERVICE)으로, 그 외에 기본 "grpc-server"으로 대체돼요.

DD_TRACE_GRPC_SERVER_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACE_INTEGRATION_GRPC_SERVER_ENABLED, DD_INTEGRATION_GRPC_SERVER_ENABLED gRPC 서버 트레이싱을 활성화해요(들어오는 RPC에 대한 스팬을 만들고 선택적으로 핸들러 코드 출처를 기록하는 추적 ServerInterceptor 설치).

HTTPLIB

(2)

DD_HTTPLIB_SERVICE

타입: string 별칭:DD_HTTPLIB_SERVICE_NAME Python 표준 http.client(및 urllib) 모듈을 통해 이루어진 나가는 HTTP 요청을 추적하는 httplib 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_HTTPLIB_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_HTTPLIB_ENABLED

타입: boolean 기본값: false Python 표준 라이브러리 http.client(이전 httplib) 모듈을 통해 이루어진 HTTP 요청의 추적을 활성화해요. httplib 통합은 기본적으로 비활성화되어 있으며, true로 설정하면 http.client가 패치되어 나가는 HTTP 호출이 스팬을 생성해요.

HTTPX

(2)

DD_HTTPX_SERVICE

타입: string 별칭:DD_HTTPX_SERVICE_NAME httpx 통합이 추적한 나가는 HTTP 요청에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 스팬은 자체 서비스 이름을 정의하는 대신 부모 스팬에서 서비스 이름을 상속해요. 둘 다 설정되지 않으면 DD_HTTPX_SERVICE_NAME으로 대체돼요. 활성화되면 DD_HTTPX_SPLIT_BY_DOMAIN이 이 값보다 우선한다는 점을 참고하세요.

DD_TRACE_HTTPX_ENABLED

타입: boolean 기본값: true httpx 라이브러리의 동기·비동기 클라이언트로 이루어진 나가는 HTTP 요청을 자동 추적하는 httpx 통합이 활성화되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

JINJA2

(2)

DD_JINJA2_SERVICE

타입: string 별칭:DD_JINJA2_SERVICE_NAME 템플릿 로딩, 컴파일, 렌더링 스팬에 대해 jinja2 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 서비스 이름은 부모 스팬에서 상속되고, 부모 스팬이 없고 서비스가 구성되지 않으면 Agent가 트레이스를 버려요.

DD_TRACE_JINJA2_ENABLED

타입: boolean 기본값: true Jinja2 엔진이 수행하는 템플릿 렌더링, 컴파일, 로딩 작업을 추적하는 jinja2 통합이 활성화되는지 제어해요. 활성화(기본값)하면 jinja2 템플릿 실행에 대한 스팬이 생성돼요. Jinja2 계측을 비활성화하려면 false로 설정하세요.

KAFKA

(3)

DD_KAFKA_PROPAGATION_ENABLED

타입: boolean Kafka를 통해 트레이스 컨텍스트를 전파할지 여부.

DD_KAFKA_SERVICE

타입: string 기본값: kafka 별칭:DD_KAFKA_SERVICE_NAME confluent-kafka를 계측하는 kafka 통합이 생성한 Kafka 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "kafka"으로 대체돼요.

DD_TRACE_KAFKA_ENABLED

타입: boolean 기본값: true 별칭:DD_INTEGRATION_KAFKA_ENABLED, DD_TRACE_INTEGRATION_KAFKA_ENABLED Kafka 통합에 대한 트레이싱을 활성화해요.

KOMBU

(2)

DD_KOMBU_SERVICE

타입: string 기본값: kombu 별칭:DD_KOMBU_SERVICE_NAME kombu 통합이 생성한 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_KOMBU_SERVICE_NAME으로, 그다음 기본 서비스 이름 "kombu"으로 대체돼요.

DD_TRACE_KOMBU_ENABLED

타입: boolean 기본값: false kombu 통합이 활성화되는지 제어해요. 활성화하면 트레이서가 kombu 메시징 라이브러리를 계측해 메시지 게시·소비 작업에 대한 스팬을 생성해요. 기본적으로 비활성화되며, 옵트인하려면 true로 설정하세요.

LAMBDA

(1)

DD_LAMBDA_HANDLER

타입: string

환경 변수 DD_LAMBDA_HANDLER를 원래 핸들러로 설정하세요(예: myfunc.handler).

LANGCHAIN

(2)

DD_LANGCHAIN_SERVICE

타입: string 별칭:DD_LANGCHAIN_SERVICE_NAME langchain 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_LANGCHAIN_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_LANGCHAIN_ENABLED

타입: boolean 기본값: true langchain에 대한 계측을 활성화해요. 비활성화하면 langchain 작업에 대한 스팬이 생성되지 않아요.

LANGGRAPH

(2)

DD_LANGGRAPH_SERVICE

타입: string 별칭:DD_LANGGRAPH_SERVICE_NAME LangGraph Python 라이브러리를 계측해 그래프와 노드 호출에 대한 트레이스를 생성하는 langgraph 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_LANGGRAPH_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_LANGGRAPH_ENABLED

타입: boolean 기본값: true LangGraph 통합을 활성화하려면 사용하세요.

LITELLM

(2)

DD_LITELLM_SERVICE

타입: string 별칭:DD_LITELLM_SERVICE_NAME litellm 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_LITELLM_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_LITELLM_ENABLED

타입: boolean 기본값: true LiteLLM Python SDK와 프록시 서버를 계측해 LLM 요청에 대한 트레이스를 생성하는 litellm 통합이 활성화되는지 제어해요. 활성화(기본값)하면 LiteLLM 호출이 자동 추적되고, 이 통합의 계측을 비활성화하려면 false로 설정하세요.

LLAMA_INDEX

(1)

DD_LLAMA_INDEX_SERVICE

타입: string 별칭:DD_LLAMA_INDEX_SERVICE_NAME llama_index 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 애플리케이션에 구성된 전역 서비스 이름으로 대체돼요.

LOGBOOK

(2)

DD_LOGBOOK_SERVICE

타입: string 별칭:DD_LOGBOOK_SERVICE_NAME logbook을 통해 생성된 로그 레코드에 트레이스 상관관계 필드를 주입하는 logbook 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_LOGBOOK_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_LOGBOOK_ENABLED

타입: boolean 기본값: true ddtrace가 로드될 때 logbook 통합이 자동 패치되는지 제어해요. 활성화하면 ddtrace가 logbook.base.RecordDispatcher.process_record를 패치해 트레이스 상관관계 필드(dd.trace_id, dd.span_id, dd.env, dd.service, dd.version)를 로그 레코드에 주입하여, 구조화(예: JSON) 형식을 사용할 때 APM/로그 상관관계를 가능하게 해요. logbook 라이브러리 패치를 건너뛰려면 false로 설정하세요.

LOGGING

(1)

DD_TRACE_LOGGING_ENABLED

타입: boolean 기본값: true ddtrace가 애플리케이션을 자동 계측할 때 logging 통합이 자동 패치되는지 제어해요. 활성화하면 로그 레코드가 트레이스 상관관계 필드(예: dd.trace_id, dd.span_id)로 보강되어 로그를 Datadog의 트레이스에 연결할 수 있어요. 비활성화하면 자동 계측 중 logging 통합이 건너뛰어져요. 기본값은 true.

LOGURU

(2)

DD_LOGURU_SERVICE

타입: string 별칭:DD_LOGURU_SERVICE_NAME loguru 로깅 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_LOGURU_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_LOGURU_ENABLED

타입: boolean 기본값: true ddtrace가 로드될 때 loguru 통합이 자동 패치되는지 제어해요. 활성화하면 ddtrace가 트레이스 상관관계 필드(dd.trace_id, dd.span_id, dd.env, dd.service, dd.version)를 모든 로그 레코드에 주입하는 loguru 패처를 구성해, 구조화(예: JSON) 형식을 사용할 때 APM/로그 상관관계를 가능하게 해요. loguru 라이브러리 패치를 건너뛰려면 false로 설정하세요.

MAKO

(2)

DD_MAKO_SERVICE

타입: string 별칭:DD_MAKO_SERVICE_NAME Mako 템플릿을 렌더링할 때 생성된 스팬에 대해 mako 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_MAKO_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 "mako"으로 대체돼요.

DD_TRACE_MAKO_ENABLED

타입: boolean 기본값: true mako 통합이 활성화되는지 제어해요. 활성화하면 Mako 템플릿 렌더링 작업(Template.render, render_unicode, render_context)에 대한 트레이스가 템플릿 이름을 태그로 포함해 생성돼요. Mako 템플릿 계측을 중지하려면 비활성화하세요.

MARIADB

(2)

DD_MARIADB_SERVICE

타입: string 기본값: mariadb 별칭:DD_MARIADB_SERVICE_NAME mariadb 통합이 생성한 MariaDB 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "mariadb"으로 대체돼요.

DD_TRACE_MARIADB_ENABLED

타입: boolean 기본값: true mariadb에 대한 계측을 활성화해요. 비활성화하면 mariadb 작업에 대한 스팬이 생성되지 않아요.

MCP

(2)

DD_MCP_SERVICE

타입: string 별칭:DD_MCP_SERVICE_NAME MCP(Model Context Protocol) Python 라이브러리를 계측해 클라이언트 도구 호출과 서버 도구 실행에 대한 트레이스를 생성하는 mcp 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로 대체돼요.

DD_TRACE_MCP_ENABLED

타입: boolean 기본값: true mcp 통합이 자동 패치되어 Model Context Protocol 클라이언트와 서버에 대한 트레이스가 생성되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

MEMCACHED_COMMAND

(1)

DD_TRACE_MEMCACHED_COMMAND_ENABLED

타입: boolean 기본값: false DD_TRACE_MEMCACHED_COMMAND_ENABLED가 활성화되면 memcached 명령 태깅을 활성화해요.

MLFLOW

(1)

DD_MLFLOW_SERVICE

타입: string 별칭:DD_MLFLOW_SERVICE_NAME MLflow 실행과 단계를 추적하는 스팬에 대해 mlflow 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_MLFLOW_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

MOLTEN

(2)

DD_MOLTEN_SERVICE

타입: string 기본값: molten 별칭:DD_MOLTEN_SERVICE_NAME Molten 앱이 생성한 트레이스에 대해 molten 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_SERVICE으로, 그다음 기본 서비스 이름 "molten"으로 대체돼요.

DD_TRACE_MOLTEN_ENABLED

타입: boolean 기본값: true molten 통합이 시작 시 자동 패치되어 molten 앱이 처리하는 들어오는 HTTP 요청에 대한 트레이스를 생성하는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

MYSQL

(2)

DD_MYSQL_SERVICE

타입: string 기본값: mysql 별칭:DD_MYSQL_SERVICE_NAME mysql 통합이 생성한 MySQL 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "mysql"으로 대체돼요.

DD_TRACE_MYSQL_ENABLED

타입: boolean 기본값: true mysql에 대한 계측을 활성화해요. 비활성화하면 mysql 작업에 대한 스팬이 생성되지 않아요.

MYSQLDB

(2)

DD_MYSQLDB_SERVICE

타입: string 기본값: mysql 별칭:DD_MYSQLDB_SERVICE_NAME mysqldb 통합이 생성한 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "mysql"으로 대체돼요.

DD_TRACE_MYSQLDB_ENABLED

타입: boolean 기본값: true mysqlclient(MySQLdb) 라이브러리를 통해 이루어진 쿼리를 추적하기 위해 mysqldb 통합이 자동 패치되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화되고, MySQLdb 연결과 커서의 계측을 비활성화하려면 false로 설정하세요.

OPENAI

(2)

DD_OPENAI_SERVICE

타입: string 별칭:DD_OPENAI_SERVICE_NAME OpenAI 요청에 대해 기본적으로 보고되는 서비스 이름.

DD_TRACE_OPENAI_ENABLED

타입: boolean 기본값: true openai에 대한 계측을 활성화해요. 비활성화하면 openai 작업에 대한 스팬이 생성되지 않아요.

OPENAI_AGENTS

(2)

DD_OPENAI_AGENTS_SERVICE

타입: string 별칭:DD_OPENAI_AGENTS_SERVICE_NAME 에이전트 워크플로우에 대해 openai-agents Python 라이브러리를 계측하는 openai_agents 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_OPENAI_AGENTS_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_OPENAI_AGENTS_ENABLED

타입: boolean 기본값: true OpenAI Agents에 대한 트레이싱을 활성화해요.

OTEL_CTX

(1)

DD_TRACE_OTEL_CTX_ENABLED

타입: boolean 기본값: false 시작 버전: v4.13.3 false를 기본값으로 두지 마세요. true("implementation B")를 기본값으로 하는 것이 권장 값이에요. cc #ebpf-context-propagation and @ivoanjo.

PROPAGATION_HTTP_BAGGAGE

(1)

DD_TRACE_PROPAGATION_HTTP_BAGGAGE_ENABLED

타입: boolean 기본값: false 활성화하면 스팬 컨텍스트에 부착된 baggage 항목이 ot-baggage-<key> 헤더를 사용해 HTTP 요청 전반에 전파돼요. 주입 시 각 baggage 항목이 헤더로 기록되고, 추출 시 들어오는 ot-baggage-* 헤더가 결과 컨텍스트에 부착돼요. 이는 W3C baggage 전파 스타일과 독립적이며 기본적으로 비활성화돼요.

PROTOBUF

(2)

DD_PROTOBUF_SERVICE

타입: string 별칭:DD_PROTOBUF_SERVICE_NAME protobuf 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_PROTOBUF_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_PROTOBUF_ENABLED

타입: boolean 기본값: false 별칭:DD_TRACE_INTEGRATION_PROTOBUF_ENABLED, DD_INTEGRATION_PROTOBUF_ENABLED protobuf 스키마 추출을 활성화해요(protobuf 직렬화/역직렬화 중 활동 스팬에 protobuf 메시지 디스크립터를 부착하고 파싱/쓰기 오류를 기록).

PSYCOPG

(1)

DD_TRACE_PSYCOPG_ENABLED

타입: boolean 기본값: true psycopg 통합이 시작 시 자동 패치되어 psycopg(v3)와 psycopg2 PostgreSQL 클라이언트를 계측해 데이터베이스 스팬을 생성하는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화되고, 참이 아닌 값으로 설정하면 psycopg 연결, 커서, 쿼리의 패칭을 비활성화해요.

PYDANTIC_AI

(2)

DD_PYDANTIC_AI_SERVICE

타입: string 별칭:DD_PYDANTIC_AI_SERVICE_NAME PydanticAI 에이전트 프레임워크를 계측하는 pydantic_ai 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 전역 서비스 이름으로 대체돼요.

DD_TRACE_PYDANTIC_AI_ENABLED

타입: boolean 기본값: true pydantic_ai 통합이 패치되어 Pydantic AI 에이전트 실행, 스트림, 도구 호출에 대한 트레이스를 생성하는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화되고, pydantic_ai의 계측을 비활성화하려면 참이 아닌 값으로 설정하세요.

PYLIBMC

(2)

DD_PYLIBMC_SERVICE

타입: string 별칭:DD_PYLIBMC_SERVICE_NAME memcached 클라이언트를 계측하는 pylibmc 통합이 생성한 트레이스에 대해 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "memcached"으로 대체돼요.

DD_TRACE_PYLIBMC_ENABLED

타입: boolean 기본값: true pylibmc Memcached 클라이언트를 계측해 get, set, delete 같은 캐시 작업에 대한 스팬을 생성하는 pylibmc 통합이 활성화되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

PYMEMCACHE

(2)

DD_PYMEMCACHE_SERVICE

타입: string 별칭:DD_PYMEMCACHE_SERVICE_NAME pymemcache 통합이 생성한 memcached 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "pymemcache"으로 대체돼요.

DD_TRACE_PYMEMCACHE_ENABLED

타입: boolean 기본값: true pymemcache Client와 HashClient 호출을 계측해 memcached 쿼리를 스팬으로 보고하는 pymemcache 통합이 활성화되는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

PYMONGO

(2)

DD_PYMONGO_SERVICE

타입: string 기본값: pymongo 별칭:DD_PYMONGO_SERVICE_NAME pymongo 통합이 생성한 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "pymongo"으로 대체돼요.

DD_TRACE_PYMONGO_ENABLED

타입: boolean 기본값: true ddtrace가 지원 라이브러리를 패치할 때 pymongo 통합이 자동 활성화되는지 제어해요. 활성화(기본값)하면 pymongo.MongoClient를 통해 이루어진 MongoDB 호출이 데이터베이스 쿼리를 보고하는 스팬으로 추적돼요. 다른 통합은 유지하면서 pymongo 계측을 비활성화하려면 false로 설정하세요.

PYMYSQL

(2)

DD_PYMYSQL_SERVICE

타입: string 기본값: pymysql 별칭:DD_PYMYSQL_SERVICE_NAME pymysql 통합이 생성한 MySQL 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "mysql"으로 대체돼요.

DD_TRACE_PYMYSQL_ENABLED

타입: boolean 기본값: true pymysql 통합이 활성화되는지 제어해요. 활성화(기본값)하면 ddtrace가 pymysql을 자동 패치해 클라이언트를 통해 실행된 MySQL 쿼리에 대한 스팬을 생성해요. 다른 통합은 유지하면서 pymysql의 계측을 비활성화하려면 false로 설정하세요.

PYNAMODB

(2)

DD_PYNAMODB_SERVICE

타입: string 기본값: pynamodb 별칭:DD_PYNAMODB_SERVICE_NAME pynamodb 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "pynamodb"으로 대체돼요.

DD_TRACE_PYNAMODB_ENABLED

타입: boolean 기본값: true pynamodb 통합이 자동 계측되어 PynamoDB를 통한 DynamoDB 호출을 추적하는지 제어해요. 활성화(기본값)하면 PynamoDB 연결을 통해 실행된 데이터베이스 작업이 스팬으로 캡처돼요. 이 통합의 추적을 비활성화하려면 false로 설정하세요.

PYODBC

(2)

DD_PYODBC_SERVICE

타입: string 기본값: pyodbc 별칭:DD_PYODBC_SERVICE_NAME pyodbc 통합이 생성한 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "pyodbc"으로 대체돼요.

DD_TRACE_PYODBC_ENABLED

타입: boolean 기본값: true pyodbc 데이터베이스 드라이버를 통해 이루어진 쿼리를 추적하는 pyodbc 통합이 활성화되는지 제어해요. 활성화(기본값)하면 pyodbc 연결과 커서 작업이 자동 계측되어 데이터베이스 스팬을 생성해요. pyodbc 트레이싱을 비활성화하려면 false로 설정하세요.

PYRAMID

(2)

DD_PYRAMID_SERVICE

타입: string 기본값: pyramid 별칭:DD_PYRAMID_SERVICE_NAME Pyramid 웹 애플리케이션이 생성한 트레이스에 대해 pyramid 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_PYRAMID_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 "pyramid"으로 대체돼요.

DD_TRACE_PYRAMID_ENABLED

타입: boolean 기본값: true 트레이싱이 초기화될 때 pyramid 통합이 자동 패치되는지 제어해요. 활성화(기본값)하면 들어오는 Pyramid 요청과 템플릿 렌더링이 자동 추적돼요. Pyramid 웹 프레임워크의 계측을 비활성화하려면 참이 아닌 값으로 설정하세요.

PYTEST

(2)

DD_PYTEST_SERVICE

타입: string 기본값: pytest 별칭:DD_PYTEST_SERVICE_NAME 테스트 트레이스에 대해 pytest 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 테스트 중인 저장소 이름으로, 저장소 이름을 결정할 수 없으면 "pytest"으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_PYTEST_USE_NEW_PLUGIN_BETA

타입: string 더 이상 사용되지 않음. 이전에는 재작성된 pytest 통합 플러그인을 활성화한 옵트인 플래그였어요. 새 플러그인은 이제 기본값이며 사용에 구성이 필요 없어요. 이 변수가 비어 있지 않은 값으로 설정되면 통합이 pytest 구성 시점에 더 이상 사용되지 않음 경고를 발생시켜요. 버전 3.0.0에서 제거 예정.

PYTEST_BDD

(1)

DD_PYTEST_BDD_SERVICE

타입: string 기본값: pytest_bdd 별칭:DD_PYTEST_BDD_SERVICE_NAME pytest-bdd 시나리오와 단계에서 생성된 스팬에 대해 pytest_bdd 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_PYTEST_BDD_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 "pytest_bdd"으로 대체돼요.

RAY

(5)

DD_RAY_SERVICE

타입: string 별칭:DD_RAY_SERVICE_NAME Ray 작업과 워커가 생성한 스팬에 대해 ray 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 DD_RAY_SERVICE_NAME으로, 그다음 Ray 메타데이터에서 파생된 작업 이름이나 전역 서비스 이름으로, 마지막으로 내장 기본 작업 이름으로 대체돼요.

DD_TRACE_RAY_ARGS_KWARGS

타입: boolean 기본값: false 활성화하면 ray 통합이 Ray 작업과 액터 메서드에 전달된 위치 인자와 키워드 인자를 스팬 태그로 캡처해요. 크거나 민감한 페이로드를 기록하지 않도록 기본적으로 비활성화돼요.

DD_TRACE_RAY_CORE_API

타입: boolean 기본값: false ray 통합이 Ray의 핵심 API 함수(ray.get, ray.put, ray.wait) 추적을 활성화해요. 비활성화하면 이러한 호출은 스팬을 생성하지 않고 실행되며, 상위 레벨 Ray 계측(작업, 태스크, 액터 메서드)은 영향받지 않아요. 기본적으로 비활성화돼요.

DD_TRACE_RAY_ENABLED

타입: boolean 기본값: false ray 통합에 대한 트레이싱을 활성화해요. true로 설정하면 ddtrace가 Ray를 패치해 작업, 태스크, 액터 메서드 호출에 대한 스팬을 생성해요. 기본적으로 비활성화되며, 이 변수로 명시적으로 옵트인해야 해요(또는 patch(ray=True) 호출).

DD_TRACE_RAY_IGNORED_ACTORS

타입: json 기본값: {} Ray 액터 클래스 이름을 ray 통합에서 계측에서 제외해야 하는 메서드 이름 목록에 매핑하는 JSON 객체. 목록 대신 "*" 값을 사용해 해당 액터 클래스의 모든 메서드를 제외할 수 있어요. 예: {"ActorA": ["method1"], "ActorB": "*"}는 ActorA.method1과 ActorB의 모든 메서드를 건너뛰어요. 매칭은 클래스 이름만으로 이루어져요(모듈은 무시). 설정하지 않으면 액터나 메서드가 제외되지 않아요.

RAY_SUBMISSION_SPANS

(1)

DD_TRACE_RAY_SUBMISSION_SPANS_ENABLED

타입: boolean 기본값: false 활성화하면 ray 통합이 실행 스팬에 추가로 task.submit과 actor_method.submit 호출에 대한 스팬을 생성해요. 고처리량 Ray 워크로드에서 스팬 볼륨을 줄이기 위해 기본적으로 비활성화돼요. 큐잉/제출 대기 시간, 팬아웃 패턴, 또는 작업이 제출되었지만 실행 전에 지연되는 경우에 대한 가시성을 위해 활성화하세요.

REDIS

(2)

DD_REDIS_SERVICE

타입: string 기본값: redis 별칭:DD_REDIS_SERVICE_NAME redis 통합이 생성한 Redis 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "redis"으로 대체돼요.

DD_TRACE_REDIS_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACE_INTEGRATION_REDIS_ENABLED, DD_INTEGRATION_REDIS_ENABLED redis에 대한 계측을 활성화해요. 비활성화하면 redis 작업에 대한 스팬이 생성되지 않아요.

REDISCLUSTER

(2)

DD_REDISCLUSTER_SERVICE

타입: string 기본값: rediscluster 별칭:DD_REDISCLUSTER_SERVICE_NAME rediscluster 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "rediscluster"으로 대체돼요.

DD_TRACE_REDISCLUSTER_ENABLED

타입: boolean 기본값: true redis-py-cluster 패키지를 통해 이루어진 Redis Cluster 쿼리를 추적하기 위해 rediscluster 통합이 자동 패치되는지 제어해요. 활성화하면 RedisCluster, StrictRedisCluster 및 그 파이프라인 클래스의 호출이 계측되어 rediscluster 서비스 아래에 보고돼요. 설정하지 않으면 통합은 기본적으로 활성화돼요.

REQUESTS

(2)

DD_REQUESTS_SERVICE

타입: string 기본값: requests 별칭:DD_REQUESTS_SERVICE_NAME requests 통합이 생성한 HTTP 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "requests"으로 대체돼요. split_by_domain 설정이 활성화되면 이 값이 재정의되며, 그 경우 요청의 도메인이 서비스 이름으로 사용돼요.

DD_TRACE_REQUESTS_ENABLED

타입: boolean 기본값: true requests 통합이 자동 패치되어 requests 라이브러리를 통해 이루어진 HTTP 클라이언트 호출을 추적하는지 제어해요. 설정하지 않으면 통합은 기본적으로 활성화되고, 다른 통합은 그대로 두고 requests 트레이싱을 비활성화하려면 false로 설정하세요.

RQ

(2)

DD_RQ_SERVICE

타입: string 기본값: rq 별칭:DD_RQ_SERVICE_NAME enqueuer 쪽의 rq 통합이 생성한 RQ 스팬에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_SERVICE으로, 마지막으로 기본 서비스 이름 "rq"으로 대체돼요.

DD_TRACE_RQ_ENABLED

타입: boolean 기본값: true rq 통합이 RQ(Redis Queue) 작업 enqueue, fetch, 워커 작업 실행에 대한 트레이스를 생성하는지 제어해요. false로 설정하면 통합은 패치되지만 스팬을 생성하지 않아요. rq 라이브러리가 있을 때 기본적으로 활성화돼요.

RQ_WORKER

(1)

DD_RQ_WORKER_SERVICE

타입: string 기본값: rq-worker 별칭:DD_RQ_WORKER_SERVICE_NAME rq 통합을 통한 RQ 워커가 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "rq-worker"으로 대체돼요.

SAFE_INSTRUMENTATION

(1)

DD_TRACE_SAFE_INSTRUMENTATION_ENABLED

타입: boolean 기본값: false 활성화하면 ddtrace가 각 설치된 패키지의 버전이 해당 통합의 지원 범위 내에 있는지 패치 전에 확인해요. 지원 범위 밖의 패키지는 패치되지 않은 채 남아, 호환되지 않는 라이브러리 버전 계측으로 인한 애플리케이션 충돌을 피하는 데 도움이 돼요. 설정하지 않으면 모든 사용 가능한 통합이 버전 호환성 검사 없이 패치돼요.

SANIC

(2)

DD_SANIC_SERVICE

타입: string 기본값: sanic 별칭:DD_SANIC_SERVICE_NAME sanic 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_SANIC_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_SANIC_ENABLED

타입: boolean 기본값: true sanic 통합이 활성화되는지 제어해요. 활성화하면 들어오는 Sanic HTTP 요청이 자동 추적되어 요청 메서드, URL, 상태 코드, 헤더가 포함된 서버 스팬을 생성해요. 다른 통합은 그대로 두고 Sanic 계측을 비활성화하려면 false로 설정하세요.

SELENIUM

(1)

DD_SELENIUM_SERVICE

타입: string 별칭:DD_SELENIUM_SERVICE_NAME selenium 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_SELENIUM_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

SNOWFLAKE

(2)

DD_SNOWFLAKE_SERVICE

타입: string 기본값: snowflake 별칭:DD_SNOWFLAKE_SERVICE_NAME snowflake 통합이 생성한 Snowflake 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "snowflake"으로 대체돼요.

DD_TRACE_SNOWFLAKE_ENABLED

타입: boolean 기본값: false snowflake-connector-python 라이브러리를 계측해 Snowflake 쿼리를 추적하는 snowflake 통합이 활성화되는지 제어해요. 이 통합은 베타이며 ddtrace-run이나 import ddtrace.auto로 자동 활성화되지 않아요. 옵트인하려면 true로 설정하세요. DD_PATCH_MODULES=snowflake:true 설정과 동일해요.

SQLALCHEMY

(2)

DD_SQLALCHEMY_SERVICE

타입: string 별칭:DD_SQLALCHEMY_SERVICE_NAME sqlalchemy 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 DD_SQLALCHEMY_SERVICE_NAME으로, 그다음 통합이 감지한 부모 서비스 또는 데이터베이스 엔진 이름으로 대체돼요.

DD_TRACE_SQLALCHEMY_ENABLED

타입: boolean 기본값: false sqlalchemy 통합이 활성화되는지 제어해요. 활성화하면 SQLAlchemy 엔진 작업이 추적돼요. 중복 스팬을 피하기 위해 밑바닥 데이터베이스 클라이언트(예: psycopg, mysql, sqlite3)를 직접 추적하는 것을 선호하므로 기본적으로 비활성화돼요.

SQLITE

(1)

DD_SQLITE_SERVICE

타입: string 기본값: sqlite 별칭:DD_SQLITE_SERVICE_NAME sqlite 통합이 생성한 SQLite 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "sqlite"으로 대체돼요.

SQLITE3

(2)

DD_SQLITE3_SERVICE

타입: string 별칭:DD_SQLITE3_SERVICE_NAME sqlite3 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "sqlite"으로 대체돼요.

DD_TRACE_SQLITE3_ENABLED

타입: boolean 기본값: true sqlite3에 대한 계측을 활성화해요. 비활성화하면 sqlite3 작업에 대한 스팬이 생성되지 않아요.

STARLETTE

(2)

DD_STARLETTE_SERVICE

타입: string 기본값: starlette 별칭:DD_STARLETTE_SERVICE_NAME starlette 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "starlette"으로 대체돼요.

DD_TRACE_STARLETTE_ENABLED

타입: boolean 기본값: true starlette 통합이 활성화되는지 제어해요. 활성화하면 Starlette 애플리케이션이 처리하는 들어오는 요청이 라우팅, 미들웨어, 백그라운드 작업을 포함해 추적돼요. 다른 통합에 영향을 주지 않고 Starlette 트레이싱을 비활성화하려면 false로 설정하세요.

STRUCTLOG

(2)

DD_STRUCTLOG_SERVICE

타입: string 별칭:DD_STRUCTLOG_SERVICE_NAME structlog로 렌더링된 로그 레코드에 트레이싱 컨텍스트를 주입하는 structlog 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_STRUCTLOG_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_STRUCTLOG_ENABLED

타입: boolean 기본값: true structlog 통합이 patch_all()에서 패치되는지 제어해요. 활성화하면 ddtrace가 구성된 프로세서 체인 앞에 Datadog 프로세서를 추가해 트레이스 컨텍스트(트레이스 ID, 스팬 ID, 서비스, env, 버전)를 structlog 로그 레코드에 주입해 로그를 APM 트레이스와 상관시킬 수 있게 해 줘요. patch_all()이 호출되어도 structlog 패칭을 비활성화하려면 false로 설정하세요.

SUBPROCESS

(2)

DD_SUBPROCESS_SERVICE

타입: string 별칭:DD_SUBPROCESS_SERVICE_NAME Python subprocess 모듈을 통해 실행된 명령을 추적하는 subprocess 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_SUBPROCESS_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_SUBPROCESS_ENABLED

타입: boolean 기본값: true subprocess 통합이 활성화되는지 제어해요. 활성화하면 subprocess.Popen과 관련 os 함수(os.system, os.fork, os.spawn*)가 계측되어 AAP 같은 Application Security 기능이 명령 실행을 모니터링할 수 있어요. 이 함수들의 패칭을 완전히 건너뛰려면 비활성화하세요.

TORNADO

(2)

DD_TORNADO_SERVICE

타입: string 별칭:DD_TORNADO_SERVICE_NAME tornado 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_TORNADO_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_TORNADO_ENABLED

타입: boolean 기본값: false Tornado 웹 프레임워크를 계측해 들어오는 요청, 핸들러, 템플릿 렌더링에 대한 트레이스를 생성하는 tornado 통합이 활성화되는지 제어해요. 설정하지 않으면 통합은 기본적으로 비활성화되고 Tornado 애플리케이션은 자동 계측되지 않아요.

UNITTEST

(2)

DD_TRACE_UNITTEST_ENABLED

타입: boolean 기본값: true 테스트 실행을 추적하고 Datadog Test Visibility에 보고하는 unittest 통합이 활성화되는지 제어해요. 활성화(기본값)하면 ddtrace-run 또는 import ddtrace.auto를 사용할 때 Python unittest 프레임워크로 실행된 테스트가 자동 계측돼요. unittest 테스트의 계측을 비활성화하려면 false로 설정하세요.

DD_UNITTEST_SERVICE

타입: string 기본값: unittest 별칭:DD_UNITTEST_SERVICE_NAME unittest 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_UNITTEST_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

URLLIB3

(2)

DD_TRACE_URLLIB3_ENABLED

타입: boolean 기본값: false urllib3를 통해 이루어진 나가는 HTTP 요청을 선택적 크로스 서비스 분산 트레이싱으로 계측하는 urllib3 통합이 활성화되는지 제어해요. 이 통합은 기본적으로 비활성화되어 있으며, 옵트인하려면 true로 설정하세요. urllib3를 DD_PATCH_MODULES에 포함하는 것과 동일해요.

DD_URLLIB3_SERVICE

타입: string 기본값: urllib3 별칭:DD_URLLIB3_SERVICE_NAME urllib3 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "urllib3"으로 대체돼요.

VALKEY

(2)

DD_TRACE_VALKEY_ENABLED

타입: boolean 기본값: true 별칭:DD_INTEGRATION_VALKEY_ENABLED, DD_TRACE_INTEGRATION_VALKEY_ENABLED Valkey 계측을 활성화해요.

DD_VALKEY_SERVICE

타입: string 기본값: valkey 별칭:DD_VALKEY_SERVICE_NAME valkey 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_VALKEY_SERVICE_NAME으로, 그다음 기본 서비스 이름 "valkey"으로 대체돼요.

VERTEXAI

(2)

DD_TRACE_VERTEXAI_ENABLED

타입: boolean 기본값: true Vertex Generative AI SDK for Python을 계측해 Google 모델에 대한 요청을 추적하는 vertexai 통합이 활성화되는지 제어해요. 활성화(기본값)하면 Vertex AI SDK를 통해 이루어진 호출이 모델과 공급자로 태그된 스팬을 생성해요. Vertex AI 요청 추적을 비활성화하려면 false로 설정하세요.

DD_VERTEXAI_SERVICE

타입: string 별칭:DD_VERTEXAI_SERVICE_NAME Vertex AI Generative AI SDK를 계측할 때 생성된 트레이스에 대해 vertexai 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 전역 서비스 이름으로 대체돼요.

VERTICA

(2)

DD_TRACE_VERTICA_ENABLED

타입: boolean 기본값: true vertica-python 라이브러리를 사용해 이루어진 쿼리를 추적하는 vertica 통합이 활성화되는지 제어해요. 활성화(기본값)하면 vertica-python이 가져오기 시 자동 패치되어 데이터베이스 쿼리가 스팬을 생성해요. 이 통합의 추적을 비활성화하려면 false로 설정하세요. 참고: Vertica 통합은 더 이상 사용되지 않으며 향후 버전에서 제거될 예정이에요.

DD_VERTICA_SERVICE

타입: string 기본값: vertica 별칭:DD_VERTICA_SERVICE_NAME vertica-python을 통해 이루어진 쿼리를 추적하는 vertica 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "vertica"으로 대체돼요.

VLLM

(2)

DD_TRACE_VLLM_ENABLED

타입: boolean 기본값: true vllm 통합이 활성화되는지 제어해요. 활성화하면 vLLM V1 엔진을 통한 요청이 추적되어 모델 이름, 대기 시간 메트릭(TTFT, 큐, prefill, decode, inference), 토큰 사용량을 캡처해요. 비활성화하면 vLLM 스팬이 생성되지 않아요. vLLM V1(VLLM_USE_V1=1)과 vLLM >= 0.10.2가 필요해요.

DD_VLLM_SERVICE

타입: string 별칭:DD_VLLM_SERVICE_NAME vllm 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "vllm"으로 대체돼요.

WEBSOCKET_MESSAGES

(2)

DD_TRACE_WEBSOCKET_MESSAGES_ENABLED

타입: boolean 기본값: true 전송·수신된 websocket 메시지(텍스트와 바이너리)와 연결 종료 이벤트 추적을 활성화해요.

DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES

타입: boolean 기본값: true 기본적으로 각 수신 메시지가 새 트레이스를 생성해요. 핸드셰이크는 스팬 링크로 연결돼요. 이 매개변수를 false로 설정하면 세션 중 캡처된 모든 스팬이 동일한 트레이스에 있게 돼요.

WSGI

(1)

DD_WSGI_SERVICE

타입: string 기본값: wsgi 별칭:DD_WSGI_SERVICE_NAME WSGI 기반 애플리케이션이 생성한 트레이스에 대해 wsgi 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_WSGI_SERVICE_NAME으로, 그다음 전역 서비스 이름으로, 마지막으로 기본 서비스 이름 "wsgi"으로 대체돼요.

YAAREDIS

(2)

DD_TRACE_YAAREDIS_ENABLED

타입: boolean 기본값: true yaaredis 통합이 활성화되는지 제어해요. 활성화하면 yaaredis 클라이언트를 통해 이루어진 호출이 자동 추적되어 Redis 스팬으로 보고돼요. yaaredis 라이브러리 패칭을 건너뛰고 명령과 파이프라인에 대한 스팬 생성을 중지하려면 비활성화하세요. 참고: 이 통합은 더 이상 사용되지 않으며 제거 예정이에요.

DD_YAAREDIS_SERVICE

타입: string 기본값: redis 별칭:DD_YAAREDIS_SERVICE_NAME yaaredis 통합이 생성한 트레이스에 대해 기본적으로 보고되는 서비스 이름을 설정해요. 설정하지 않으면 트레이스는 기본 서비스 이름 "redis"으로 대체돼요.

폐기된 키 (Retired keys)

(12)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_BOTOCORE_BEDROCK_RESOLVE_INFERENCE_PROFILE

v4.12.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.13.0 활성화하면 애플리케이션 추론 프로필 ARN을 modelId로 사용하는 Agent Observability Bedrock 호출이 밑바닥 파운데이션 모델을 해석해 스팬이 실제 모델을 보고하고 비용이 채워져요. DD_LLMOBS_ENABLED=true와 bedrock:GetInferenceProfile IAM 권한이 필요해요.

DD_HTTPX2_DISTRIBUTED_TRACING

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.15.0 HTTPX2 요청에 대한 분산 트레이싱 헤더의 전파를 활성화해요.

DD_HTTPX2_SERVICE

v4.13.3에서 제거됨. 타입: string 시작 버전: v4.15.0 별칭:DD_HTTPX2_SERVICE_NAME HTTPX2 클라이언트 요청에 대해 보고되는 서비스 이름을 설정해요.

DD_HTTPX2_SPLIT_BY_DOMAIN

v4.13.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.15.0 HTTPX2 요청의 서비스 이름으로 대상 도메인을 사용해요.

DD_MISTRALAI_SERVICE

v4.11.4에서 제거됨. 타입: string 시작 버전: v4.12.0 별칭:DD_MISTRALAI_SERVICE_NAME MistralAI 공급자 요청의 기본 서비스 이름을 재정의해요. Datadog에서 MistralAI 트레이스를 사용자 지정 서비스 이름 아래에 그룹화하는 데 사용할 수 있어요.

DD_OPENAI_REALTIME_ENABLED

v4.12.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.13.0 OpenAI Realtime API(client.realtime.connect(...), 동기·비동기 모두)의 LLM Observability 계측을 활성화해요. false로 설정하면 OpenAI 통합의 나머지(채팅 완료, 응답, 임베딩 등)는 계속 실행되면서 Realtime 계측만 비활성화돼요. 기본값은 true.

DD_PYTORCH_JOB_ID

v4.11.4에서 제거됨. 타입: string 시작 버전: v4.12.0 PyTorch contrib의 명시적 학습 작업 ID. 설정하면 모든 자동 감지 ID(RAY_JOB_ID, TORCHELASTIC_RUN_ID, KUBEFLOW_TRAINING_JOB_ID, SLURM_JOB_ID)보다 우선해요. 랭크 간 pytorch.rank 스팬 상관관계에 사용돼요.

DD_PYTORCH_SERVICE

v4.11.4에서 제거됨. 타입: string 시작 버전: v4.12.0 별칭:DD_PYTORCH_SERVICE_NAME PyTorch 통합이 생성한 스팬의 기본 서비스 이름을 재정의해요. 별칭: DD_PYTORCH_SERVICE_NAME.

DD_TRACE_ANYIO_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.15.0 AnyIO가 워커 스레드에서 동기식 호출 가능 객체를 실행할 때 AnyIO 통합이 가져오기 시 패치되어 활성 트레이스 컨텍스트를 다시 게시하고, 이벤트 루프 밖에서 실행된 작업이 이를 예약한 트레이스에 귀속되도록 하는지 제어해요.

DD_TRACE_HTTPX2_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.15.0 HTTPX2 라이브러리에 대한 자동 트레이싱 계측을 활성화해요.

DD_TRACE_MISTRALAI_ENABLED

v4.11.4에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.12.0 MistralAI 요청의 추적을 활성화하거나 비활성화해요. 활성화하면 요청이 LLM Observability를 통해 자동 추적돼요.

DD_TRACE_PYTORCH_ENABLED

v4.11.4에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.12.0 PyTorch 분산 학습 통합을 활성화하거나 비활성화해요. 활성화하면 랭크, 월드 크기, 학습 프레임워크(DDP/FSDP/DeepSpeed), 런처, 학습 작업 ID에 대한 태그와 함께 랭크당 장수명 pytorch.rank 스팬이 생성돼요. 이 통합은 옵트인이며 기본적으로 비활성화되어 있어요. DD_PATCH_MODULES=pytorch:true로 또는 프로그래밍 방식으로 ddtrace.patch(pytorch=True)로 활성화하세요.

Database Monitoring

(2)

DBM(Database Monitoring): SQL 주석 전파 모드와 데이터베이스 성능을 애플리케이션 트레이스와 상관시키기 위한 쿼리 식별자 해싱.

DD_DBM_INJECT_SQL_BASEHASH

타입: boolean 기본값: false DBM 전파도 활성화된 경우 SQL 쿼리에 "기본 해시(base hash)"의 주입을 활성화해요. 이 기본 해시는 일치하는 스팬을 찾고 관련 값으로 쿼리를 보강하는 데 사용돼요.

DD_DBM_PROPAGATION_MODE

타입: string 기본값: disabled service 또는 full로 설정하면 APM에서 보낸 데이터와 Database Monitoring 제품 간의 연결을 활성화해요. service 옵션은 DBM과 APM 서비스 간의 연결을 가능하게 해요. full 옵션은 데이터베이스 스팬과 데이터베이스 쿼리 이벤트 간의 연결을 가능하게 해요. Postgres와 MySQL에서 사용 가능해요.

트레이스 로깅 (Trace Logging)

(6)

트레이서 로그 출력 설정: 로그 수준, 로그 파일 경로, 로그 회전, 시작 진단.

DD_LOGGING_SERVICE

타입: string 별칭:DD_LOGGING_SERVICE_NAME logging 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_LOGGING_SERVICE_NAME으로, 그다음 전역 서비스 이름으로 대체돼요.

DD_TRACE_DEBUG

타입: boolean 기본값: false 별칭:OTEL_LOG_LEVEL SDK의 디버그 모드를 활성화해요. 설정하면 SDK가 문제 해결을 위해 자세한 로그 메시지를 내보내요. 활성화되면 DD_TRACE_LOG_LEVEL보다 우선해요. 별칭으로 OTEL_LOG_LEVEL을 사용하세요.

언어별 참고:

PHP: 로그 메시지는 PHP error_log INI 설정에 지정된 장치나 파일에 기록돼요. 실제 값은 PHP-FPM/Apache 구성 파일에서 재정의될 수 있어 php -i 출력과 다를 수 있어요.

DD_TRACE_LOG_FILE

타입: string 로그 파일을 지정해요. 지정하지 않으면 로그는 기본 PHP 오류 위치로 가요. datadog-ipc-helper 문제(예: 텔레메트리 제출)를 디버깅하려면 로그 파일을 지정해야 해요.

DD_TRACE_LOG_FILE_SIZE_BYTES

타입: int 기본값: 15728640 DD_TRACE_LOG_FILE이 지정한 ddtrace 로그 파일이 회전되기 전의 최대 크기(바이트). 활성 로그 파일이 이 크기를 초과하면 백업 파일이 하나 생성되므로, 디스크의 총 로그 저장 공간은 대략 2 * DD_TRACE_LOG_FILE_SIZE_BYTES예요. DD_TRACE_LOG_FILE이 설정되지 않으면 효과가 없어요.

DD_TRACE_LOG_LEVEL

타입: string 별칭:DD_LOG_LEVEL 디버그 로깅이 활성화될 때 트레이서가 사용할 최소 로그 수준 문자열. 가능한 수준은 info, warn, error, debug예요.

DD_TRACE_LOGGING_RATE

타입: int 기본값: 60 Tracer 로그 파일의 동일한 로그 메시지 사이의 초 수를 설정해요. 기본값은 0이며 0으로 설정하면 비율 제한을 비활성화해요.

지속적 프로파일링 (Continuous Profiling)

(27)

Continuous Profiler 구성: 활성화/비활성화, 업로드 설정, 프로파일링 유형, 엔진 옵션, 코드 핫스팟, 엔드포인트 프로파일링, 실험 기능.

DD_PROFILING_AGENTLESS

타입: boolean 기본값: false 에이전트리스 프로파일 업로드를 활성화해 Datadog Agent를 거치지 않고 프로파일을 Datadog 백엔드로 직접 전송해요.

DD_PROFILING_API_TIMEOUT_MS

타입: int 기본값: 10000 프로파일러의 HTTP API 업로드에 대한 타임아웃(밀리초)을 설정해요. Datadog 백엔드가 이 시간 내에 응답하지 않으면 해당 업로드의 프로파일링 이벤트가 버려져요. 음이 아닌 정수여야 해요.

DD_PROFILING_CAPTURE_PCT

타입: decimal 기본값: 1.0 프로파일러가 캡처하는 프로파일링 이벤트(예: 메모리 할당)의 백분율을 설정해요. 0과 100 사이의 값이어야 하며, 높은 값은 프로파일 충실도를 높이지만 프로그램 실행을 느리게 해요. 설정하지 않으면 기본값은 1.0.

DD_PROFILING_ENABLE_ASSERTS

타입: boolean 기본값: false 활성화하면 프로파일러의 내부 디버그 어서션을 켜요. 어서션을 켜면 프로파일링 코드가 예기치 않은 내부 상태에서 조용히 삼키는 대신 AssertionError를 발생시켜요(예: 락 획득/해제 샘플링). 프로파일러 자체를 디버깅하기 위한 것이며 프로덕션에서는 비활성화 두세요.

DD_PROFILING_ENABLE_CODE_PROVENANCE

타입: boolean 기본값: true 프로파일러가 업로드된 프로파일에 코드 출처 메타데이터를 부착하는지 제어해요. 코드 출처는 프로파일된 코드가 어떤 패키지와 버전에서 왔는지 설명해 프로파일링 데이터를 배포된 의존성과 상관시키는 데 도움이 돼요. 비활성화하면 이 출처 정보 없이 프로파일이 업로드돼요.

DD_PROFILING_ENABLED

타입: boolean 기본값: false 별칭:DD_EXPERIMENTAL_PROFILING_ENABLED CPU, 힙, goroutine 및 기타 런타임 프로파일을 수집해 Datadog에 업로드하는 연속 프로파일러를 활성화해요.

DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

타입: boolean 기본값: true 별칭:DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED 스팬이 Datadog UI에서 프로파일을 엔드포인트별로 그룹화할 수 있도록 최상위 요청 엔드포인트가 포함된 pprof 레이블을 추가하는지 제어해요.

DD_PROFILING_EXCEPTION_COLLECT_MESSAGE

타입: boolean 기본값: false 활성화하면 예외 프로파일러가 각 샘플링된 예외 이벤트에 예외 메시지 문자열을 부착해요. 예외 메시지는 민감한 데이터를 포함할 수 있어 기본적으로 비활성화돼요. 예외 프로파일러 자체가 활성화된 경우에만 적용돼요.

DD_PROFILING_EXCEPTION_ENABLED

타입: boolean 기본값: false 예외 이벤트 프로파일링을 활성화해 예외가 많은 코드 경로가 프로파일에 나타나게 해요. 오류 폭풍이나 예외를 통한 제어 흐름을 진단할 때 유용해요.

DD_PROFILING_EXCEPTION_SAMPLING_INTERVAL

타입: int 기본값: 100 예외 프로파일러가 샘플을 취하는 사이에 발생한 평균 예외 수를 Poisson 분포로 설정해요. 낮은 값은 더 자주 샘플링하지만 오버헤드를 늘려요. 양의 정수(>= 1)여야 해요. 예외 프로파일러가 활성화된 경우에만 적용돼요.

DD_PROFILING_HEAP_ENABLED

타입: boolean 기본값: true true로 설정하면 Live Heap 프로파일링(Preview)을 활성화해요. 기본값은 DD_PROFILING_PROFILERS예요. false로 설정하면 DD_PROFILING_PROFILERS 항목을 무시해요.

DD_PROFILING_HEAP_SAMPLE_SIZE

타입: int 힙 메모리 프로파일러가 샘플을 취하는 사이에 할당된 평균 바이트 수를 설정해요. 낮은 값은 더 빈번한 샘플을 생성하고(높은 충실도, 높은 오버헤드), 높은 값은 오버헤드를 줄여요. 설정하지 않으면 최소 1MiB와 함께 호스트의 총 메모리에서 자동으로 도출돼요. 0으로 설정하면 힙 샘플링을 비활성화해요.

DD_PROFILING_IGNORE_PROFILER

타입: boolean 기본값: false 더 이상 사용되지 않음. 활성화하면 프로파일러가 생성된 프로파일링 데이터에서 자체 스레드를 생략하므로, 프로파일러 자체에 속한 프레임이 스택 및 메모리 할당 샘플에서 제외돼요. 설정하지 않으면 프로파일러 스레드가 프로파일에 포함돼요.

DD_PROFILING_LOCK_ENABLED

타입: boolean 기본값: true 이 구성이 false로 설정되면 락 프로파일 수집이 비활성화돼요.

DD_PROFILING_LOCK_NAME_INSPECT_DIR

타입: boolean 기본값: true 락 프로파일러가 샘플링된 락의 이름을 복구하기 위해 로컬·전역 변수의 속성을 검사하는지 제어해요. 활성화하면 객체의 속성으로 보유된 락이 익명 락이 아닌 속성 이름(예: MyClass.my_lock)으로 보고돼요. 속성 접근에 잘못 동작하는 타사 디스크립터를 방해한다면 이 검사를 건너뛰도록 비활성화하세요.

DD_PROFILING_MAX_FRAMES

타입: int 기본값: 64 프로파일에서 스레드 샘플당 캡처되는 최대 스택 프레임 수.

DD_PROFILING_MAX_TIME_USAGE_PCT

타입: decimal 기본값: 1.0 스택 프로파일러가 샘플 수집과 통계 계산에 쓸 수 있는 월시계 시간의 비율을 백분율로 제한해요. 프로파일러는 이 예산 아래 머물도록 샘플링 간격을 동적으로 조정해요. 0보다 크고 100보다 작거나 같아야 해요. 기본값은 1.0(1%).

DD_PROFILING_MEMORY_ENABLED

타입: boolean 기본값: true 메모리 프로파일러가 활성화되는지 제어해요. 활성화하면 프로파일러가 애플리케이션에서 메모리 할당 샘플을 수집해 Datadog에 보고해요. 비활성화하면 메모리 할당 프로파일이 생성되지 않지만, 활성화되어 있다면 다른 프로파일 유형(CPU, 힙, 락 등)은 계속 실행돼요. 기본값은 활성화.

DD_PROFILING_MEMORY_EVENTS_BUFFER

타입: int 기본값: 16 메모리 프로파일러가 사용하는 이벤트 버퍼 크기를 설정해요. 높은 값은 프로파일러가 플러시 사이에 더 많은 메모리 할당 이벤트를 유지하게 하고, 낮은 값은 이벤트를 잠재적으로 버리는 비용으로 메모리 오버헤드를 줄여요. 음이 아닌 정수여야 해요. 설정하지 않으면 16을 기본값으로 해요.

DD_PROFILING_PYTORCH_ENABLED

타입: boolean 기본값: false PyTorch 프로파일러 수집기가 Datadog 프로파일러의 일부로 시작되는지 제어해요. 활성화하면 프로파일러가 torch.profiler 사용을 래핑해 표준 Python 프로파일링 데이터와 함께 ML 프레임워크 프로파일링 이벤트를 캡처해요. 기본적으로 비활성화돼요.

DD_PROFILING_PYTORCH_EVENTS_LIMIT

타입: int 기본값: 1000000 각 수집 주기 동안 PyTorch 프로파일러가 기록하는 최대 이벤트 수를 설정해요. 캡처된 이벤트 수가 이 한도를 초과하면 이 크기의 무작위 하위 샘플이 유지되고 나머지는 버려져요. 음이 아닌 정수여야 하며, 설정하지 않으면 1000000을 기본값으로 해요.

DD_PROFILING_SAMPLE_POOL_CAPACITY

타입: int 기본값: 4 재사용을 위해 내부 풀에 보관되는 프로파일러 Sample 객체 수를 설정해요. 용량을 늘리면 프로파일 수집 중 Sample 객체를 빈번히 할당·해제하는 오버헤드를 줄일 수 있어요. 음이 아닌 정수여야 하며, 설정하지 않으면 4를 기본값으로 해요.

DD_PROFILING_STACK_ENABLED

타입: boolean 기본값: true 스택 프로파일러가 활성화되는지 제어해요. 스택 프로파일러는 실행 중인 스레드에서 주기적으로 Python 스택 트레이스를 수집해 CPU와 월시계 샘플을 캡처하며, Datadog Profiler에 표시되는 CPU/월시계 데이터의 기본 소스예요. 비활성화하면 스택 샘플이 수집되지 않고 관련 수집기(스택 프로파일러에 의존하는 asyncio·threading 계측 등)도 꺼져요. 밑바닥 스택 모듈을 로드할 수 없으면 구성된 값과 무관하게 강제로 꺼져요.

DD_PROFILING_STACK_NATIVE_FRAMES

타입: boolean 기본값: true 스택 프로파일러가 Python 프레임에 추가로 네이티브(C/C++) 함수 프레임을 캡처하는지 제어해요. Python 3.12 이상에서만 적용되며, 이전 버전에서는 설정이 무시돼요. 설정하지 않으면 네이티브 프레임 캡처가 활성화돼요.

DD_PROFILING_STACK_UVLOOP

타입: boolean 기본값: true 스택 프로파일러가 uvloop 인식 비동기 프로파일링을 활성화하는지 제어해요. 활성화하면 프로파일러가 uvloop 이벤트 루프에 훅을 걸어 uvloop에서 실행되는 비동기 작업 스택이 올바르게 캡처되도록 해요. 작업 스택에서 uvloop 래퍼 프레임을 건너뛰는 것을 포함해요. 비활성화하면 uvloop 이벤트 루프가 계측되지 않고 uvloop에서 실행되는 비동기 스택이 불완전하거나 래퍼 프레임에 귀속될 수 있어요. 기본값은 활성화.

DD_PROFILING_TIMELINE_ENABLED

타입: boolean 기본값: true 별칭:DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED 타임라인 프로파일 유형을 활성화해요.

참고: 이 설정은 DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED 환경 변수(datadog.profiling.experimental_timeline_enabled INI 설정)를 대체해요. 둘 다 설정되면 이 설정이 우선해요.

언어별 참고:

PHP: 이 설정은 0.89부터 사용 가능했던 datadog.profiling.experimental_timeline_enabled INI 설정을 대체해요.

DD_PROFILING_UVLOOP

타입: boolean 기본값: true 프로파일러가 uvloop 인식 비동기 프로파일링을 활성화하는지 제어해요. 활성화하면 프로파일러가 uvloop 이벤트 루프에 훅을 걸어 일반 asyncio 작업과 함께 uvloop에서 실행되는 비동기 작업이 스택 프로파일에 캡처되도록 해요. 애플리케이션에 문제를 일으키면 uvloop 계측을 건너뛰도록 비활성화하세요.

폐기된 키 (Retired keys)

(4)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_PROFILING_MEMORY_MEM_DOMAIN_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.15.0 MEM-도메인 CPython 훅을 활성화해 Python 메모리 프로파일러가 그러한 할당을 샘플링할 수 있게 해요.

DD_PROFILING_NATIVE_HEAP_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: `v4.15.0** 이 설정을 사용하면 사용자가 Profiling UI에서 샘플링된 네이티브 메모리 할당을 볼 수 있어요.

DD_PROFILING_PYTORCH_MAX_FRAMES

v4.11.4에서 제거됨. 타입: int 기본값: 128 시작 버전: v4.12.0 PyTorch Profiling에서 캡처할 최대 프레임 수를 제어해요.

DD_PROFILING_STACK_GC_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.15.0 프로파일러가 전용 프레임에서 가비지 컬렉션에 쓴 시간을 보고하는지 제어해요.

애플리케이션 보안 (Application Security)

(41)

Application Security 구성: ASM 위협 감지와 차단, 사용자 이벤트 추적, IAST 취약점 감지, API Security 스키마 발견, 오류 추적.

DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE

타입: decimal 기본값: 0.5 다운스트림 요청 본문이 샘플링될 확률, 또는 다시 말해 요청·응답 본문이 샘플링/분석되어야 하는 전체 요청 수를 정의해요.

DD_API_SECURITY_ENABLED

타입: boolean 기본값: true 별칭:DD_EXPERIMENTAL_API_SECURITY_ENABLED API Security 기능이 활성화되는지 제어해요. 설정하지 않으면 API Security는 기본적으로 활성화돼요.

DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED

타입: boolean 기본값: true API 엔드포인트 정의가 수집되어 API Catalog에서 사용하기 위해 보고되는지 제어해요. 엔드포인트 발견을 억제하려면 비활성화하세요.

DD_API_SECURITY_ENDPOINT_COLLECTION_MESSAGE_LIMIT

타입: int 기본값: 300 단일 엔드포인트 수집 텔레메트리 메시지에 포함되는 최대 API 엔드포인트 수를 설정해요. 설정하지 않으면 기본 한도가 사용돼요.

DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS

타입: int 기본값: 1 요청·응답 본문이 분석되어야 하는 요청당 다운스트림 요청의 최대 수.

DD_API_SECURITY_PARSE_RESPONSE_BODY

타입: boolean 기본값: true API Security 모듈에서 응답 본문 파싱을 활성화해요. 기본값은 true.

DD_API_SECURITY_REQUEST_SAMPLE_RATE

타입: decimal 기본값: 0.1 API Security 스키마 추출의 샘플링 비율을 설정해요. 값은 0.0~1.0 범위로 클램프되며, 설정되지 않았거나 유효하지 않으면 기본 비율이 사용돼요.

DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE

타입: string AppSec 자동 사용자 계측 모드(사용자 ID 수집 모드)를 설정해요. 지원 값은 identification/ident, anonymization/anon, disabled예요.

DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING

타입: string 기본값: safe AppSec의 자동 사용자 이벤트 추적을 제어해요. 활성화/비활성화 및 추적 모드 선택을 포함해요. 더 이상 사용되지 않음. appsec.auto_user_instrumentation.mode 설정을 선호해요.

DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING_ENABLED

타입: boolean 기본값: true AppSec 사용자 수명주기 신호(로그인 성공/실패, 가입, 인증된 사용자)를 스팬 메타데이터로 자동 생성하는 것을 활성화해요. SDK 이벤트를 수동으로 생성하지 않고 계정 남용 및 인증 관련 감지를 원할 때 사용하세요.

DD_APPSEC_ENABLED

타입: boolean 기본값: false 트레이서 내부에서 AppSec 제품을 활성화하거나 비활성화해요. 활성화하면 트레이서가 AppSec 모듈(인앱 WAF, 헤더/본문 수집, AppSec 텔레메트리)을 초기화해요.

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML

타입: string 요청이 차단되고 응답이 HTML이어야 할 때 반환할 로컬 HTML 템플릿 파일 경로. 설정되지 않았거나 유효하지 않으면 트레이서는 제품 RFC가 정의한 기본 차단 HTML 템플릿을 사용해요. 트레이서는 Accept 헤더 또는 차단 액션의 매개변수에 따라 HTML 또는 JSON을 결정해요.

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_JSON

타입: string 요청이 차단되고 응답이 JSON이어야 할 때 반환할 로컬 JSON 템플릿 파일 경로. 설정되지 않았거나 유효하지 않으면 트레이서는 제품 RFC가 정의한 기본 차단 JSON 템플릿을 사용해요. 트레이서는 Accept 헤더 또는 차단 액션의 매개변수에 따라 HTML 또는 JSON을 선택해요.

DD_APPSEC_MAX_STACK_TRACE_DEPTH

타입: int 기본값: 32 별칭:DD_APPSEC_MAX_STACKTRACE_DEPTH AppSec 이벤트에 첨부된 스택 트레이스에 유지되는 최대 스택 프레임 수. 한도에 도달하면 더 깊은 프레임은 잘리고 스택 상단의 프레임은 보존돼요. 이벤트 페이로드 크기를 줄이려면 값을 낮추세요.

DD_APPSEC_MAX_STACK_TRACE_DEPTH_TOP_PERCENT

타입: int 기본값: 75 트레이서가 스택트레이스를 잘라야 할 때 이 값은 스택트레이스 상단 부분 중 얼마나 많은 양이 더 높은 정밀도로 보존되는지(백분율) 제어해요. 이렇게 하면 덜 유용한 깊은 프레임을 자르면서 더 많은 상단 프레임(가장 실행 가능한)을 유지할 수 있어요.

DD_APPSEC_MAX_STACK_TRACES

타입: int 기본값: 2 별칭:DD_APPSEC_MAX_STACKTRACES 페이로드 크기를 합리적으로 유지하기 위해 AppSec/IAST 이벤트에 캡처·첨부되는 별도 스택트레이스 수를 제한해요. 증거 스택트레이스는 트라이지에 유용하지만, 무제한 캡처는 민감한 데이터를 유출하고 과도한 대역폭을 소비할 수 있어요. 이 한도는 증거 가치와 안전성 사이의 균형을 유지해요. 모두 수집하려면 0으로 설정하세요.

DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP

타입: string AppSec 난독화기가 전체 편집을 야기해야 하는 매개변수 키를 식별하는 데 사용하는 정규식. key_path 문자열이 이 정규식과 일치하면 전체 매개변수가 <redacted by datadog>로 대체돼요. 기본 키 정규식은 일반적인 비밀/키 이름(비밀번호, 토큰, authorization, jwt 등)과 일치하며, 빈 문자열은 키 정규식을 비활성화해요.

DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP

타입: string 매개변수 값과 하이라이트 내부의 민감한 하위 문자열을 찾아 편집하는 데 사용되는 정규식. 일치 항목은 <redacted by datadog>로 대체돼요. 이 정규식은 키 정규식을 보완해요: 키 정규식이 우선하고, 키 일치가 없으면 값 정규식이 실행돼요. 기본 패턴은 토큰, JWT, 개인 키 블록 및 기타 자격 증명 형태를 대상으로 해요. 빈 문자열은 값 정규식을 비활성화해요.

DD_APPSEC_RASP_ENABLED

타입: boolean 기본값: true 트레이서의 RASP / Exploit Prevention 기능을 켜요. 활성화하면 트레이서가 동기식 사전 실행 검사를 실행하고 차단 액션 또는 익스플로잇 신호를 생성할 수 있어요. RASP는 언어별로 별도의 활성화·구현 세부 사항이 있을 수 있어요. 활성화하면 일반적으로 추가 동기식 계측과 감지에 대한 추가 증거 캡처가 활성화돼요.

DD_APPSEC_RULES

타입: string 제공된 기본 규칙 파일을 재정의해요. 유효한 JSON 규칙 파일의 경로여야 해요.

DD_APPSEC_SCA_ENABLED

타입: boolean 트레이서의 런타임 SCA(Software Composition Analysis) 기능을 활성화해 런타임 의존성/SBOM 정보를 보고하고 런타임 취약점 감지를 지원해요. 테스트·데모와 프로덕션 런타임 취약점 워크플로우에 유용하며, SCA에는 SCA 런북에 설명된 청구/사용 영향과 언어 호환성 제약이 있을 수 있어요.

DD_APPSEC_STACK_TRACE_ENABLED

타입: boolean 기본값: true 별칭:DD_APPSEC_STACKTRACE_ENABLED 보안 이벤트 발생 시 보안 관련 스택 트레이스 생성을 활성화해요.

DD_APPSEC_TRACE_RATE_LIMIT

타입: int 기본값: 100 초당 AppSec 트레이스의 최대 수를 제어해요.

DD_APPSEC_WAF_TIMEOUT

타입: decimal WAF 동기식 실행 시간(마이크로초)을 제한해요.

DD_ERROR_TRACKING_HANDLED_ERRORS

타입: string Error Tracking이 사용자 코드, 타사 gem, 또는 둘 다의 처리된 오류를 보고하는지 제어해요.

DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE

타입: array Error Tracking이 처리된 오류를 보고해야 하는 경로, 파일 이름, 또는 gem 이름의 쉼표 구분 목록.

DD_IAST_DEDUPLICATION_ENABLED

타입: boolean 기본값: true 취약점 중복 감지를 활성화하거나 비활성화해요. 활성화하면 취약점은 앱 수명 동안 발생할 때마다가 아니라 한 번만 보고돼요. 기본값은 true(활성화)예요.

DD_IAST_ENABLED

타입: boolean 기본값: false IAST를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.

DD_IAST_MAX_CONCURRENT_REQUESTS

타입: int 기본값: 2 IAST가 동시에 분석하는 최대 요청 수. 기본값은 2예요.

DD_IAST_MAX_RANGE_COUNT

타입: int 기본값: 30 IAST: 오염된 객체/값당 저장되는 최대 오염 범위 수. 더 많은 범위가 생성되면 이 한도로 잘려요. DEFAULT 감지 모드에서만 사용되고, FULL 감지 모드에서는 무제한이에요. 기본값(DEFAULT 모드): 10.

DD_IAST_REDACTION_ENABLED

타입: boolean 기본값: true IAST의 민감 데이터 편집을 활성화하거나 비활성화해요. 기본값은 TracerSettings에 있어요.

DD_IAST_REDACTION_NAME_PATTERN

DD_IAST_REDACTION_VALUE_PATTERN

타입: string 기본값: (?i)bearer\s+[a-z0-9\._\-]+|token:[a-z0-9]{13}|password|gh[opsu]_[0-9a-zA-Z]{36}|ey[I-L][\w=-]+\.ey[I-L][\w=-]+(\.[\w.+\/=-]+)?|[\-]{5}BEGIN[a-z\s]+PRIVATE\sKEY[\-]{5}[^\-]+[\-]{5}END[a-z\s]+PRIVATE\sKEY|ssh-rsa\s*[a-z0-9\/\.+]{100,} IAST에서 소스 값을 난독화하는 사용자 지정 정규식 패턴. 기본값은 TracerSettings에 있어요.

DD_IAST_REQUEST_SAMPLING

타입: decimal 기본값: 30.0 IAST: 분석할 요청 샘플링 백분율(오버헤드 제어). IAST 오버헤드 컨트롤러가 어떤 요청을 분석할지 결정하는 데 사용돼요. 0 이하의 값은 100%로 처리돼요(IAST를 비활성화하지 않음). FULL 감지 모드에서는 샘플링이 100%로 강제돼요. 기본값(DEFAULT 모드): 33%.

DD_IAST_SECURITY_CONTROLS_CONFIGURATION

타입: string IAST: 세미콜론 구분 구성 문자열로 사용자 지정 보안 컨트롤(새니타이저/입력 검증기)을 구성해요. 설정하면 트레이서가 지정된 클래스/메서드를 계측하는 트랜스포머를 설치하여 IAST가 특정 취약점 유형에 대해 데이터를 검증됨/새니타이즈됨으로 표시할 수 있게 해요.

DD_IAST_STACK_TRACE_ENABLED

타입: boolean 기본값: true 별칭:DD_IAST_STACKTRACE_ENABLED IAST: 활성화(기본값)하면 사용자 코드 스택 트레이스를 캡처해 스택 ID를 통해 IAST 취약점 보고서에 부착해요. 취약한 코드가 어디서 실행되었는지 찾는 데 유용해요. 더 이상 사용되지 않는 별칭 DD_IAST_STACKTRACE_ENABLED도 받아들여요.

DD_IAST_TELEMETRY_VERBOSITY

타입: string 기본값: INFORMATION IAST: IAST 텔레메트리 상세도를 제어해요(OFF, MANDATORY, INFORMATION, DEBUG). 트레이서 텔레메트리가 비활성화되면 OFF로 강제돼요. 기본: INFORMATION.

DD_IAST_TRUNCATION_MAX_VALUE_LENGTH

타입: int 기본값: 250 기본값은 250이에요.

DD_IAST_VULNERABILITIES_PER_REQUEST

타입: int 기본값: 2 IAST: 요청당 보고할 수 있는 최대 취약점 수(할당량/오버헤드 제어). FULL 감지 모드에서는 이 한도가 제거되고, DEFAULT 감지 모드에서는 기본값이 2예요.

DD_IAST_WEAK_CIPHER_ALGORITHMS

타입: string IAST: 대문자화된 암호 알고리즘 id에 대해 매칭되는, 어떤 암호 알고리즘이 약한 것으로 간주되는지 정의하는 정규식. 사용된 암호 알고리즘이 이 패턴과 일치하면 IAST가 WEAK_CIPHER 취약점을 보고해요.

DD_IAST_WEAK_HASH_ALGORITHMS

타입: array 기본값: md5,sha1 보고할 약한 해싱 알고리즘을 제어해요.

폐기된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_APPSEC_AGENTIC_ONBOARDING

v4.12.3에서 제거됨. 타입: string 시작 버전: v4.13.0 Datadog의 에이전트형 온보딩 솔루션이 서비스에 App & API Protection을 구성할 때 자동으로 설정하는 정식 Datadog 환경 변수예요. 계측 텔레메트리를 통해 서비스가 에이전트형 플로우로 온보딩되었음을 Datadog이 기록할 수 있게 해 줘요.

Dynamic Instrumentation 및 디버깅

(11)

원격 디버깅 기능: 라이브 프로브용 Dynamic Instrumentation, 자동 변수 캡처용 Exception Replay, 소스 수준 디버깅용 Symbol Database, 스팬을 소스 코드에 연결하는 Code Origin for Spans.

DD_CODE_ORIGIN_FOR_SPANS_ENABLED

타입: boolean 기본값: true 트레이서에서 스팬용 코드 출처 동작을 활성화해요. 비활성화하면 관련 데이터 수집과 처리가 건너뛰어져요.

DD_DYNAMIC_INSTRUMENTATION_DIAGNOSTICS_INTERVAL

타입: int 기본값: 3600 프로브 진단/상태 메시지(수신됨/설치됨/발생 중/오류)가 다시 발행될 수 있는 간격(초).

DD_DYNAMIC_INSTRUMENTATION_ENABLED

타입: boolean 기본값: false Dynamic Instrumentation을 활성화해 재배포 없이 Datadog UI에서 실행 중인 서비스에 로그 프로브와 메트릭 프로브를 추가할 수 있게 해 줘요.

DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE

타입: string 로컬 프로브 정의 JSON 파일 경로. 설정하면 트레이서가 원격 구성에 구독하는 대신 시작 시 이 파일에서 프로브 정의를 로드해요.

DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS

타입: array 캡처된 스냅샷 데이터에서 편집할 추가 식별자 키워드의 쉼표 구분 목록.

DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES

타입: array 동적 로그와 스냅샷에서 편집할 객체 타입의 쉼표 구분 목록. * 와일드카드를 지원해요(예: Secret*는 SecretKey와 일치).

DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS

타입: array 편집에서 식별자를 제외하는 환경 변수.

DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS

타입: decimal 기본값: 1.0 프로브 데이터 업로드 사이의 간격(초).

DD_EXCEPTION_REPLAY_CAPTURE_MAX_FRAMES

타입: int 기본값: 8 Exception Replay에 대한 최대 캡처 프레임 수.

DD_EXCEPTION_REPLAY_ENABLED

타입: boolean 기본값: false Exception Replay(Live Debugging): Exception Replay 제품을 활성화해요. 활성화되면(예: Remote Config 사용) 트레이서가 Exception Replay 하위 시스템을 시작/중지해요. 이 키는 DD_EXCEPTION_DEBUGGING_ENABLED의 하위 호환 별칭으로도 받아들여져요.

DD_SYMBOL_DATABASE_UPLOAD_ENABLED

타입: boolean 기본값: true Symbol Database(SymDB): 심볼 정보 업로드(Live Debugging / Dynamic Instrumentation용)를 활성화해요. 기본: true.

폐기된 키 (Retired keys)

(3)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_CODE_COVERAGE_FLAGS

v4.12.3에서 제거됨. 타입: string 시작 버전: v4.13.0 테스트 최적화 라이브러리가 코드 커버리지 보고서를 자동 업로드하도록 구성된 경우 사용자는 DD_CODE_COVERAGE_FLAGS를 환경 변수로 전달해 코드 커버리지 보고서를 그룹화·필터링용으로 플래그할 수 있어요. DD_CODE_COVERAGE_FLAGS=type:unit-tests,jvm-21 같은 쉼표 구분 값을 사용하세요.

DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT_MS

v4.12.3에서 제거됨. 타입: int 기본값: 150 시작 버전: v4.13.0 별칭:DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT 스냅샷 수집 중 변수 값 캡처의 타임아웃(밀리초).

DD_DYNAMIC_INSTRUMENTATION_EVALUATION_TIMEOUT_MS

v4.12.3에서 제거됨. 타입: int 기본값: 50 시작 버전: v4.13.0 표현식(로그 조건, 로그 템플릿 값, 스팬 태그 값 또는 캡처 표현식)을 평가할 때 사용하는 타임아웃(밀리초).

CI 가시성 (CI Visibility)

(34)

CI Visibility 및 Test Optimization: 테스트 보고, 코드 커버리지 수집, Git 메타데이터, 플래키 테스트 관리, 테스트 건너뛰기, CI 공급자 통합.

DD_ACTION_EXECUTION_ID

타입: string AWS CodePipeline 빌드에 대한 CI 메타데이터로 보고되는 액션 실행 ID를 설정해요. 이 값은 CodePipeline이 시작한 CodeBuild 작업을 실행할 때 CI 작업 식별자로 사용돼요.

DD_CIVISIBILITY_AGENTLESS_ENABLED

타입: boolean 기본값: false CI Visibility의 에이전트리스 방식을 활성화해 로컬 Agent를 거치지 않고 테스트 데이터를 Datadog 인테이크로 직접 전송해요.

DD_CIVISIBILITY_AGENTLESS_URL

타입: string 에이전트리스 CI 테스트 보고에 사용되는 인테이크 기본 URL을 재정의해요. 설정하면 페이로드가 사이트 기반 기본 인테이크 URL 대신 이 URL로 전송돼요.

DD_CIVISIBILITY_AUTO_INSTRUMENTATION_PROVIDER

타입: string CI 테스트 세션을 자동 계측 워크플로우 아래에서 실행 중인 것으로 표시해요. 비어 있지 않은 값은 텔레메트리를 위해 이 마커를 활성화해요.

DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED

타입: boolean 기본값: true CI Visibility Early Flake Detection(EFD)을 활성화해, 선택된 테스트를 여러 번 일찍 실행해 플래키함을 감지할 수 있게 해요(백엔드 제공 실행 설정에 기반).

DD_CIVISIBILITY_ENABLED

타입: boolean 기본값: true CI Visibility를 활성화하거나 비활성화해요.

DD_CIVISIBILITY_FLAKY_RETRY_COUNT

타입: int 기본값: 5 테스트 케이스당 최대 재시도 횟수를 변경하려면 임의의 음이 아닌 숫자로 설정할 수 있어요.

DD_CIVISIBILITY_FLAKY_RETRY_ENABLED

타입: boolean 자동 테스트 재시도 기능의 킬 스위치.

DD_CIVISIBILITY_ITR_ENABLED

타입: boolean 기본값: true CI Visibility에서 Intelligent Test Runner를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.

DD_CIVISIBILITY_LOG_LEVEL

타입: string 기본값: info 테스트 러너 통합(예: pytest, unittest)이 설치한 CI Visibility 로거 핸들러가 사용하는 로그 수준을 설정해요. 표준 Python 로깅 수준(debug, info, warning, error, critical)과, CI Visibility 로거 인수를 완전히 비활성화하는 특수 값 none을 받아요. 기본값은 info. 디버그 모드가 활성화되면 무시돼요.

DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS

타입: int 기본값: 500 CI Visibility(Selenium): 브라우저 테스트가 끝날 때 window.DD_RUM.stopSession()을 호출한 후 RUM 데이터가 플러시되도록 이 밀리초만큼 기다린 후 진행해요(기본: 500ms).

DD_CIVISIBILITY_TOTAL_FLAKY_RETRY_COUNT

타입: int 기본값: 1000 전체 CI 테스트 세션에서 허용되는 자동 테스트 재시도의 최대 총 횟수로, 자동 플래키 테스트 재시도가 활성화될 때 적용돼요.

DD_CIVISIBILITY_USE_BETA_WRITER

타입: boolean 기본값: false 활성화하면 CI Visibility가 베타 라이터 파이프라인을 사용해요: 자체 컨텍스트 공급자가 있는 전용 CI Visibility 트레이서를 만들고 전역 트레이서에 스팬 포워더를 부착해 테스트 스팬이 베타 경로를 통해 라우팅되게 해요. 비활성화하면 표준 CI Visibility 라이터와 전역 트레이서가 사용돼요.

DD_CUSTOM_TRACE_ID

타입: string Jenkins Datadog 플러그인이 전파하는 커스텀 트레이스 ID로, Jenkins 파이프라인 실행과 테스트 중인 애플리케이션이 내보낸 트레이스를 상관시키는 데 사용돼요.

DD_GIT_BRANCH

타입: string CI Visibility가 저장소 및 커밋 상관관계에 사용하는 Git 브랜치 값을 재정의해요.

DD_GIT_COMMIT_AUTHOR_DATE

타입: string CI 메타데이터로 보고되는 커밋 작성자 날짜를 ISO 8601 형식으로 재정의해요.

DD_GIT_COMMIT_AUTHOR_EMAIL

타입: string CI 메타데이터로 보고되는 Git 커밋 작성자 이메일을 재정의해요.

DD_GIT_COMMIT_AUTHOR_NAME

타입: string CI 메타데이터로 보고되는 Git 커밋 작성자 이름을 재정의해요.

DD_GIT_COMMIT_COMMITTER_DATE

타입: string CI 메타데이터로 보고되는 커밋 커미터 날짜를 ISO 8601 형식으로 재정의해요.

DD_GIT_COMMIT_COMMITTER_EMAIL

타입: string CI 메타데이터로 보고되는 Git 커밋 커미터 이메일을 재정의해요.

DD_GIT_COMMIT_COMMITTER_NAME

타입: string CI 메타데이터로 보고되는 Git 커밋 커미터 이름을 재정의해요.

DD_GIT_COMMIT_MESSAGE

타입: string CI 메타데이터로 보고되는 Git 커밋 메시지를 재정의해요.

DD_GIT_PULL_REQUEST_BASE_BRANCH

타입: string CI Visibility: pull request 기본/대상 브랜치 이름을 설정해 사용자 제공 Git 메타데이터가 필요할 때 pull request 정보와 CI Git 태그(예: git.pull_request.base_branch)를 채우는 데 사용해요.

DD_GIT_PULL_REQUEST_BASE_BRANCH_SHA

타입: string CI 기능의 Git 메타데이터로 보고되는 pull request 기본 커밋 SHA를 재정의해요. 자동 감지가 불가능할 때 기본 커밋을 설정하는 데 사용하세요.

DD_GIT_REPOSITORY_URL

타입: string CI 메타데이터로 보고되고 활성화 시 Git 메타데이터 태깅에 사용되는 Git 저장소 URL을 재정의해요. URL에 포함된 자격 증명은 사용 전에 제거돼요.

DD_GIT_TAG

타입: string CI Visibility가 저장소 및 릴리스 상관관계에 사용하는 Git 태그를 재정의해요.

DD_PIPELINE_EXECUTION_ID

타입: string AWS CodePipeline 빌드에 대한 CI 메타데이터로 보고되는 파이프라인 실행 ID를 설정해요. 이 값은 CodePipeline이 시작한 CodeBuild 작업을 실행할 때 CI 파이프라인 식별자로 사용돼요.

DD_TEST_DEBUG

타입: boolean 활성화하면 Datadog 테스트 최적화 로거(ddtrace.testing)를 DEBUG 수준으로 설정해 테스트 실행 중 자세한 진단 출력이 발생하도록 해요. 설정되지 않았거나(참이 아닌 값)이면 로거는 INFO 수준을 사용해요. DD_TRACE_DEBUG도 이 디버그 출력을 활성화해요.

DD_TEST_MANAGEMENT_ATTEMPT_TO_FIX_RETRIES

타입: int "attempt to fix"로 표시된 테스트의 재시도 실행 횟수를 재정의해요. 설정하지 않으면 백엔드/원격 설정의 값이 사용돼요.

DD_TEST_MANAGEMENT_ENABLED

타입: boolean Test Management 기능을 활성화하거나 비활성화해요.

DD_TEST_OPTIMIZATION_ENV_DATA_FILE

타입: string 테스트 보고에 사용되는 CI/환경 메타데이터가 포함된 JSON 파일의 경로를 설정해요. 설정하지 않으면 테스트 바이너리 옆의 기본 파일이 사용돼요.

DD_TEST_SESSION_NAME

타입: string CI Visibility에 보고되는 자동 생성 테스트 세션 이름을 재정의해요. 설정하지 않으면 트레이서는 감지된 CI 공급자, 저장소, 브랜치 정보에서 이름을 만들어요.

DD_TEST_VISIBILITY_SERVICE

타입: string 별칭:DD_TEST_VISIBILITY_SERVICE_NAME test_visibility 통합이 보고하는 서비스 이름을 설정해요. 설정하지 않으면 통합은 DD_TEST_VISIBILITY_SERVICE_NAME으로, 그다음 기본 서비스 이름 "default_test_visibility_service"으로 대체돼요.

DD_TRACE_GIT_METADATA_ENABLED

타입: boolean 기본값: true 활성화하면 트레이서가 Git 저장소 URL과 커밋 SHA 태그를 루트 스팬에 부착해 트레이스를 Datadog UI의 해당 소스 코드에 연결할 수 있게 해 줘요.

폐기된 키 (Retired keys)

(2)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_CIVISIBILITY_DYNAMIC_ATR_BUCKETS

v4.13.3에서 제거됨. 타입: array 시작 버전: v4.15.0 Auto Test Retries의 동적 재시도 버킷을 사용자 지정해요(고정 대신 기간에 기반한 재시도 횟수).

5초보다 빠른, 5초, 10초, 30초, 5분보다 느린 테스트에 대한 5개 값의 쉼표 구분 정수 목록.

DD_CIVISIBILITY_DYNAMIC_ATR_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: `v4.15.0** Auto Test Retries의 동적 재시도를 활성화해요(고정 대신 기간에 기반한 재시도 횟수).

크래시 추적 및 진단 (Crash Tracking & Diagnostics)

(8)

애플리케이션 크래시를 캡처·보고하기 위한 크래시 추적과 힙 스냅샷 구성.

DD_CRASHTRACKING_COLLECT_ALL_THREADS

타입: boolean 기본값: true

크래시가 처리될 때 모든 스레드에서 스택 트레이스를 수집할지 여부.

DD_CRASHTRACKING_CREATE_ALT_STACK

타입: boolean 기본값: true 활성화하면 크래시 트래커가 크래시 중 치명적 신호를 처리하는 데 사용되는 자체 대체 신호 스택을 할당해요. Python 런타임은 기본적으로 매우 작은 대체 스택을 할당하므로, 보통 DD_CRASHTRACKING_USE_ALT_STACK과 함께 사용해 크래시 핸들러가 안정적으로 실행되기에 충분히 큰 대체 스택을 보장해요.

DD_CRASHTRACKING_DEBUG_URL

타입: string 크래시 트래커가 크래시 보고서를 보내는 대상 URL을 재정의해요. 설정하지 않으면 크래시 트래커는 트레이서에 구성된 트레이스 Agent URL로 보고서를 보내요. 크래시 보고서를 대체 엔드포인트로 리디렉션해야 하는 개발·디버깅 시나리오를 위한 것이에요.

DD_CRASHTRACKING_ENABLED

타입: boolean 기본값: true Crash Tracking을 활성화해요. 활성화하면 트레이서가 크래시 추적을 초기화하고 hs_err_pid*.log 크래시 로그와 OOME 알림을 업로드하는 Datadog 제공 스크립트를 실행하도록 JVM 크래시/OOM 훅(예: -XX:OnError, -XX:OnOutOfMemoryError)을 구성해요. 기본값: true.

DD_CRASHTRACKING_MAX_THREADS

타입: int 기본값: 128 collect_all_threads가 활성화될 때 스택 트레이스를 수집할 최대 스레드 수.

DD_CRASHTRACKING_STDERR_FILENAME

타입: string 크래시 트래커가 크래시 중 캡처된 표준 오류 출력을 리디렉션하는 대상 파일 이름을 설정해요. 설정하지 않으면 크래시 추적기 stderr는 파일로 리디렉션되지 않아요.

DD_CRASHTRACKING_STDOUT_FILENAME

타입: string 크래시 트래커 수신 프로세스가 표준 출력을 쓰는 대상 파일 이름을 설정해요. 설정하지 않으면 수신기의 stdout은 파일로 리디렉션되지 않아요.

DD_CRASHTRACKING_USE_ALT_STACK

타입: boolean 기본값: true 크래시 트래커가 대체 스택에 신호 핸들러를 설치해 주 스레드 스택이 고갈되거나 손상되었을 때도 크래시 보고서를 캡처할 수 있는지 제어해요. 설정하지 않으면 true를 기본값으로 해요. Python 런타임이 기본적으로 매우 작은 대체 스택을 할당하므로 보통 DD_CRASHTRACKING_CREATE_ALT_STACK과 함께 사용돼요.

로그 제출 및 상관관계 (Log Submission & Correlation)

(3)

Datadog로 직접 로그 제출, 에이전트 없는 로그 전달, 트레이스-로그 상관관계를 위한 로그 주입, OpenTelemetry 로그 내보내기.

DD_AGENTLESS_LOG_SUBMISSION_ENABLED

타입: boolean 기본값: false Datadog Agent를 통해 라우팅하지 않고 Datadog에 직접 로그 제출을 활성화해요.

DD_LOGS_INJECTION

타입: boolean 기본값: true 애플리케이션 로그에 상관관계 식별자(트레이스 ID, 스팬 ID)의 자동 주입을 활성화하거나 비활성화해요.

언어별 참고:

.NET: 로거에는 trace_id 매핑을 올바르게 설정하는 source가 필요해요. .NET 애플리케이션의 기본 소스인 csharp은 이를 자동으로 수행해요.

DD_LOGS_OTEL_ENABLED

타입: boolean 기본값: false OpenTelemetry Logs API를 통해 생성된 로그의 수집과 내보내기를 활성화해요.

폐기된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_AGENTLESS_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: `v4.15.0** 존재한다면 제품별 에이전트리스 설정의 기본값을 제공해요. 켜려면 DD_API_KEY와 DD_SITE 구성을 제공해야 해요. 그러면 트레이서가 모든 데이터를 백엔드로 직접 보내요. 참고: Profiling은 아직 에이전트리스 제출에 사용할 수 없으며 항상 Datadog Agent를 통한 전송으로 대체돼요.

런타임 메트릭 (Runtime Metrics)

(4)

런타임 메트릭 수집과 메트릭 제출을 위한 DogStatsD 연결 구성.

DD_DOGSTATSD_HOST

타입: string 기본 트레이서가 DogStatsD 메트릭을 제출하려 시도하는 트레이스 Agent 호스트 주소를 재정의해요. DD_DOGSTATSD_HOST를 재정의하려면 DD_AGENT_HOST를 사용하세요.

DD_DOGSTATSD_PORT

타입: int 기본값: 8125 메트릭이 제출되는 DogStatsD Agent의 포트. Agent 구성에서 dogstatsd_port나 DD_DOGSTATSD_PORT를 기본값 8125이 아닌 값으로 설정했다면 이 트레이싱 라이브러리의 DD_DOGSTATSD_PORT가 그 값과 일치해야 해요.

DD_DOGSTATSD_URL

타입: string 기본값: http://localhost:8125 DogStatsD 엔드포인트에 연결하는 데 사용되는 URL. DD_AGENT_HOST와 DD_DOGSTATSD_PORT보다 우선해요. udp:// 또는 unix:// 스킴만 지원해요.

DD_RUNTIME_METRICS_ENABLED

타입: boolean 기본값: false 애플리케이션의 런타임 메트릭(가비지 컬렉션 통계, 메모리 사용량, 스레드 수 등) 수집을 활성화하거나 비활성화해요.

Data Streams Monitoring

(1)

메시지 큐와 스트리밍 파이프라인 전반의 종단 간 지연을 추적하기 위한 Data Streams Monitoring.

DD_DATA_STREAMS_ENABLED

타입: boolean 기본값: false Data Streams Monitoring(DSM)과 그 체크포인트 전파를 활성화해요. 활성화하면 트레이서가 DSM 프로파게이터를 등록하고 경로 통계와 페이로드를 보고해요.

계측 텔레메트리 (Instrumentation Telemetry)

(6)

트레이서 자체 보고 텔레메트리: 하트비트 간격, 의존성·로그 수집, 텔레메트리 전달자 구성.

DD_INSTRUMENTATION_TELEMETRY_ENABLED

타입: boolean 기본값: true Datadog가 제품을 개선하기 위해 애플리케이션과 런타임에 대한 환경·진단 정보를 수집할 수 있게 해 줘요. 계측 텔레메트리에서 제외하려면 false로 설정하세요.

DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED

타입: boolean 기본값: true 런타임 시 애플리케이션 의존성을 감지해 Datadog에 보고하는 계측 텔레메트리 의존성 수집기를 활성화해요.

DD_TELEMETRY_HOST

타입: string dogstatsd 클라이언트 자체 텔레메트리 통계를 받는 DogStatsd 서버의 호스트를 설정해요. 설정하지 않으면 텔레메트리 통계는 일반 메트릭과 동일한 호스트(구성된 DogStatsd 서버)로 보내져요.

DD_TELEMETRY_LOG_COLLECTION_ENABLED

타입: boolean 기본값: true 내부 트레이서 로그가 계측 텔레메트리의 일부로 전달되는지 제어해요.

DD_TELEMETRY_METRICS_ENABLED

타입: boolean 기본값: true 계측 텔레메트리가 내부 메트릭을 보내는지 제어해요.

DD_TELEMETRY_PORT

타입: int 번들 DogStatsd 클라이언트가 자체 클라이언트 텔레메트리 통계를 제출하는 데 사용하는 DogStatsd 서버의 포트를 설정해요. 설정하지 않으면 클라이언트는 기본 DogStatsd 포트(DD_DOGSTATSD_PORT 또는 구성된 port)로 대체돼요.

원격 구성 (Remote Configuration)

(1)

Datadog에서 라이브 구성 업데이트를 받기 위한 원격 구성.

DD_REMOTE_CONFIGURATION_ENABLED

타입: boolean 기본값: true 별칭:DD_REMOTE_CONFIG_ENABLED 원격 구성을 활성화하거나 비활성화해요.

OpenTelemetry 호환성 (OpenTelemetry Compatibility)

(31)

Datadog SDK가 지원하는 표준 OpenTelemetry 환경 변수: 리소스 속성, 프로파게이터, 트레이스 샘플러, OTLP exporter 구성, 배치 스팬 프로세서 설정.

DD_METRICS_OTEL_ENABLED

타입: boolean 기본값: false OpenTelemetry 메트릭 내보내기를 활성화해요. 메트릭은 기본적으로 비활성화되어 있으며 참값으로 설정된 경우에만 활성화돼요.

DD_TRACE_OTEL_ENABLED

타입: boolean 기본값: false 트레이스에 대한 Datadog SDK의 OpenTelemetry 상호운용성을 활성화해요.

OTEL_EXPORTER_OTLP_ENDPOINT

타입: string 재정의되지 않는 한 모든 신호에 대해 OTLP 데이터를 보내기 위한 기본 URL을 지정해요. 기본값(gRPC): http://localhost:4317. 기본값(HTTP): http://localhost:4318.

OTEL_EXPORTER_OTLP_HEADERS

타입: string 설명: 모든 나가는 OTLP 요청(예: api-key=key,other-config=value)에 대한 헤더로 사용할 키-값 쌍의 쉼표 구분 목록을 지정해요.

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

타입: string 별칭:OTEL_EXPORTER_OTLP_ENDPOINT OTLP 로그를 보내는 URL. OTEL_EXPORTER_OTLP_ENDPOINT보다 우선해요. gRPC의 경우 http://localhost:4317, HTTP의 경우 http://localhost:4318/v1/logs를 기본값으로 해요.

OTEL_EXPORTER_OTLP_LOGS_HEADERS

타입: string 별칭:OTEL_EXPORTER_OTLP_HEADERS 나가는 OTLP 로그 요청의 헤더로 사용할 키-값 쌍의 쉼표 구분 목록을 지정해요. 일반 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

타입: string 기본값: grpc 별칭:OTEL_EXPORTER_OTLP_PROTOCOL 로그 데이터에 사용할 OTLP 전송 프로토콜을 지정해요.

OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

타입: int 기본값: 10000 별칭:OTEL_EXPORTER_OTLP_TIMEOUT 단일 나가는 OTLP 로그 요청의 타임아웃(밀리초)을 지정해요. 일반 OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

타입: string 별칭:OTEL_EXPORTER_OTLP_ENDPOINT 비어 있지 않으면 OTLP 메트릭 엔드포인트로 사용돼요. 그 외에는 OTEL_EXPORTER_OTLP_ENDPOINT로, 프로토콜에 따라 http://<DD_TRACE_AGENT_URL host>:4317/4318로 대체돼요. http/protobuf의 경우 누락되면 /v1/metrics가 추가돼요.

OTEL_EXPORTER_OTLP_METRICS_HEADERS

타입: string 별칭:OTEL_EXPORTER_OTLP_HEADERS 메트릭에 대해 OTLP exporter 요청에 포함할 추가 헤더를 설정해요. 설정하면 메트릭 내보내기에 대해 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

타입: string 메트릭 데이터에 사용할 OTLP 전송 프로토콜을 지정해요. 일반 OTEL_EXPORTER_OTLP_PROTOCOL보다 우선해요. 허용 값: grpc, http/protobuf, http/json.

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE

타입: string 설명: 각 계측 종류에 사용할 집계 temporality를 지정해요. 참고: 이 기본값 delta는 Datadog의 권장 구성이며 OpenTelemetry 사양의 기본값과 달라요.

OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

타입: int OTLP 메트릭 요청의 exporter 네트워크 타임아웃(ms)으로 사용돼요. 0으로 설정하면 라이브러리가 OTEL_EXPORTER_OTLP_TIMEOUT으로 대체돼요.

OTEL_EXPORTER_OTLP_PROTOCOL

타입: string 설명: 재정의되지 않는 한 모든 신호에 사용할 전송 프로토콜을 지정해요.

OTEL_EXPORTER_OTLP_TIMEOUT

타입: int 기본값: 10000 OTLP 내보내기 요청의 기본 타임아웃(밀리초). 신호별 타임아웃이 설정되지 않았을 때 대체값으로 사용돼요.

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

타입: string 별칭:OTEL_EXPORTER_OTLP_ENDPOINT OTLP 트레이스 제출용 엔드포인트 URL을 구성하며, 대체 구성 OTEL_EXPORTER_OTLP_ENDPOINT보다 우선해요. OTEL_EXPORTER_OTLP_ENDPOINT 값을 사용하면 신호 무관 엔드포인트로 간주되고 http/protobuf 및 http/json 프로토콜에 대해 트레이스 엔드포인트 URL을 구성할 때 /v1/traces 하위 경로를 추가해야 해요.

기본값:

gRPC: "http://localhost:4317"
HTTP: "http://localhost:4318/v1/traces"

OTEL_EXPORTER_OTLP_TRACES_HEADERS

타입: string OTLP 메트릭 내보내기용 사용자 지정 헤더를 설정하는 구성 키. 일반 OTLP 헤더보다 우선해요. 형식: api-key=key,other=value.

OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

타입: string 메트릭 내보내기용 OTLP 프로토콜을 설정하는 구성 키. 일반 OTLP 프로토콜 설정보다 우선해요. 유효한 값: grpc, http/protobuf, http/json.

OTEL_EXPORTER_OTLP_TRACES_TIMEOUT

타입: int 기본값: 10000 OTLP 메트릭 내보내기의 요청 타임아웃을 밀리초 단위로 설정하는 구성 키. 일반 OTLP 타임아웃 설정보다 우선해요.

OTEL_LOG_LEVEL

타입: string 로그 수준을 설정하는 구성 키예요.

OTEL_LOGS_EXPORTER

타입: string OpenTelemetry 로그 exporter 선택을 제어해요. 이 설정은 지원되지 않으며 무시돼요.

OTEL_METRIC_EXPORT_INTERVAL

타입: int 기본값: 10000 메트릭 내보내기 시도 사이의 간격(밀리초). 기본값 10000(10초)은 Datadog의 권장 값이며 OpenTelemetry 사양 기본값 60000ms와 다르다는 점을 참고하세요.

OTEL_METRIC_EXPORT_TIMEOUT

타입: int 기본값: 7500 단일 메트릭 배치를 수집·내보내는 데 허용되는 최대 시간(밀리초). 기본값 7500(7.5초)은 Datadog의 권장 값이며 OpenTelemetry 사양 기본값 30000ms와 다르다는 점을 참고하세요.

OTEL_METRICS_EXPORTER

타입: string 기본값: otlp OpenTelemetry 메트릭 exporter를 지정해요. 허용 값은 otlp와 none뿐이에요. none으로 설정하면 OTel 메트릭 방출과 APM 런타임 메트릭을 모두 비활성화해요(DD_RUNTIME_METRICS_ENABLED=false와 동일).

OTEL_PROPAGATORS

타입: array 트레이스 컨텍스트 추출·주입에 사용되는 프로파게이터를 구성해요.

OTEL_RESOURCE_ATTRIBUTES

타입: map OpenTelemetry 리소스 속성을 (key, value) 쌍 목록으로 설정해요. 참고: 퍼센트 인코딩된 쉼표와 등호 구분자는 그대로 리터럴로 유지돼요.

OTEL_SDK_DISABLED

타입: string 모든 신호에 대한 Datadog SDK의 OpenTelemetry 상호운용성을 비활성화해요. 참고: true로 설정하면 이는 DD_TRACE_OTEL_ENABLED=false, DD_LOGS_OTEL_ENABLED=false, DD_METRICS_OTEL_ENABLED=false를 효과적으로 설정해요. Ruby 및 Go SDK: OpenTelemetry SDK는 가져오기·구성 시 자동으로 활성화되므로 이 설정은 적용되지 않아요.

OTEL_SERVICE_NAME

타입: string 애플리케이션의 기본 서비스 이름을 설정해요. DD_SERVICE가 설정되지 않았을 때 DD_SERVICE의 별칭.

OTEL_TRACES_EXPORTER

타입: string 트레이스용 exporter를 설정하는 구성 키. none 값만 인식되며, 이는 트레이스 내보내기를 비활성화로 설정하는 것과 동일해요.

OTEL_TRACES_SAMPLER

타입: string OpenTelemetry 구성을 통해 트레이스 샘플러를 설정하고, 해당 설정이 설정되지 않았을 때 트레이서의 샘플 비율에 매핑해요. 부모 기반 샘플러가 지원되고, 지원되지 않는 값은 무시돼요.

OTEL_TRACES_SAMPLER_ARG

타입: string OpenTelemetry 트레이스 샘플러 인자(otel.traces.sampler.arg / OTEL_TRACES_SAMPLER_ARG): OTEL_TRACES_SAMPLER=parentbased_traceidratio일 때 사용되며, 값은 traceidratio 샘플 비율로 처리되어 Datadog의 트레이스 샘플 비율에 매핑돼요. 기본값: 미설정.

AI 및 LLM Observability

(16)

AI 관찰 기능: AI Guard 콘텐츠 스캔, LLM Observability, 공급자별 통합 설정.

DD_AI_GUARD_BLOCK

타입: boolean 기본값: true 자동 계측된 패키지 내부에서 AI Guard를 사용해 프롬프트를 평가할 때 차단 동작을 제어해요.

DD_AI_GUARD_ENABLED

타입: boolean 기본값: false 트레이서에서 AI Guard 요청 검사를 활성화해요. 비활성화하면 AI Guard 검사가 건너뛰어져요.

DD_AI_GUARD_ENDPOINT

타입: string AI Guard: AI Guard REST API의 기본 엔드포인트 URL을 설정해요. 설정하지 않으면 https://app.<DD_SITE>/api/v2/ai-guard를 기본값으로 해요(트레이서가 /evaluate를 추가해요).

DD_AI_GUARD_MAX_CONTENT_SIZE

타입: int 기본값: 524288 메타 구조에 설정되는 content 속성의 최대 크기.

DD_AI_GUARD_MAX_MESSAGES_LENGTH

타입: int 기본값: 16 메타 구조에 설정할 수 있는 대화 메시지의 최대 수.

DD_AI_GUARD_TIMEOUT

타입: int 기본값: 10000 AI Guard REST API 호출에 사용되는 타임아웃(밀리초, 기본 5000).

DD_LLMOBS_AGENTLESS_ENABLED

타입: boolean Datadog Agent가 필요한 데이터 전송을 비활성화하려면 true로 설정하세요.

DD_LLMOBS_ENABLED

타입: boolean 기본값: false LLM Observability에 데이터를 제출할 수 있게 하는 토글.

DD_LLMOBS_EVALUATOR_SAMPLING_RULES

타입: string LLM Observability 평가자(evaluator)에 대한 샘플링 규칙을 구성해요. JSON 인코딩된 규칙 객체 목록을 받으며, 각 객체는 sample_rate(0.0~1.0 사이 float)가 필요하고 선택적으로 규칙 범위를 정하려면 evaluator_label 및/또는 span_name이 필요해요. 설정하지 않으면 모든 평가자 실행이 샘플링돼요(필터링 없음). 잘못된 JSON이나 sample_rate가 없는 규칙은 건너뛰고 텔레메트리로 보고돼요.

DD_LLMOBS_INSTRUMENTED_PROXY_URLS

타입: string 이미 LLM Observability 스팬을 발산하는 LLM 프록시를 가리키는 기본 URL의 쉼표 구분 목록. 나가는 LLM 호출의 기본 URL이 이 항목 중 하나와 일치하면 로컬 LLM 통합은 중복 LLM Observability 스팬 생성을 건너뛰어 프록시가 발산한 스팬이 사실의 원천으로 보존돼요. 기본적으로 설정되지 않아, 어떤 프록시 URL도 사전 계측된 것으로 취급되지 않아요.

DD_LLMOBS_ML_APP

타입: string LLM Observability 데이터에 사용되는 기본 ML 앱 이름을 설정해요. LLM Observability가 활성화될 때 이 값이 필요해요.

DD_LLMOBS_OVERRIDE_ORIGIN

타입: string 에이전트리스 모드에서 스팬과 평가 메트릭 페이로드를 보낼 때, 그리고 Prompt Registry에서 프롬프트를 가져올 때 LLM Observability가 사용하는 기본 URL을 재정의해요. 설정하지 않으면 에이전트리스 라이터는 https://llmobs-intake.<site>로 보내고(에이전트리스 모드가 아니면 Datadog Agent를 통해 프록시), Prompt Registry는 https://api.<site>를 사용하며, 여기서 <site>는 DD_SITE에서 나와요. 전체 출처(스킴 + 호스트, 선택적으로 포트)로 설정하면 트래픽을 사용자 지정 엔드포인트로 리디렉션하며, 일반적으로 테스트나 프록시용이에요.

DD_LLMOBS_PAYLOAD_SIZE_BYTES

타입: int 기본값: 5242880 라이터가 배치를 인테이크로 플러시하기 전 버퍼링된 LLM Observability 이벤트의 최대 크기(바이트). 다음 이벤트를 추가하면 이 임계값을 초과할 경우 현재 버퍼가 즉시 전송돼요. 기본값은 5242880(5MiB)으로, EVP 인테이크 페이로드 한도와 일치해요.

DD_LLMOBS_PROJECT_NAME

타입: string 이 구성은 사용할 기본 LLM Observability 프로젝트를 구성할 수 있게 해 줘요. Experiments and Datasets 기능을 사용할 때 필요해요.

DD_LLMOBS_PROMPTS_CACHE_DIR

타입: string LLM Observability가 Prompt Registry를 뒷받침하는 파일 기반("warm") 프롬프트 캐시를 유지하는 데 사용하는 디렉터리를 설정해요. 캐시된 프롬프트 항목은 파일 캐싱이 활성화되었을 때 프로세스 재시작 후에도 유지되도록 이 위치에 기록돼요. 설정하지 않으면 캐시는 ~/.cache/datadog/llmobs/prompts 아래에 저장되고, 홈 디렉터리가 없으면 임시 디렉터리로 대체돼요. ~로 시작하는 경로는 확장돼요.

DD_LLMOBS_SAMPLE_RATE

타입: decimal 기본값: 1.0 내장 LLM 통합(OpenAI, Anthropic, Bedrock 등)이 발산하는 LLM Observability 페이로드에 적용되는 샘플링 비율을 제어해요. 0.0(모두 버림)과 1.0(모두 보냄) 사이의 float를 받아요. 설정하지 않으면 모든 적격 LLM 스팬이 샘플링돼요.

폐기된 키 (Retired keys)

(5)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_AI_GUARD_ANALYZE_STREAM_RESPONSES_ENABLED

v4.11.4에서 제거됨. 타입: boolean 기본값: false 시작 버전: v4.12.0 모델 스트리밍 응답이 도착할 때 호출자에게 전달돼요.

DD_AI_GUARD_ANTHROPIC_ENABLED

v4.12.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: `v4.13.0** Anthropic SDK에 대한 AI Guard 자동 계측을 활성화해요. 활성화하면 AI Guard도 활성화된 경우 Anthropic 호출이 AI Guard에 의해 평가돼요. 다른 지원 공급자에 영향을 주지 않고 Anthropic에 대해서만 AI Guard 계측을 비활성화하려면 false로 설정하세요.

DD_AI_GUARD_LANGCHAIN_ENABLED

v4.12.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: `v4.13.0** LangChain에 대한 AI Guard 자동 계측을 활성화해요. 활성화하면 AI Guard도 활성화된 경우 LangChain 호출이 AI Guard에 의해 평가돼요. 다른 지원 공급자에 영향을 주지 않고 LangChain에 대해서만 AI Guard 계측을 비활성화하려면 false로 설정하세요.

DD_AI_GUARD_OPENAI_ENABLED

v4.11.4에서 제거됨. 타입: boolean 기본값: true 시작 버전: `v4.12.0** OpenAI SDK에 대한 AI Guard 자동 계측을 활성화해요. true로 설정되고 AI Guard가 활성화되면 OpenAI 호출이 AI Guard에 의해 평가돼요. 다른 공급자에 영향을 주거나 트레이서 버전 롤백을 요구하지 않고 OpenAI에 대해서만 AI Guard 계측을 비활성화하려면 false로 설정하세요.

DD_AI_GUARD_REDACTION_ENABLED

v4.13.3에서 제거됨. 타입: boolean 기본값: true 시작 버전: v4.14.0** AI Guard 민감 데이터 편집을 활성화해요. 활성화(기본값)하면 AI Guard가 프롬프트와 응답을 전달하거나, meta-struct에 쓰거나, LLMObs에 보고하기 전에 백엔드에서 반환된 편집을 적용해요. 비활성화하면 평가는 계속 실행되고 민감 데이터 발견(sds_findings)은 여전히 보고되지만, 백엔드가 redaction_replacements`를 반환해도 편집이 적용되지 않아요. 이는 AI Guard 편집의 전역 킬 스위치 역할을 해요.

계측 및 플랫폼 (Instrumentation & Platform)

(4)

계측 설정과 플랫폼별 구성: 자동 주입, 타사 라이브러리 감지, 플랫폼 어댑터.

DD_INJECT_FORCE

타입: boolean 기본값: false Single Step Instrumentation(SSI): 여러 JVM 에이전트가 감지되어도 트레이서 javaagent가 로드되도록 강제해요. 다중 에이전트 실행을 피하기 위해 시작을 중단하는 SSI 가드레일을 우회해요. DD_INJECT_FORCE 또는 시스템 속성 dd.inject.force로 설정할 수 있어요. 기본값: false.

DD_INSTRUMENTATION_CONFIG_ID

타입: string 원격 구성 상관관계를 위해 텔레메트리에 부착되는 내부 계측 구성 식별자.

DD_THIRD_PARTY_DETECTION_EXCLUDES

타입: array 기본값: [] DD_THIRD_PARTY_EXCLUDES의 별칭. Live Debugging / Exception Replay: 일급 자사(first-party)로 취급할 패키지 접두사(타사 라이브러리 필터에서 제외). 이 허용 목록은 기본 타사 라이브러리 목록을 재정의해요.

DD_THIRD_PARTY_DETECTION_INCLUDES

타입: array 기본값: [] 타사 감지에 포함할 라이브러리의 쉼표 구분 목록. 기본값은 비어 있음.

기타 (Miscellaneous)

(2)

아직 다른 범주에 맞지 않는 구성 키. 이 목록을 백로그로 취급하세요: 각 키는 결국 실제 위치를 찾아야 해요.

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED

타입: boolean 기본값: false 원격 구성에서 플래그를 평가하는 실험적 기능 플래그 공급자를 활성화해요. 활성화하지 않으면 이 공급자는 no-op이며 기본값을 반환해요.

DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS

타입: int 기본값: 10000 OpenFeature 공급자 초기화의 타임아웃(밀리초). 이 시간 내에 구성이 수신되지 않으면 초기화가 실패해요. DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS 환경 변수로 구성할 수 있어요.

폐기된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 더 오래된 버전을 실행 중이라면 참고로 나열한 것이에요.

DD_EXPERIMENTAL_FLAGGING_PROVIDER_SPAN_ENRICHMENT_ENABLED

v4.12.3에서 제거됨. 타입: boolean 기본값: false 시작 버전: `v4.13.0** 기능 플래그 데이터로 스팬 보강을 활성화할지 여부. 활성화되고 기능 플래그가 평가되면 기능 플래그 평가와 트레이스 간의 상관관계를 위해 관련 메타데이터가 루트 APM 스팬에 부착돼요.