Node.js SDK 구성 (Configuring the Node.js SDK)
코드로 SDK를 설정하고 Agent가 APM 데이터를 수집하도록 구성한 뒤, 필요에 따라 SDK를 원하는 대로 구성할 수 있어요. Unified Service Tagging 설정을 포함한 구성 가이드를 안내합니다. 서비스의 런타임 구성을 확인하려면 Datadog의 APM Service Page에서 Service Config → SDK Configuration 탭을 선택해 현재 구성을 확인할 수 있어요.
env, service, version 값은 DD_ENV, DD_SERVICE, DD_VERSION 환경 변수로 설정하는 것을 권장해요. 환경 변수 구성 권장 사항은 Unified Service Tagging 문서를 참고하세요. 라이브러리 사용법에 대한 더 많은 예시는 API 문서에서 확인할 수 있어요.
출처: 문서
본문
구성 키 (Configuration keys)
이 라이브러리에 사용할 수 있는 구성 키는 467개예요.
일반 설정 (General Settings)
(16)
최상위 Datadog 구성: API 키, 서비스 식별, Agent 연결, intake 사이트, 호스트 이름, 전역 태그, 프록시 설정.
DD_AGENT_HOST
Type: string Default: 127.0.0.1 Since: v5.88.0 Aliases:DD_TRACE_AGENT_HOSTNAME
트레이스를 전송하기 위해 Datadog Agent에 연결할 때 사용하는 호스트 이름이에요. 호스트 이름은 IPv4, IPv6 또는 도메인 이름일 수 있어요. DD_TRACE_AGENT_URL이 지정되면 DD_AGENT_HOST 값은 무시돼요.
DD_API_KEY
Type: string Since: v5.83.0 Aliases:DATADOG_API_KEY
에이전트리스 모드(로컬 Agent 없이 Datadog에 직접 데이터를 전송)에서 실행할 때, 아웃바운드 요청을 인증하는 데 사용하는 Datadog API 키를 설정해요. 에이전트리스 CI 테스트 보고와 LLM Observability 에이전트리스 모드에 필요해요.
DD_APM_FLUSH_DEADLINE_MILLISECONDS
Type: int Default: 100 Since: v5.83.0
스팬이 일찍 완료되고 임박한 타임아웃에 도달해도 크래시가 발생하지 않아요.
DD_APM_TRACING_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_TRACING_ENABLED
APM 트레이스 데이터 전송을 활성화하거나 비활성화해요. 비활성화하면 추적은 여전히 다른 제품을 지원하기 위해 실행되지만, 주기적인 하트비트 트레이스와 수동으로 유지된 트레이스만 전송돼요.
DD_APP_KEY
Type: string Since: v5.83.0
에이전트리스 모드에서 LLM Observability 데이터셋 및 실험 요청을 인증하는 데 사용하는 애플리케이션 키를 설정해요. 에이전트리스 모드가 활성화되고 이 값이 설정되지 않으면 애플리케이션 키가 필요한 데이터셋/실험 작업이 실패해요.
DD_ENABLE_NX_SERVICE_NAME
Type: string Since: v5.83.0
NX_TASK_TARGET_PROJECT보다 DD_SERVICE가 우선하도록 설정해요.
DD_ENV
Type: string Since: v5.88.0
애플리케이션 환경이에요. 모든 스팬에 "env" 태그를 설정해요.
DD_EXTERNAL_ENV
Type: string Since: v5.83.0
송출되는 텔레메트리에 부착되어 출처와 환경 귀속에 사용되는 외부 환경 식별자를 설정해요.
DD_MINI_AGENT_PATH
Type: string Since: v5.83.0
제한된 환경에서 트레이서 통신을 위해 mini-agent에 도달하는 데 사용하는 파일시스템 경로를 설정해요.
DD_SERVERLESS_PUBSUB_ENABLED
Type: boolean Default: true
Node.js 분산 추적을 위한 새로운 GCP PubSub Push 구독 플러그인을 활성화해요.
DD_SERVICE
Type: string Since: v5.88.0 Aliases:DD_SERVICE_NAME, OTEL_SERVICE_NAME
모든 스팬의 service 태그로 사용되는 서비스 이름을 설정해요. 지정하지 않으면 SDK는 서비스 이름을 자동으로 결정하려고 해요.
언어별 참고 사항:
- .NET: IIS 애플리케이션 이름, 프로세스 진입 어셈블리 또는 프로세스 이름으로 대체돼요.
- Java: 애플리케이션 클래스를 기반으로 Java Agent가 자동 감지한 서비스 이름으로 대체돼요.
- Node.js:
package.json의name필드로 대체돼요.
DD_SERVICE_MAPPING
Type: map Since: v5.88.0
각 플러그인에 대한 서비스 이름을 제공해요. 쉼표로 구분된 plugin:service-name 쌍을 공백 유무와 관계없이 허용해요.
DD_SITE
Type: string Default: datadoghq.com Since: v5.88.0
에이전트리스 intake URL을 만드는 데 사용되는 사이트 도메인을 설정해요. 설정하지 않으면 기본 사이트가 사용돼요.
DD_TAGS
Type: map Since: v5.83.0
쉼표로 구분된 key:value 쌍(예: layer:api,team:intake)으로 제공되는 트레이스, 프로파일, 메트릭에 적용되는 사용자 지정 태그예요.
DD_TRACING_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서의 추적 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_VERSION
Type: string Since: v5.88.0
트레이스의 버전 태그로 설정되는 애플리케이션 버전이에요.
은퇴한 키 (Retired keys)
(1)
이 키들은 현재 버전의 라이브러리에서 더 이상 지원되지 않아요. 이전 버전을 실행 중이라면 참고용으로 나열돼 있어요.
DD_FLAGGING_PROVIDER_ENABLED
Removed in v5.84.0. Default: false Since: v5.83.0
SDK에서 기능 플래깅 기능을 활성화하기 위해 사용됨 [PREVIEW]
추적 핵심 (Tracing Core)
(27)
핵심 분산 추적 엔진: Agent 연결, 트레이스/스팬 ID 생성, 스팬 수명주기 관리, 피어 서비스 매핑, 리소스 정규화, 쿼리 문자열 난독화, DB 클라이언트 구성.
DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서가 128비트 W3C 트레이스 ID(32자 16진수)를 생성할지, 64비트 Datadog 트레이스 ID(16자 16진수)를 생성할지 제어해요. 완전한 W3C traceparent 상호운용성에는 128비트 ID가 필요해요.
DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED
Type: boolean Default: true Since: v5.83.0
128비트 트레이스 ID를 전체 32자 형식으로 기록할지, 16자로 잘라 기록할지 제어해요. 더 짧은 형식을 기대하는 시스템과의 호환성을 위해 false로 설정할 수 있어요.
DD_TRACE_AGENT_PORT
Type: int Default: 8126 Since: v5.83.0
트레이서가 제출하는 Trace Agent의 포트예요. Agent 구성이 receiver_port 또는 DD_APM_RECEIVER_PORT를 기본값 8126이 아닌 값으로 설정하면 DD_TRACE_AGENT_PORT 또는 DD_TRACE_AGENT_URL이 그 값과 일치해야 해요.
DD_TRACE_AGENT_PROTOCOL_VERSION
Type: string Default: 0.4 Since: v5.83.0
Agent에 대한 요청에 사용하는 프로토콜 버전이에요. 구성된 버전은 설치된 Agent 버전이 지원해야 하며, 그렇지 않으면 모든 트레이스가 버려져요.
DD_TRACE_AGENT_URL
Type: string Since: v5.83.0 Aliases:DD_TRACE_URL
트레이스가 전송되는 URL 엔드포인트를 설정해요. 설정하면 DD_AGENT_HOST와 DD_TRACE_AGENT_PORT를 재정의해요. 기본값은 http://<DD_AGENT_HOST>:<DD_TRACE_AGENT_PORT>이에요.
DD_TRACE_CLIENT_IP_ENABLED
Type: boolean Default: false Since: v5.83.0
HTTP 요청 헤더에서 클라이언트 IP 주소 자동 수집을 활성화하거나 비활성화해요. 활성화하면 IP 주소가 http.client_ip 스팬 태그에 저장돼요.
DD_TRACE_CLIENT_IP_HEADER
Type: string Since: v5.88.0
클라이언트 IP 주소를 해석하는 데 사용되는 선택적 사용자 지정 HTTP 헤더의 이름이에요.
DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH
Type: int Default: 10 Since: v5.83.0
AWS SDK 요청/응답 페이로드 태깅에 사용하는 AWS SDK 요청/응답 페이로드의 최대 깊이를 나타내는 정수예요.
DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING
Type: array Since: v5.83.0
AWS SDK 요청에서 편집할 JSONPath 항목의 쉼표로 구분된 문자열이에요. 이 값을 설정하면 요청에 대한 AWS 페이로드 태깅이 활성화돼요.
DD_TRACE_CLOUD_RESPONSE_PAYLOAD_TAGGING
Type: array Since: v5.83.0
AWS SDK 응답에서 편집할 JSONPath 항목의 쉼표로 구분된 문자열이에요. 이 값을 설정하면 응답에 대한 AWS 페이로드 태깅이 활성화돼요.
DD_TRACE_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_TRACING_ENABLED
프레임워크 및 라이브러리 계측을 활성화해요. false면 애플리케이션 코드가 트레이스를 생성하지 않아요. DD_APM_TRACING_ENABLED도 참고하세요.
DD_TRACE_EXPERIMENTAL_EXPORTER
Type: string Since: v5.83.0
에이전트로 보내는 대신 트레이스를 로그 출력 또는 에이전트리스로 기록할지 여부예요.
DD_TRACE_EXPERIMENTAL_SPAN_COUNTS
Type: boolean Default: false Since: v5.83.0
실험적인 스팬 수 추적을 활성화하여 트레이스에 집계 스팬 카운트 메타데이터가 포함되도록 해요.
DD_TRACE_FLUSH_INTERVAL
Type: int Default: 2000 Since: v5.88.0
트레이서가 에이전트에 트레이스를 제출하는 간격(밀리초)이에요.
DD_TRACE_NATIVE_SPAN_EVENTS
Type: boolean Default: false Since: v5.83.0
meta.events JSON 대신 네이티브 span_events 페이로드 형식으로 스팬 이벤트를 인코딩해요.
DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP
Type: string Default: (?:p(?:ass)?w(?:or)?d|pass(?:_?phrase)?|secret|(?:api_?|private_?|public_?|access_?|secret_?)key(?:_?id)?|token|consumer_?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?)(?:(?:\s|%20)*(?:=|%3D)[^&]+|(?:"|%22)(?:\s|%20)*(?::|%3A)(?:\s|%20)*(?:"|%22)(?:%2[^2]|%[^2]|[^"%])+(?:"|%22))|bearer(?:\s|%20)+[a-z0-9\._\-]+|token(?::|%3A)[a-z0-9]{13}|gh[opsu]_[0-9a-zA-Z]{36}|ey[I-L](?:[\w=-]|%3D)+\.ey[I-L](?:[\w=-]|%3D)+(?:\.(?:[\w.+\/=-]|%3D|%2F|%2B)+)?|[\-]{5}BEGIN(?:[a-z\s]|%20)+PRIVATE(?:\s|%20)KEY[\-]{5}[^\-]+[\-]{5}END(?:[a-z\s]|%20)+PRIVATE(?:\s|%20)KEY|ssh-rsa(?:\s|%20)*(?:[a-z0-9\/\.+]|%2F|%5C|%2B){100,} Since: v5.88.0
들어오는 HTTP 요청의 쿼리 문자열에서 민감한 데이터를 편집하기 위해 정규식을 적용해요. 기본 정규식은 비밀번호, 토큰, API 키, 개인 키, 인증 용어를 포함한 다양한 민감한 데이터 패턴과 일치해요. 일치 항목은 으로 대체돼요. 빈 문자열이 전달되면 난독화가 발생하지 않아요. 결과 값은 http.url 태그로 보고돼요.
DD_TRACE_PARTIAL_FLUSH_MIN_SPANS
Type: int Default: 1000 Since: v5.88.0
부분 플러시가 트리거되기 전에 트레이스에 축적된 완료된 스팬의 최소 개수예요. 유효하지 않은 값은 무시돼요.
DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED
Type: boolean Default: false Since: v5.83.0
활성화하면 트레이서가 Naming Schema v0에서 v1 피어 서비스 기본 알고리즘을 사용하여 적격 스팬에 대한 기본 peer.service 값을 계산해요. 비활성화하면 Naming Schema v0는 peer.service를 설정하지 않은 채로 둬요.
DD_TRACE_PEER_SERVICE_MAPPING
Type: map Since: v5.83.0
감지된 피어 서비스 이름을 스팬에 부착하기 전에 정규화된 값으로 매핑해요.
DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED
Type: boolean Default: false Since: v5.83.0
활성화하면 Naming Schema v0의 통합이 추론된 서비스 이름 사용을 중단하고 애플리케이션 서비스 이름으로 대체해요. 통합과 관계없이 모든 스팬이 DD_SERVICE로 보고되도록 하려면 이 설정을 사용해요.
DD_TRACE_REPORT_HOSTNAME
Type: boolean Default: false Since: v5.83.0
각 트레이스에 시스템 호스트 이름을 보고할지 여부예요. 비활성화하면 Agent의 호스트 이름이 대신 사용돼요.
DD_TRACE_RESOURCE_RENAMING_ENABLED
Type: boolean Default: false Since: v5.83.0
들어오는 HTTP 요청에 http.endpoint 태그를 계산해서 추가할지 제어해요. 기본적으로 애플리케이션 보안이 시작 시 활성화되지 않으면 비활성화되며, 이 설정으로 명시적으로 활성화하거나 비활성화할 수 있어요.
DD_TRACE_SCOPE
Type: string Since: v5.83.0
비동기 경계를 넘어 트레이스 컨텍스트를 유지하는 데 사용되는 비동기 컨텍스트 전파 구현을 선택해요.
DD_TRACE_SPAN_ATTRIBUTE_SCHEMA
Type: string Default: v0 Since: v5.88.0
통합에서 사용하는 스팬 속성 및 명명 스키마 버전을 선택해요. 허용 값: v0, v1.
DD_TRACE_SPAN_LEAK_DEBUG
Type: int Default: 0 Since: v5.83.0
0: 비활성화, 1: 로깅, 2: 가비지 컬렉션 + 로깅
DD_TRACE_STATS_COMPUTATION_ENABLED
Type: boolean Default: false Since: v5.83.0
stats 페이로드 생성 및 수집 측 메트릭을 위한 트레이서의 트레이스 통계 계산을 활성화해요.
DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH
Type: int Default: 512 Since: v5.83.0
트레이스 태그 전파를 위한 x-datadog-tags 헤더의 최대 길이예요. 비활성화하려면 0으로 설정해요.
은퇴한 키 (Retired keys)
(1)
이 키들은 현재 버전의 라이브러리에서 더 이상 지원되지 않아요. 이전 버전을 실행 중이라면 참고용으로 나열돼 있어요.
DD_TRACE_GLOBAL_TAGS
Removed in v5.88.0. Type: map Since: v5.83.0
전역 태그: 모든 곳(모든 스팬 및 런타임 메트릭)에 적용되는 키/값 태그예요. dd.trace.global.tags(레거시)와 dd.tags/dd.trace.tags(그리고 DD_ENV/DD_VERSION으로 조정)에서 병합돼요. 기본값: 빈 값.
트레이스 샘플링 (Trace Sampling)
(6)
유지하거나 버릴 트레이스와 스팬을 결정하는 샘플링 규칙과 비율로, 서비스별 규칙, 속도 제한, 우선순위 샘플링을 포함해요.
DD_SPAN_SAMPLING_RULES
Type: array Since: v5.88.0
트레이스의 나머지가 버려질 때 개별 스팬을 유지하기 위한 스팬 샘플링 규칙이에요. 객체의 JSON 배열이에요. 규칙은 구성된 순서대로 적용되어 스팬의 샘플링 비율을 결정해요. sample_rate 값은 0.0과 1.0(포함) 사이여야 해요. 자세한 내용은 Ingestion Mechanisms를 참고하세요. 예시:
my-service서비스와http.request작업 이름에 대해 스팬 샘플링 비율을 50%로, 초당 최대 50개 트레이스로 설정:[{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}]
DD_SPAN_SAMPLING_RULES_FILE
Type: string Since: v5.88.0
스팬 샘플링 규칙이 포함된 JSON 파일을 가리켜요. DD_SPAN_SAMPLING_RULES가 이 변수보다 우선해요. 규칙 형식은 DD_SPAN_SAMPLING_RULES를 참고하세요.
DD_TRACE_RATE_LIMIT
Type: int Default: 100 Since: v5.83.0
초당 샘플링할 최대 트레이스 수를 설정해요. DD_TRACE_SAMPLING_RULES 또는 DD_TRACE_SAMPLE_RATE 중 하나가 설정된 경우에만 적용돼요.
DD_TRACE_SAMPLE_RATE
Type: decimal Since: v5.88.0 Aliases:OTEL_TRACES_SAMPLER
Agent와 백엔드 사이의 수집 샘플링 비율(0.0~1.0)을 제어해요. 별칭으로 OTEL_TRACES_SAMPLER를 사용해요.
DD_TRACE_SAMPLING_RULES
Type: array Since: v5.83.0
특정 서비스, 작업, 리소스 또는 태그가 붙은 트레이스를 대상으로 지정할 수 있게 하여 트레이스 수집을 세밀하게 제어해요. 객체의 JSON 배열로 정의되며, 각 객체는 0.0과 1.0(포함) 사이의 sample_rate를 포함해야 하고 선택적으로 service, name, resource, tags, max_per_second 필드를 포함할 수 있어요. 객체는 나열된 순서대로 평가되며, 첫 번째 일치 객체가 트레이스의 샘플링 비율을 결정해요. 자세한 내용은 Ingestion Mechanisms 문서를 참고하세요.
예시:
-
모든 트레이스의 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
Type: boolean Default: true Since: v5.83.0
기본적으로 웹소켓 메시지는 핸드셰이크 중에 캡처된 스팬과 동일한 샘플링을 유지해요. 이렇게 하면 핸드셰이크 스팬이 샘플링된 경우 세션의 모든 메시지도 샘플링되도록 보장해요. 이 동작을 비활성화하고 각 웹소켓 메시지를 독립적으로 샘플링하려면 이 구성을 false로 설정해요.
트레이스 전파 (Trace Propagation)
(12)
분산 트레이스 컨텍스트 전파, 추출/주입 동작, 배기지 처리, 헤더 태깅, HTTP 클라이언트/서버 구성, Database Monitoring을 위한 SQL 주석 주입.
DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED
Type: boolean Default: true Since: v5.93.0
프로세스 수준 태그(예: 진입점 메타데이터)를 수집하여 추적 페이로드에 부착할지 제어해요.
DD_TRACE_BAGGAGE_MAX_BYTES
Type: int Default: 8192 Since: v5.83.0
다운스트림 서비스로 전파할 때 배기지 헤더에 주입할 수 있는 최대 바이트 수를 설정하는 구성 키예요. 기본값은 8192바이트예요.
DD_TRACE_BAGGAGE_MAX_ITEMS
Type: int Default: 64 Since: v5.83.0
다운스트림 서비스로 전파할 때 배기지 헤더에 주입할 수 있는 최대 항목 수를 설정하는 구성 키예요. 기본값은 64개 항목이에요.
DD_TRACE_BAGGAGE_TAG_KEYS
Type: array Default: user.id, session.id, account.id Since: v5.83.0
스팬 태그에 복사할 배기지 키의 쉼표로 구분된 목록이에요. 모든 배기지 항목에 태그를 지정하려면 *로 설정하고, 설정하지 않으면 기본 허용 목록이 사용돼요.
DD_TRACE_EXPERIMENTAL_B3_ENABLED
Type: boolean Default: false Since: v5.83.0
실험적인 b3 계측을 활성화해요. 비활성화하면 실험적 b3 작업에 대한 스팬이 생성되지 않아요.
DD_TRACE_HEADER_TAGS
Type: array Since: v5.83.0
스팬 태그로 자동 적용할 HTTP 헤더의 쉼표로 구분된 목록이에요. 각 항목은 헤더 이름만 사용할 수 있고(들어오는 요청은 http.request.headers.<header>로, 나가는 응답은 http.response.headers.<header>로 보고), 또는 태그 키를 제어하기 위해 <header>:<custom_tag_name> 형식을 사용할 수 있어요.
DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED
Type: boolean Default: false Since: v5.83.0 Aliases:DD_TRACE_INFERRED_SPANS_ENABLED
활성화하면 트레이서가 추론 프록시 전파기를 등록하여 x-dd-proxy* 헤더(현재 x-dd-proxy=aws-apigateway)를 읽고, 헤더 값을 서비스/리소스/태그로 사용하여 서버 스팬의 부모로 추론 프록시 스팬을 시작해요.
DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT
Type: string Default: continue Since: v5.88.0
서비스 수준에서 들어오는 분산 추적 헤더를 처리하는 방식을 지정해요. 허용 값: continue: 들어오는 분산 추적 헤더가 유효한 트레이스 컨텍스트를 나타내면 SDK가 분산 트레이스를 계속해요. restart: SDK가 항상 새 트레이스를 시작해요. 들어오는 분산 추적 헤더가 유효한 트레이스 컨텍스트를 나타내면 해당 컨텍스트는( continue 구성의 부모 스팬과 달리) 서비스 진입 스팬의 스팬 링크로 표현돼요. ignore: SDK가 항상 새 트레이스를 시작하고 모든 들어오는 분산 추적 헤더를 무시해요.
DD_TRACE_PROPAGATION_EXTRACT_FIRST
Type: boolean Default: false Since: v5.83.0
true로 설정하면 첫 번째 성공적인 트레이스 컨텍스트 추출 후 추출을 중지해요.
DD_TRACE_PROPAGATION_STYLE
Type: array Default: datadog,tracecontext,baggage Since: v5.88.0 Aliases:OTEL_PROPAGATORS
분산 추적 전파 데이터를 주입하고 추출하려고 시도하는 헤더 형식의 쉼표로 구분된 목록이에요. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요. 더 구체적인 DD_TRACE_PROPAGATION_STYLE_INJECT 및 DD_TRACE_PROPAGATION_STYLE_EXTRACT 구성이 있을 때 우선해요.
DD_TRACE_PROPAGATION_STYLE_EXTRACT
Type: array Default: datadog, tracecontext, baggage Since: v5.88.0 Aliases:DD_TRACE_PROPAGATION_STYLE
분산 추적 전파 데이터를 추출하려고 시도하는 헤더 형식의 쉼표로 구분된 목록이에요. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요.
DD_TRACE_PROPAGATION_STYLE_INJECT
Type: array Default: datadog, tracecontext, baggage Since: v5.88.0 Aliases:DD_TRACE_PROPAGATION_STYLE
서비스 간 분산 트레이스를 전파하기 위해 포함할 헤더 형식의 쉼표로 구분된 목록이에요.
트레이스 통합 (Trace Integrations)
(218)
통합별 추적 구성: 라이브러리 통합에 대한 활성화/비활성화, 분석, 서비스 이름, 피어 서비스 재정의 및 특정 계측 비활성화 제어.
일반 통합 설정 (General Integration Settings)
DD_TRACE_DISABLED_INSTRUMENTATIONS
Type: string Since: v5.83.0
DD_TRACE_DISABLED_INSTRUMENTATIONS 환경 변수를 비활성화할 통합 이름의 쉼표로 구분된 목록으로 설정해요.
DD_TRACE_DISABLED_PLUGINS
Type: string Since: v5.83.0
비활성화할 쉼표로 구분된 플러그인 ID로, 해당 통합이 자동 계측되지 않도록 해요.
구성 종류 (Configuration Kinds)
각 통합은 다음 구성 패턴 중 하나 이상을 지원할 수 있어요. <INTEGRATION>을 통합 이름(예: GRPC, AWS, REDIS)으로 바꾸세요.
DD_TRACE_<INTEGRATION>_ENABLED
(203 integrations)
특정 통합에 대한 추적을 활성화하거나 비활성화해요.
사용 가능한 통합:AI, AMQP10, AMQPLIB, ANTHROPIC, APOLLO, APOLLO_GATEWAY, APOLLO_SERVER, APOLLO_SERVER_CORE, APOLLO_SERVER_EXPRESS, APOLLO_SERVER_FASTIFY, APOLLO_SUBGRAPH, AVSC, AWS_SDK_AWS, AWS_SDK_AWS_BATCH_PROPAGATION, AWS_SDK_BATCH_PROPAGATION, AWS_SDK_BEDROCKRUNTIME, AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION, AWS_SDK_CLOUDWATCHLOGS, AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION, AWS_SDK_DYNAMODB, AWS_SDK_DYNAMODB_BATCH_PROPAGATION, AWS_SDK_EVENTBRIDGE, AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION, AWS_SDK_KINESIS, AWS_SDK_KINESIS_BATCH_PROPAGATION, AWS_SDK_LAMBDA, AWS_SDK_LAMBDA_BATCH_PROPAGATION, AWS_SDK_NODE_HTTP_HANDLER, AWS_SDK_REDSHIFT, AWS_SDK_REDSHIFT_BATCH_PROPAGATION, AWS_SDK_S3, AWS_SDK_S3_BATCH_PROPAGATION, AWS_SDK_SFN, AWS_SDK_SFN_BATCH_PROPAGATION, AWS_SDK_SFN_CLIENT, AWS_SDK_SMITHY_CLIENT, AWS_SDK_SNS, AWS_SDK_SNS_BATCH_PROPAGATION, AWS_SDK_SQS, AWS_SDK_SQS_BATCH_PROPAGATION, AWS_SDK_STATES, AWS_SDK_STATES_BATCH_PROPAGATION, AWS_SDK_STEPFUNCTIONS, AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION, AXIOS, AZURE_EVENT_HUBS, AZURE_EVENTHUBS_BATCH_LINKS, AZURE_SERVICE_BUS, AZURE_SERVICEBUS_BATCH_LINKS, BLUEBIRD, BODY_PARSER, BSON, BULLMQ, BUNYAN, CASSANDRA_DRIVER, CHILD_PROCESS, COLLECTIONS, COMMONPLUGIN, CONFLUENTINC_KAFKA_JAVASCRIPT, CONNECT, COOKIE, COOKIE_PARSER, CRYPTO, CUCUMBER_CUCUMBER, CYPRESS, DNS, ELASTIC_ELASTICSEARCH, ELASTIC_TRANSPORT, ELASTICSEARCH, EXPRESS, EXPRESS_MONGO_SANITIZE, EXPRESS_SESSION, FASTIFY, FETCH, FIND_MY_WAY, FS, GCP_PUBSUB_PUSH, GENERIC_POOL, GOOGLE_CLOUD_PUBSUB, GOOGLE_CLOUD_VERTEXAI, GOOGLE_GAX, GOOGLE_GENAI, GRAPHQL, GRAPHQL_TAG, GRAPHQL_TOOLS, GRAPHQL_TOOLS_EXECUTOR, GRAPHQL_YOGA, GRPC, GRPC_GRPC_JS, GRPC_PROTO_LOADER, HANDLEBARS, HAPI, HAPI_BOOM, HAPI_HAPI, HONO, HTTP, HTTP2, HTTPS, IOREDIS, IOVALKEY, JEST, JEST_CIRCUS, JEST_CONFIG, JEST_CORE, JEST_ENVIRONMENT_JSDOM, JEST_ENVIRONMENT_NODE, JEST_GLOBALS, JEST_REPORTERS, JEST_RUNTIME, JEST_TEST_SEQUENCER, JEST_TRANSFORM, JEST_WORKER, KAFKAJS, KNEX, KOA, KOA_ROUTE, KOA_ROUTER, KOA_WEBSOCKET, LAMBDA, LANGCHAIN, LANGCHAIN_ANTHROPIC, LANGCHAIN_COHERE, LANGCHAIN_CORE, LANGCHAIN_GOOGLE_GENAI, LANGCHAIN_OPENAI, LANGGRAPH, LDAPJS, LDAPJS_PROMISE, LEGACY_BAGGAGE, LIMITD_CLIENT, LODASH, LOOPBACK, MARIADB, MEMCACHED, MEMCACHED_COMMAND, MICROGATEWAY_CORE, MIDDIE, MIDDLEWARE_TRACING, MOCHA, MOCHA_EACH, MOLECULER, MONGODB, MONGODB_CORE, MONGODB_HEARTBEAT, MONGOOSE, MQUERY, MULTER, MYSQL, MYSQL2, NET, NEXT, NODE_CHILD_PROCESS, NODE_REDIS_CLIENT, NODE_SERIALIZE, NYC, OPENAI, OPENSEARCH, OPENSEARCH_PROJECT_OPENSEARCH, OPENTELEMETRY_SDK_TRACE_NODE, ORACLEDB, PASSPORT, PASSPORT_HTTP, PASSPORT_LOCAL, PG, PG_CURSOR, PG_NATIVE, PG_QUERY_STREAM, PINO, PINO_PRETTY, PLAYWRIGHT, PLAYWRIGHT_CORE, PLAYWRIGHT_TEST, PRISMA, PROCESS, PROMISE, PROMISE_JS, PROTOBUFJS, PUG, Q, REACT, REACT_DOM, REDIS, REDIS_CLIENT, REQUEST, RESTIFY, RHEA, ROUTER, SELENIUM_WEBDRIVER, SEQUELIZE, SHAREDB, SMITHY_SMITHY_CLIENT, SQLITE3, SUFFIXPLUGIN, TEDIOUS, UNDICI, URL, VERTEXAI, VITEST, VITEST_RUNNER, VM, WEBSOCKET_MESSAGES, WHEN, WINSTON, WORKERPOOL, WS
통합별 설정 (Per-Integration Settings)
(209 integrations)
각 섹션은 특정 통합에 사용할 수 있는 모든 구성 키를 나열해요.
AI
(1)
DD_TRACE_AI_ENABLED
Type: boolean Default: true Since: v5.83.0
ai에 대한 계측을 활성화해요. 비활성화하면 ai 작업에 대한 스팬이 생성되지 않아요.
AMQP10
(1)
DD_TRACE_AMQP10_ENABLED
Type: boolean Default: true Since: v5.83.0
amqp10에 대한 계측을 활성화해요. 비활성화하면 amqp10 작업에 대한 스팬이 생성되지 않아요.
AMQPLIB
(1)
DD_TRACE_AMQPLIB_ENABLED
Type: boolean Default: true Since: v5.83.0
amqplib에 대한 계측을 활성화해요. 비활성화하면 amqplib 작업에 대한 스팬이 생성되지 않아요.
ANTHROPIC
(1)
DD_TRACE_ANTHROPIC_ENABLED
Type: boolean Default: true Since: v5.83.0
anthropic에 대한 계측을 활성화해요. 비활성화하면 anthropic 작업에 대한 스팬이 생성되지 않아요.
APOLLO
(1)
DD_TRACE_APOLLO_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo에 대한 계측을 활성화해요. 비활성화하면 apollo 작업에 대한 스팬이 생성되지 않아요.
APOLLO_GATEWAY
(1)
DD_TRACE_APOLLO_GATEWAY_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo gateway에 대한 계측을 활성화해요. 비활성화하면 apollo gateway 작업에 대한 스팬이 생성되지 않아요.
APOLLO_SERVER
(1)
DD_TRACE_APOLLO_SERVER_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo server에 대한 계측을 활성화해요. 비활성화하면 apollo server 작업에 대한 스팬이 생성되지 않아요.
APOLLO_SERVER_CORE
(1)
DD_TRACE_APOLLO_SERVER_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo server core에 대한 계측을 활성화해요. 비활성화하면 apollo server core 작업에 대한 스팬이 생성되지 않아요.
APOLLO_SERVER_EXPRESS
(1)
DD_TRACE_APOLLO_SERVER_EXPRESS_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo server express에 대한 계측을 활성화해요. 비활성화하면 apollo server express 작업에 대한 스팬이 생성되지 않아요.
APOLLO_SERVER_FASTIFY
(1)
DD_TRACE_APOLLO_SERVER_FASTIFY_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo server fastify에 대한 계측을 활성화해요. 비활성화하면 apollo server fastify 작업에 대한 스팬이 생성되지 않아요.
APOLLO_SUBGRAPH
(1)
DD_TRACE_APOLLO_SUBGRAPH_ENABLED
Type: boolean Default: true Since: v5.83.0
apollo subgraph에 대한 계측을 활성화해요. 비활성화하면 apollo subgraph 작업에 대한 스팬이 생성되지 않아요.
AVSC
(1)
DD_TRACE_AVSC_ENABLED
Type: boolean Default: true Since: v5.83.0
avsc에 대한 계측을 활성화해요. 비활성화하면 avsc 작업에 대한 스팬이 생성되지 않아요.
AWS
(1)
DD_TRACE_AWS_ADD_SPAN_POINTERS
Type: boolean Default: true Since: v5.83.0
AWS 요청에 스팬 포인터를 활성화하거나 비활성화해요. 기본값은 true예요.
AWS_SDK_AWS
(1)
DD_TRACE_AWS_SDK_AWS_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk aws에 대한 계측을 활성화해요. 비활성화하면 aws sdk aws 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_AWS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_AWS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk aws batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk aws batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_BEDROCKRUNTIME
(1)
DD_TRACE_AWS_SDK_BEDROCKRUNTIME_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk bedrockruntime에 대한 계측을 활성화해요. 비활성화하면 aws sdk bedrockruntime 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_BEDROCKRUNTIME_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk bedrockruntime batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk bedrockruntime batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_CLOUDWATCHLOGS
(1)
DD_TRACE_AWS_SDK_CLOUDWATCHLOGS_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk cloudwatchlogs에 대한 계측을 활성화해요. 비활성화하면 aws sdk cloudwatchlogs 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_CLOUDWATCHLOGS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk cloudwatchlogs batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk cloudwatchlogs batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_DYNAMODB
(1)
DD_TRACE_AWS_SDK_DYNAMODB_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk dynamodb에 대한 계측을 활성화해요. 비활성화하면 aws sdk dynamodb 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_DYNAMODB_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_DYNAMODB_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk dynamodb batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk dynamodb batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_EVENTBRIDGE
(1)
DD_TRACE_AWS_SDK_EVENTBRIDGE_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk eventbridge에 대한 계측을 활성화해요. 비활성화하면 aws sdk eventbridge 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_EVENTBRIDGE_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk eventbridge batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk eventbridge batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_KINESIS
(1)
DD_TRACE_AWS_SDK_KINESIS_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk kinesis에 대한 계측을 활성화해요. 비활성화하면 aws sdk kinesis 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_KINESIS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_KINESIS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk kinesis batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk kinesis batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_LAMBDA
(1)
DD_TRACE_AWS_SDK_LAMBDA_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk lambda에 대한 계측을 활성화해요. 비활성화하면 aws sdk lambda 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_LAMBDA_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_LAMBDA_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk lambda batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk lambda batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_NODE_HTTP_HANDLER
(1)
DD_TRACE_AWS_SDK_NODE_HTTP_HANDLER_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk node http handler에 대한 계측을 활성화해요. 비활성화하면 aws sdk node http handler 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_REDSHIFT
(1)
DD_TRACE_AWS_SDK_REDSHIFT_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk redshift에 대한 계측을 활성화해요. 비활성화하면 aws sdk redshift 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_REDSHIFT_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_REDSHIFT_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk redshift batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk redshift batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_S3
(1)
DD_TRACE_AWS_SDK_S3_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk s3에 대한 계측을 활성화해요. 비활성화하면 aws sdk s3 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_S3_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_S3_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk s3 batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk s3 batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SFN
(1)
DD_TRACE_AWS_SDK_SFN_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sfn에 대한 계측을 활성화해요. 비활성화하면 aws sdk sfn 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SFN_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_SFN_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sfn batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk sfn batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SFN_CLIENT
(1)
DD_TRACE_AWS_SDK_SFN_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sfn client에 대한 계측을 활성화해요. 비활성화하면 aws sdk sfn client 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SMITHY_CLIENT
(1)
DD_TRACE_AWS_SDK_SMITHY_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk smithy client에 대한 계측을 활성화해요. 비활성화하면 aws sdk smithy client 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SNS
(1)
DD_TRACE_AWS_SDK_SNS_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sns에 대한 계측을 활성화해요. 비활성화하면 aws sdk sns 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SNS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_SNS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sns batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk sns batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SQS
(1)
DD_TRACE_AWS_SDK_SQS_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sqs에 대한 계측을 활성화해요. 비활성화하면 aws sdk sqs 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_SQS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_SQS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk sqs batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk sqs batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_STATES
(1)
DD_TRACE_AWS_SDK_STATES_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk states에 대한 계측을 활성화해요. 비활성화하면 aws sdk states 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_STATES_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_STATES_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk states batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk states batch propagation 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_STEPFUNCTIONS
(1)
DD_TRACE_AWS_SDK_STEPFUNCTIONS_ENABLED
**Type: boolean**Default**:true**Since**:v5.83.0`
aws sdk stepfunctions에 대한 계측을 활성화해요. 비활성화하면 aws sdk stepfunctions 작업에 대한 스팬이 생성되지 않아요.
AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION
(1)
DD_TRACE_AWS_SDK_STEPFUNCTIONS_BATCH_PROPAGATION_ENABLED
Type: boolean Default: true Since: v5.83.0
aws sdk stepfunctions batch propagation에 대한 계측을 활성화해요. 비활성화하면 aws sdk stepfunctions batch propagation 작업에 대한 스팬이 생성되지 않아요.
AXIOS
(1)
DD_TRACE_AXIOS_ENABLED
Type: boolean Default: true Since: v5.83.0
axios에 대한 계측을 활성화해요. 비활성화하면 axios 작업에 대한 스팬이 생성되지 않아요.
AZURE_EVENT_HUBS
(1)
DD_TRACE_AZURE_EVENT_HUBS_ENABLED
Type: boolean Default: true Since: v5.83.0
azure event hubs에 대한 계측을 활성화해요. 비활성화하면 azure event hubs 작업에 대한 스팬이 생성되지 않아요.
AZURE_EVENTHUBS_BATCH_LINKS
(1)
DD_TRACE_AZURE_EVENTHUBS_BATCH_LINKS_ENABLED
Type: boolean Default: true Since: v5.83.0
azure eventhubs batch links에 대한 계측을 활성화해요. 비활성화하면 azure eventhubs batch links 작업에 대한 스팬이 생성되지 않아요.
AZURE_SERVICE_BUS
(1)
DD_TRACE_AZURE_SERVICE_BUS_ENABLED
Type: boolean Default: true Since: v5.83.0
azure service bus에 대한 계측을 활성화해요. 비활성화하면 azure service bus 작업에 대한 스팬이 생성되지 않아요.
AZURE_SERVICEBUS_BATCH_LINKS
(1)
DD_TRACE_AZURE_SERVICEBUS_BATCH_LINKS_ENABLED
Type: boolean Default: true Since: v5.83.0
azure servicebus batch links에 대한 계측을 활성화해요. 비활성화하면 azure servicebus batch links 작업에 대한 스팬이 생성되지 않아요.
BLUEBIRD
(1)
DD_TRACE_BLUEBIRD_ENABLED
Type: boolean Default: true Since: v5.83.0
bluebird에 대한 계측을 활성화해요. 비활성화하면 bluebird 작업에 대한 스팬이 생성되지 않아요.
BODY_PARSER
(1)
DD_TRACE_BODY_PARSER_ENABLED
Type: boolean Default: true Since: v5.83.0
body parser에 대한 계측을 활성화해요. 비활성화하면 body parser 작업에 대한 스팬이 생성되지 않아요.
BSON
(1)
DD_TRACE_BSON_ENABLED
Type: boolean Default: true Since: v5.83.0
bson에 대한 계측을 활성화해요. 비활성화하면 bson 작업에 대한 스팬이 생성되지 않아요.
BULLMQ
(1)
DD_TRACE_BULLMQ_ENABLED
Type: boolean Default: true Since: v5.83.0
bullmq에 대한 계측을 활성화해요. 비활성화하면 bullmq 작업에 대한 스팬이 생성되지 않아요.
BUNYAN
(1)
DD_TRACE_BUNYAN_ENABLED
Type: boolean Default: true Since: v5.83.0
bunyan에 대한 계측을 활성화해요. 비활성화하면 bunyan 작업에 대한 스팬이 생성되지 않아요.
CASSANDRA_DRIVER
(1)
DD_TRACE_CASSANDRA_DRIVER_ENABLED
Type: boolean Default: true Since: v5.83.0
cassandra driver에 대한 계측을 활성화해요. 비활성화하면 cassandra driver 작업에 대한 스팬이 생성되지 않아요.
CHILD_PROCESS
(1)
DD_TRACE_CHILD_PROCESS_ENABLED
Type: boolean Default: true Since: v5.83.0
child process에 대한 계측을 활성화해요. 비활성화하면 child process 작업에 대한 스팬이 생성되지 않아요.
COLLECTIONS
(1)
DD_TRACE_COLLECTIONS_ENABLED
Type: boolean Default: true Since: v5.83.0
collections에 대한 계측을 활성화해요. 비활성화하면 collections 작업에 대한 스팬이 생성되지 않아요.
COMMONPLUGIN
(1)
DD_TRACE_COMMONPLUGIN_ENABLED
Type: boolean Default: true Since: v5.83.0
commonplugin에 대한 계측을 활성화해요. 비활성화하면 commonplugin 작업에 대한 스팬이 생성되지 않아요.
CONFLUENTINC_KAFKA_JAVASCRIPT
(1)
DD_TRACE_CONFLUENTINC_KAFKA_JAVASCRIPT_ENABLED
Type: boolean Default: true Since: v5.83.0
confluentinc kafka javascript에 대한 계측을 활성화해요. 비활성화하면 confluentinc kafka javascript 작업에 대한 스팬이 생성되지 않아요.
CONNECT
(1)
DD_TRACE_CONNECT_ENABLED
Type: boolean Default: true Since: v5.83.0
connect에 대한 계측을 활성화해요. 비활성화하면 connect 작업에 대한 스팬이 생성되지 않아요.
COOKIE
(1)
DD_TRACE_COOKIE_ENABLED
Type: boolean Default: true Since: v5.83.0
cookie에 대한 계측을 활성화해요. 비활성화하면 cookie 작업에 대한 스팬이 생성되지 않아요.
COOKIE_PARSER
(1)
DD_TRACE_COOKIE_PARSER_ENABLED
Type: boolean Default: true Since: v5.83.0
cookie parser에 대한 계측을 활성화해요. 비활성화하면 cookie parser 작업에 대한 스팬이 생성되지 않아요.
CRYPTO
(1)
DD_TRACE_CRYPTO_ENABLED
Type: boolean Default: true Since: v5.83.0
crypto에 대한 계측을 활성화해요. 비활성화하면 crypto 작업에 대한 스팬이 생성되지 않아요.
CUCUMBER_CUCUMBER
(1)
DD_TRACE_CUCUMBER_CUCUMBER_ENABLED
Type: boolean Default: true Since: v5.83.0
cucumber cucumber에 대한 계측을 활성화해요. 비활성화하면 cucumber cucumber 작업에 대한 스팬이 생성되지 않아요.
CYPRESS
(1)
DD_TRACE_CYPRESS_ENABLED
Type: boolean Default: true Since: v5.83.0
cypress에 대한 계측을 활성화해요. 비활성화하면 cypress 작업에 대한 스팬이 생성되지 않아요.
DNS
(1)
DD_TRACE_DNS_ENABLED
Type: boolean Default: true Since: v5.83.0
dns에 대한 계측을 활성화해요. 비활성화하면 dns 작업에 대한 스팬이 생성되지 않아요.
DYNAMODB
(1)
DD_TRACE_DYNAMODB_TABLE_PRIMARY_KEYS
Type: string Since: v5.83.0
DynamoDB 테이블 이름을 스팬 포인터에 사용되는 기본 키 필드 이름(1-2)에 매핑하는 JSON 객체예요.
ELASTIC_ELASTICSEARCH
(1)
DD_TRACE_ELASTIC_ELASTICSEARCH_ENABLED
Type: boolean Default: true Since: v5.83.0
elastic elasticsearch에 대한 계측을 활성화해요. 비활성화하면 elastic elasticsearch 작업에 대한 스팬이 생성되지 않아요.
ELASTIC_TRANSPORT
(1)
DD_TRACE_ELASTIC_TRANSPORT_ENABLED
Type: boolean Default: true Since: v5.83.0
elastic transport에 대한 계측을 활성화해요. 비활성화하면 elastic transport 작업에 대한 스팬이 생성되지 않아요.
ELASTICSEARCH
(1)
DD_TRACE_ELASTICSEARCH_ENABLED
Type: boolean Default: true Since: v5.83.0
elasticsearch에 대한 계측을 활성화해요. 비활성화하면 elasticsearch 작업에 대한 스팬이 생성되지 않아요.
EXPRESS
(1)
DD_TRACE_EXPRESS_ENABLED
Type: boolean Default: true Since: v5.83.0
DD_TRACE__ENABLED를 사용하여 계측 로딩을 비활성화해요.
EXPRESS_MONGO_SANITIZE
(1)
DD_TRACE_EXPRESS_MONGO_SANITIZE_ENABLED
Type: boolean Default: true Since: v5.83.0
express mongo sanitize에 대한 계측을 활성화해요. 비활성화하면 express mongo sanitize 작업에 대한 스팬이 생성되지 않아요.
EXPRESS_SESSION
(1)
DD_TRACE_EXPRESS_SESSION_ENABLED
Type: boolean Default: true Since: v5.83.0
express session에 대한 계측을 활성화해요. 비활성화하면 express session 작업에 대한 스팬이 생성되지 않아요.
FASTIFY
(1)
DD_TRACE_FASTIFY_ENABLED
Type: boolean Default: true Since: v5.83.0
fastify에 대한 계측을 활성화해요. 비활성화하면 fastify 작업에 대한 스팬이 생성되지 않아요.
FETCH
(1)
DD_TRACE_FETCH_ENABLED
Type: boolean Default: true Since: v5.83.0
fetch에 대한 계측을 활성화해요. 비활성화하면 fetch 작업에 대한 스팬이 생성되지 않아요.
FIND_MY_WAY
(1)
DD_TRACE_FIND_MY_WAY_ENABLED
Type: boolean Default: true Since: v5.83.0
find my way에 대한 계측을 활성화해요. 비활성화하면 find my way 작업에 대한 스팬이 생성되지 않아요.
FS
(1)
DD_TRACE_FS_ENABLED
Type: boolean Default: true Since: v5.83.0
fs에 대한 계측을 활성화해요. 비활성화하면 fs 작업에 대한 스팬이 생성되지 않아요.
GCP_PUBSUB_PUSH
(1)
DD_TRACE_GCP_PUBSUB_PUSH_ENABLED
Type: boolean Default: true Since: v5.83.0
gcp pubsub push에 대한 계측을 활성화해요. 비활성화하면 gcp pubsub push 작업에 대한 스팬이 생성되지 않아요.
GENERIC_POOL
(1)
DD_TRACE_GENERIC_POOL_ENABLED
Type: boolean Default: true Since: v5.83.0
generic pool에 대한 계측을 활성화해요. 비활성화하면 generic pool 작업에 대한 스팬이 생성되지 않아요.
GOOGLE_CLOUD_PUBSUB
(1)
DD_TRACE_GOOGLE_CLOUD_PUBSUB_ENABLED
Type: boolean Default: true Since: v5.83.0
google cloud pubsub에 대한 계측을 활성화해요. 비활성화하면 google cloud pubsub 작업에 대한 스팬이 생성되지 않아요.
GOOGLE_CLOUD_VERTEXAI
(1)
DD_TRACE_GOOGLE_CLOUD_VERTEXAI_ENABLED
Type: boolean Default: true Since: v5.83.0
google cloud vertexai에 대한 계측을 활성화해요. 비활성화하면 google cloud vertexai 작업에 대한 스팬이 생성되지 않아요.
GOOGLE_GAX
(1)
DD_TRACE_GOOGLE_GAX_ENABLED
Type: boolean Default: true Since: v5.83.0
google gax에 대한 계측을 활성화해요. 비활성화하면 google gax 작업에 대한 스팬이 생성되지 않아요.
GOOGLE_GENAI
(1)
DD_TRACE_GOOGLE_GENAI_ENABLED
Type: boolean Default: true Since: v5.83.0
google genai에 대한 계측을 활성화해요. 비활성화하면 google genai 작업에 대한 스팬이 생성되지 않아요.
GRAPHQL
(2)
DD_TRACE_GRAPHQL_ENABLED
Type: boolean Default: true Since: v5.83.0
graphql에 대한 계측을 활성화해요. 비활성화하면 graphql 작업에 대한 스팬이 생성되지 않아요.
DD_TRACE_GRAPHQL_ERROR_EXTENSIONS
Type: array Since: v5.83.0
스팬 태그로 캡처할 GraphQL 오류 확장 키의 쉼표로 구분된 목록이에요. 설정하지 않으면 확장이 캡처되지 않아요.
GRAPHQL_TAG
(1)
DD_TRACE_GRAPHQL_TAG_ENABLED
Type: boolean Default: true Since: v5.83.0
graphql tag에 대한 계측을 활성화해요. 비활성화하면 graphql tag 작업에 대한 스팬이 생성되지 않아요.
GRAPHQL_TOOLS
(1)
DD_TRACE_GRAPHQL_TOOLS_ENABLED
Type: boolean Default: true Since: v5.83.0
graphql tools에 대한 계측을 활성화해요. 비활성화하면 graphql tools 작업에 대한 스팬이 생성되지 않아요.
GRAPHQL_TOOLS_EXECUTOR
(1)
DD_TRACE_GRAPHQL_TOOLS_EXECUTOR_ENABLED
Type: boolean Default: true Since: v5.83.0
graphql tools executor에 대한 계측을 활성화해요. 비활성화하면 graphql tools executor 작업에 대한 스팬이 생성되지 않아요.
GRAPHQL_YOGA
(1)
DD_TRACE_GRAPHQL_YOGA_ENABLED
Type: boolean Default: true Since: v5.83.0
graphql yoga에 대한 계측을 활성화해요. 비활성화하면 graphql yoga 작업에 대한 스팬이 생성되지 않아요.
GRPC
(1)
DD_TRACE_GRPC_ENABLED
Type: boolean Default: true Since: v5.83.0
grpc에 대한 계측을 활성화해요. 비활성화하면 grpc 작업에 대한 스팬이 생성되지 않아요.
GRPC_CLIENT
(1)
DD_GRPC_CLIENT_ERROR_STATUSES
Type: array Default: 1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 Since: v5.83.0
오류 범위를 허용할 수 있어요. 기본적으로 gRPC 클라이언트에 대해 gRPC 상태 코드 1~16이 오류로 보고돼요. 이 구성이 이를 재정의해요. 예: dd.grpc.client.error.statuses=1-4,7-10
GRPC_GRPC_JS
(1)
DD_TRACE_GRPC_GRPC_JS_ENABLED
Type: boolean Default: true Since: v5.83.0
grpc grpc js에 대한 계측을 활성화해요. 비활성화하면 grpc grpc js 작업에 대한 스팬이 생성되지 않아요.
GRPC_PROTO_LOADER
(1)
DD_TRACE_GRPC_PROTO_LOADER_ENABLED
Type: boolean Default: true Since: v5.83.0
grpc proto loader에 대한 계측을 활성화해요. 비활성화하면 grpc proto loader 작업에 대한 스팬이 생성되지 않아요.
GRPC_SERVER
(1)
DD_GRPC_SERVER_ERROR_STATUSES
Type: array Default: 2,3,4,5,6,7,8,9,10,11,12,13,14,15,16 Since: v5.83.0
오류 범위를 허용할 수 있어요. 기본적으로 gRPC 서버에 대해 gRPC 상태 코드 2~16이 오류로 보고돼요. 이 구성이 이를 재정의해요. 예: dd.grpc.server.error.statuses=2-4,7-10
HANDLEBARS
(1)
DD_TRACE_HANDLEBARS_ENABLED
Type: boolean Default: true Since: v5.83.0
handlebars에 대한 계측을 활성화해요. 비활성화하면 handlebars 작업에 대한 스팬이 생성되지 않아요.
HAPI
(1)
DD_TRACE_HAPI_ENABLED
Type: boolean Default: true Since: v5.83.0
hapi에 대한 계측을 활성화해요. 비활성화하면 hapi 작업에 대한 스팬이 생성되지 않아요.
HAPI_BOOM
(1)
DD_TRACE_HAPI_BOOM_ENABLED
Type: boolean Default: true Since: v5.83.0
hapi boom에 대한 계측을 활성화해요. 비활성화하면 hapi boom 작업에 대한 스팬이 생성되지 않아요.
HAPI_HAPI
(1)
DD_TRACE_HAPI_HAPI_ENABLED
Type: boolean Default: true Since: v5.83.0
hapi hapi에 대한 계측을 활성화해요. 비활성화하면 hapi hapi 작업에 대한 스팬이 생성되지 않아요.
HONO
(1)
DD_TRACE_HONO_ENABLED
Type: boolean Default: true Since: v5.83.0
hono에 대한 계측을 활성화해요. 비활성화하면 hono 작업에 대한 스팬이 생성되지 않아요.
HTTP
(1)
DD_TRACE_HTTP_ENABLED
Type: boolean Default: true Since: v5.83.0
http에 대한 계측을 활성화해요. 비활성화하면 http 작업에 대한 스팬이 생성되지 않아요.
HTTP2
(1)
DD_TRACE_HTTP2_ENABLED
Type: boolean Default: true Since: v5.83.0
http2에 대한 계측을 활성화해요. 비활성화하면 http2 작업에 대한 스팬이 생성되지 않아요.
HTTPS
(1)
DD_TRACE_HTTPS_ENABLED
Type: boolean Default: true Since: v5.83.0
https에 대한 계측을 활성화해요. 비활성화하면 https 작업에 대한 스팬이 생성되지 않아요.
IOREDIS
(1)
DD_TRACE_IOREDIS_ENABLED
Type: boolean Default: true Since: v5.83.0
ioredis에 대한 계측을 활성화해요. 비활성화하면 ioredis 작업에 대한 스팬이 생성되지 않아요.
IOVALKEY
(1)
DD_TRACE_IOVALKEY_ENABLED
Type: boolean Default: true Since: v5.83.0
iovalkey에 대한 계측을 활성화해요. 비활성화하면 iovalkey 작업에 대한 스팬이 생성되지 않아요.
JEST
(1)
DD_TRACE_JEST_ENABLED
Type: boolean Default: true Since: v5.83.0
jest에 대한 계측을 활성화해요. 비활성화하면 jest 작업에 대한 스팬이 생성되지 않아요.
JEST_CIRCUS
(1)
DD_TRACE_JEST_CIRCUS_ENABLED
Type: boolean Default: true Since: v5.83.0
jest circus에 대한 계측을 활성화해요. 비활성화하면 jest circus 작업에 대한 스팬이 생성되지 않아요.
JEST_CONFIG
(1)
DD_TRACE_JEST_CONFIG_ENABLED
Type: boolean Default: true Since: v5.83.0
jest config에 대한 계측을 활성화해요. 비활성화하면 jest config 작업에 대한 스팬이 생성되지 않아요.
JEST_CORE
(1)
DD_TRACE_JEST_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
jest core에 대한 계측을 활성화해요. 비활성화하면 jest core 작업에 대한 스팬이 생성되지 않아요.
JEST_ENVIRONMENT_JSDOM
(1)
DD_TRACE_JEST_ENVIRONMENT_JSDOM_ENABLED
Type: boolean Default: true Since: v5.83.0
jest environment jsdom에 대한 계측을 활성화해요. 비활성화하면 jest environment jsdom 작업에 대한 스팬이 생성되지 않아요.
JEST_ENVIRONMENT_NODE
(1)
DD_TRACE_JEST_ENVIRONMENT_NODE_ENABLED
Type: boolean Default: true Since: v5.83.0
jest environment node에 대한 계측을 활성화해요. 비활성화하면 jest environment node 작업에 대한 스팬이 생성되지 않아요.
JEST_GLOBALS
(1)
DD_TRACE_JEST_GLOBALS_ENABLED
Type: boolean Default: true Since: v5.83.0
jest globals에 대한 계측을 활성화해요. 비활성화하면 jest globals 작업에 대한 스팬이 생성되지 않아요.
JEST_REPORTERS
(1)
DD_TRACE_JEST_REPORTERS_ENABLED
Type: boolean Default: true Since: v5.83.0
jest reporters에 대한 계측을 활성화해요. 비활성화하면 jest reporters 작업에 대한 스팬이 생성되지 않아요.
JEST_RUNTIME
(1)
DD_TRACE_JEST_RUNTIME_ENABLED
Type: boolean Default: true Since: v5.83.0
jest runtime에 대한 계측을 활성화해요. 비활성화하면 jest runtime 작업에 대한 스팬이 생성되지 않아요.
JEST_TEST_SEQUENCER
(1)
DD_TRACE_JEST_TEST_SEQUENCER_ENABLED
Type: boolean Default: true Since: v5.83.0
jest test sequencer에 대한 계측을 활성화해요. 비활성화하면 jest test sequencer 작업에 대한 스팬이 생성되지 않아요.
JEST_TRANSFORM
(1)
DD_TRACE_JEST_TRANSFORM_ENABLED
Type: boolean Default: true Since: v5.83.0
jest transform에 대한 계측을 활성화해요. 비활성화하면 jest transform 작업에 대한 스팬이 생성되지 않아요.
JEST_WORKER
(1)
DD_TRACE_JEST_WORKER_ENABLED
Type: boolean Default: true Since: v5.83.0
jest worker에 대한 계측을 활성화해요. 비활성화하면 jest worker 작업에 대한 스팬이 생성되지 않아요.
KAFKAJS
(1)
DD_TRACE_KAFKAJS_ENABLED
Type: boolean Default: true Since: v5.83.0
kafkajs에 대한 계측을 활성화해요. 비활성화하면 kafkajs 작업에 대한 스팬이 생성되지 않아요.
KNEX
(1)
DD_TRACE_KNEX_ENABLED
Type: boolean Default: true Since: v5.83.0
knex에 대한 계측을 활성화해요. 비활성화하면 knex 작업에 대한 스팬이 생성되지 않아요.
KOA
(1)
DD_TRACE_KOA_ENABLED
Type: boolean Default: true Since: v5.83.0
koa에 대한 계측을 활성화해요. 비활성화하면 koa 작업에 대한 스팬이 생성되지 않아요.
KOA_ROUTE
(1)
DD_TRACE_KOA_ROUTE_ENABLED
Type: boolean Default: true Since: v5.83.0
koa route에 대한 계측을 활성화해요. 비활성화하면 koa route 작업에 대한 스팬이 생성되지 않아요.
KOA_ROUTER
(1)
DD_TRACE_KOA_ROUTER_ENABLED
Type: boolean Default: true Since: v5.83.0
koa router에 대한 계측을 활성화해요. 비활성화하면 koa router 작업에 대한 스팬이 생성되지 않아요.
KOA_WEBSOCKET
(1)
DD_TRACE_KOA_WEBSOCKET_ENABLED
Type: boolean Default: true Since: v5.83.0
koa websocket에 대한 계측을 활성화해요. 비활성화하면 koa websocket 작업에 대한 스팬이 생성되지 않아요.
LAMBDA
(1)
DD_LAMBDA_HANDLER
Type: string Since: v5.83.0
- 원래 핸들러로 환경 변수
DD_LAMBDA_HANDLER을 설정해요, 예:myfunc.handler.
LANGCHAIN
(3)
DD_LANGCHAIN_SPAN_CHAR_LIMIT
Type: int Default: 128 Since: v5.83.0
langchain 스팬 데이터에 기록되는 최대 문자 수예요.
DD_LANGCHAIN_SPAN_PROMPT_COMPLETION_SAMPLE_RATE
Type: decimal Default: 1 Since: v5.83.0
스팬에서 LangChain 프롬프트 및 완료 내용 캡처의 샘플링 비율을 제어해요.
DD_TRACE_LANGCHAIN_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain에 대한 계측을 활성화해요. 비활성화하면 langchain 작업에 대한 스팬이 생성되지 않아요.
LANGCHAIN_ANTHROPIC
(1)
DD_TRACE_LANGCHAIN_ANTHROPIC_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain anthropic에 대한 계측을 활성화해요. 비활성화하면 langchain anthropic 작업에 대한 스팬이 생성되지 않아요.
LANGCHAIN_COHERE
(1)
DD_TRACE_LANGCHAIN_COHERE_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain cohere에 대한 계측을 활성화해요. 비활성화하면 langchain cohere 작업에 대한 스팬이 생성되지 않아요.
LANGCHAIN_CORE
(1)
DD_TRACE_LANGCHAIN_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain core에 대한 계측을 활성화해요. 비활성화하면 langchain core 작업에 대한 스팬이 생성되지 않아요.
LANGCHAIN_GOOGLE_GENAI
(1)
DD_TRACE_LANGCHAIN_GOOGLE_GENAI_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain google genai에 대한 계측을 활성화해요. 비활성화하면 langchain google genai 작업에 대한 스팬이 생성되지 않아요.
LANGCHAIN_OPENAI
(1)
DD_TRACE_LANGCHAIN_OPENAI_ENABLED
Type: boolean Default: true Since: v5.83.0
langchain openai에 대한 계측을 활성화해요. 비활성화하면 langchain openai 작업에 대한 스팬이 생성되지 않아요.
LANGGRAPH
(1)
DD_TRACE_LANGGRAPH_ENABLED
Type: boolean Default: true Since: v5.91.0
LangGraph 통합을 활성화하려면 사용해요.
LDAPJS
(1)
DD_TRACE_LDAPJS_ENABLED
Type: boolean Default: true Since: v5.83.0
ldapjs에 대한 계측을 활성화해요. 비활성화하면 ldapjs 작업에 대한 스팬이 생성되지 않아요.
LDAPJS_PROMISE
(1)
DD_TRACE_LDAPJS_PROMISE_ENABLED
Type: boolean Default: true Since: v5.83.0
ldapjs promise에 대한 계측을 활성화해요. 비활성화하면 ldapjs promise 작업에 대한 스팬이 생성되지 않아요.
LEGACY_BAGGAGE
(1)
DD_TRACE_LEGACY_BAGGAGE_ENABLED
Type: boolean Default: true Since: v5.83.0
legacy baggage에 대한 계측을 활성화해요. 비활성화하면 legacy baggage 작업에 대한 스팬이 생성되지 않아요.
LIMITD_CLIENT
(1)
DD_TRACE_LIMITD_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
limitd client에 대한 계측을 활성화해요. 비활성화하면 limitd client 작업에 대한 스팬이 생성되지 않아요.
LODASH
(1)
DD_TRACE_LODASH_ENABLED
Type: boolean Default: true Since: v5.83.0
lodash에 대한 계측을 활성화해요. 비활성화하면 lodash 작업에 대한 스팬이 생성되지 않아요.
LOOPBACK
(1)
DD_TRACE_LOOPBACK_ENABLED
Type: boolean Default: true Since: v5.83.0
loopback에 대한 계측을 활성화해요. 비활성화하면 loopback 작업에 대한 스팬이 생성되지 않아요.
MARIADB
(1)
DD_TRACE_MARIADB_ENABLED
Type: boolean Default: true Since: v5.83.0
mariadb에 대한 계측을 활성화해요. 비활성화하면 mariadb 작업에 대한 스팬이 생성되지 않아요.
MEMCACHED
(1)
DD_TRACE_MEMCACHED_ENABLED
Type: boolean Default: true Since: v5.83.0
memcached에 대한 계측을 활성화해요. 비활성화하면 memcached 작업에 대한 스팬이 생성되지 않아요.
MEMCACHED_COMMAND
(1)
DD_TRACE_MEMCACHED_COMMAND_ENABLED
Type: boolean Default: false Since: v5.83.0
DD_TRACE_MEMCACHED_COMMAND_ENABLED가 활성화된 경우 memcached 명령 태깅을 활성화해요.
MICROGATEWAY_CORE
(1)
DD_TRACE_MICROGATEWAY_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
microgateway core에 대한 계측을 활성화해요. 비활성화하면 microgateway core 작업에 대한 스팬이 생성되지 않아요.
MIDDIE
(1)
DD_TRACE_MIDDIE_ENABLED
Type: boolean Default: true Since: v5.83.0
middie에 대한 계측을 활성화해요. 비활성화하면 middie 작업에 대한 스팬이 생성되지 않아요.
MIDDLEWARE_TRACING
(1)
DD_TRACE_MIDDLEWARE_TRACING_ENABLED
Type: boolean Default: true Since: v5.83.0
middleware tracing에 대한 계측을 활성화해요. 비활성화하면 middleware tracing 작업에 대한 스팬이 생성되지 않아요.
MOCHA
(1)
DD_TRACE_MOCHA_ENABLED
Type: boolean Default: true Since: v5.83.0
mocha에 대한 계측을 활성화해요. 비활성화하면 mocha 작업에 대한 스팬이 생성되지 않아요.
MOCHA_EACH
(1)
DD_TRACE_MOCHA_EACH_ENABLED
Type: boolean Default: true Since: v5.83.0
mocha each에 대한 계측을 활성화해요. 비활성화하면 mocha each 작업에 대한 스팬이 생성되지 않아요.
MOLECULER
(1)
DD_TRACE_MOLECULER_ENABLED
Type: boolean Default: true Since: v5.83.0
moleculer에 대한 계측을 활성화해요. 비활성화하면 moleculer 작업에 대한 스팬이 생성되지 않아요.
MONGODB
(1)
DD_TRACE_MONGODB_ENABLED
Type: boolean Default: true Since: v5.83.0
mongodb에 대한 계측을 활성화해요. 비활성화하면 mongodb 작업에 대한 스팬이 생성되지 않아요.
MONGODB_CORE
(1)
DD_TRACE_MONGODB_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
mongodb core에 대한 계측을 활성화해요. 비활성화하면 mongodb core 작업에 대한 스팬이 생성되지 않아요.
MONGODB_HEARTBEAT
(1)
DD_TRACE_MONGODB_HEARTBEAT_ENABLED
Type: boolean Default: true Since: v5.83.0
mongodb heartbeat에 대한 계측을 활성화해요. 비활성화하면 mongodb heartbeat 작업에 대한 스팬이 생성되지 않아요.
MONGOOSE
(1)
DD_TRACE_MONGOOSE_ENABLED
Type: boolean Default: true Since: v5.83.0
mongoose에 대한 계측을 활성화해요. 비활성화하면 mongoose 작업에 대한 스팬이 생성되지 않아요.
MQUERY
(1)
DD_TRACE_MQUERY_ENABLED
Type: boolean Default: true Since: v5.83.0
mquery에 대한 계측을 활성화해요. 비활성화하면 mquery 작업에 대한 스팬이 생성되지 않아요.
MULTER
(1)
DD_TRACE_MULTER_ENABLED
Type: boolean Default: true Since: v5.83.0
multer에 대한 계측을 활성화해요. 비활성화하면 multer 작업에 대한 스팬이 생성되지 않아요.
MYSQL
(1)
DD_TRACE_MYSQL_ENABLED
Type: boolean Default: true Since: v5.83.0
mysql에 대한 계측을 활성화해요. 비활성화하면 mysql 작업에 대한 스팬이 생성되지 않아요.
MYSQL2
(1)
DD_TRACE_MYSQL2_ENABLED
Type: boolean Default: true Since: v5.83.0
mysql2에 대한 계측을 활성화해요. 비활성화하면 mysql2 작업에 대한 스팬이 생성되지 않아요.
NET
(1)
DD_TRACE_NET_ENABLED
Type: boolean Default: true Since: v5.83.0
net에 대한 계측을 활성화해요. 비활성화하면 net 작업에 대한 스팬이 생성되지 않아요.
NEXT
(1)
DD_TRACE_NEXT_ENABLED
Type: boolean Default: true Since: v5.83.0
next에 대한 계측을 활성화해요. 비활성화하면 next 작업에 대한 스팬이 생성되지 않아요.
NODE_CHILD_PROCESS
(1)
DD_TRACE_NODE_CHILD_PROCESS_ENABLED
Type: boolean Default: true Since: v5.83.0
node child process에 대한 계측을 활성화해요. 비활성화하면 node child process 작업에 대한 스팬이 생성되지 않아요.
NODE_REDIS_CLIENT
(1)
DD_TRACE_NODE_REDIS_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
node redis client에 대한 계측을 활성화해요. 비활성화하면 node redis client 작업에 대한 스팬이 생성되지 않아요.
NODE_SERIALIZE
(1)
DD_TRACE_NODE_SERIALIZE_ENABLED
Type: boolean Default: true Since: v5.83.0
node serialize에 대한 계측을 활성화해요. 비활성화하면 node serialize 작업에 대한 스팬이 생성되지 않아요.
NYC
(1)
DD_TRACE_NYC_ENABLED
Type: boolean Default: true Since: v5.83.0
nyc에 대한 계측을 활성화해요. 비활성화하면 nyc 작업에 대한 스팬이 생성되지 않아요.
OPENAI
(3)
DD_OPENAI_LOGS_ENABLED
Type: boolean Default: false Since: v5.83.0
프롬프트와 완료를 로그로 수집하도록 활성화해요. 아래에 설명된 샘플링 비율 구성을 사용하여 수집된 프롬프트/완료 비율을 조정할 수 있어요.
DD_OPENAI_SPAN_CHAR_LIMIT
Type: int Default: 128 Since: v5.83.0
스팬 태그 내에서 다음 데이터의 최대 문자 수를 구성해요.
DD_TRACE_OPENAI_ENABLED
Type: boolean Default: true Since: v5.83.0
openai에 대한 계측을 활성화해요. 비활성화하면 openai 작업에 대한 스팬이 생성되지 않아요.
OPENSEARCH
(1)
DD_TRACE_OPENSEARCH_ENABLED
Type: boolean Default: true Since: v5.83.0
opensearch에 대한 계측을 활성화해요. 비활성화하면 opensearch 작업에 대한 스팬이 생성되지 않아요.
OPENSEARCH_PROJECT_OPENSEARCH
(1)
DD_TRACE_OPENSEARCH_PROJECT_OPENSEARCH_ENABLED
Type: boolean Default: true Since: v5.83.0
opensearch project opensearch에 대한 계측을 활성화해요. 비활성화하면 opensearch project opensearch 작업에 대한 스팬이 생성되지 않아요.
OPENTELEMETRY_SDK_TRACE_NODE
(1)
DD_TRACE_OPENTELEMETRY_SDK_TRACE_NODE_ENABLED
Type: boolean Default: true Since: v5.83.0
opentelemetry sdk trace node에 대한 계측을 활성화해요. 비활성화하면 opentelemetry sdk trace node 작업에 대한 스팬이 생성되지 않아요.
ORACLEDB
(1)
DD_TRACE_ORACLEDB_ENABLED
Type: boolean Default: true Since: v5.83.0
oracledb에 대한 계측을 활성화해요. 비활성화하면 oracledb 작업에 대한 스팬이 생성되지 않아요.
PASSPORT
(1)
DD_TRACE_PASSPORT_ENABLED
Type: boolean Default: true Since: v5.83.0
passport에 대한 계측을 활성화해요. 비활성화하면 passport 작업에 대한 스팬이 생성되지 않아요.
PASSPORT_HTTP
(1)
DD_TRACE_PASSPORT_HTTP_ENABLED
Type: boolean Default: true Since: v5.83.0
passport http에 대한 계측을 활성화해요. 비활성화하면 passport http 작업에 대한 스팬이 생성되지 않아요.
PASSPORT_LOCAL
(1)
DD_TRACE_PASSPORT_LOCAL_ENABLED
Type: boolean Default: true Since: v5.83.0
passport local에 대한 계측을 활성화해요. 비활성화하면 passport local 작업에 대한 스팬이 생성되지 않아요.
PG
(1)
DD_TRACE_PG_ENABLED
Type: boolean Default: true Since: v5.83.0
pg에 대한 계측을 활성화해요. 비활성화하면 pg 작업에 대한 스팬이 생성되지 않아요.
PG_CURSOR
(1)
DD_TRACE_PG_CURSOR_ENABLED
Type: boolean Default: true Since: v5.83.0
pg cursor에 대한 계측을 활성화해요. 비활성화하면 pg cursor 작업에 대한 스팬이 생성되지 않아요.
PG_NATIVE
(1)
DD_TRACE_PG_NATIVE_ENABLED
Type: boolean Default: true Since: v5.83.0
pg native에 대한 계측을 활성화해요. 비활성화하면 pg native 작업에 대한 스팬이 생성되지 않아요.
PG_QUERY_STREAM
(1)
DD_TRACE_PG_QUERY_STREAM_ENABLED
Type: boolean Default: true Since: v5.83.0
pg query stream에 대한 계측을 활성화해요. 비활성화하면 pg query stream 작업에 대한 스팬이 생성되지 않아요.
PINO
(1)
DD_TRACE_PINO_ENABLED
Type: boolean Default: true Since: v5.83.0
pino에 대한 계측을 활성화해요. 비활성화하면 pino 작업에 대한 스팬이 생성되지 않아요.
PINO_PRETTY
(1)
DD_TRACE_PINO_PRETTY_ENABLED
Type: boolean Default: true Since: v5.83.0
pino pretty에 대한 계측을 활성화해요. 비활성화하면 pino pretty 작업에 대한 스팬이 생성되지 않아요.
PLAYWRIGHT
(1)
DD_TRACE_PLAYWRIGHT_ENABLED
Type: boolean Default: true Since: v5.83.0
playwright에 대한 계측을 활성화해요. 비활성화하면 playwright 작업에 대한 스팬이 생성되지 않아요.
PLAYWRIGHT_CORE
(1)
DD_TRACE_PLAYWRIGHT_CORE_ENABLED
Type: boolean Default: true Since: v5.83.0
playwright core에 대한 계측을 활성화해요. 비활성화하면 playwright core 작업에 대한 스팬이 생성되지 않아요.
PLAYWRIGHT_TEST
(1)
DD_TRACE_PLAYWRIGHT_TEST_ENABLED
Type: boolean Default: true Since: v5.83.0
playwright test에 대한 계측을 활성화해요. 비활성화하면 playwright test 작업에 대한 스팬이 생성되지 않아요.
PRISMA
(1)
DD_TRACE_PRISMA_ENABLED
Type: boolean Default: true Since: v5.83.0
prisma에 대한 계측을 활성화해요. 비활성화하면 prisma 작업에 대한 스팬이 생성되지 않아요.
PROCESS
(1)
DD_TRACE_PROCESS_ENABLED
**Type: boolean**Default**:true**Since**:v5.83.0`
process에 대한 계측을 활성화해요. 비활성화하면 process 작업에 대한 스팬이 생성되지 않아요.
PROMISE
(1)
DD_TRACE_PROMISE_ENABLED
Type: boolean Default: true Since: v5.83.0
promise에 대한 계측을 활성화해요. 비활성화하면 promise 작업에 대한 스팬이 생성되지 않아요.
PROMISE_JS
(1)
DD_TRACE_PROMISE_JS_ENABLED
Type: boolean Default: true Since: v5.83.0
promise js에 대한 계측을 활성화해요. 비활성화하면 promise js 작업에 대한 스팬이 생성되지 않아요.
PROTOBUFJS
(1)
DD_TRACE_PROTOBUFJS_ENABLED
Type: boolean Default: true Since: v5.83.0
protobufjs에 대한 계측을 활성화해요. 비활성화하면 protobufjs 작업에 대한 스팬이 생성되지 않아요.
PUG
(1)
DD_TRACE_PUG_ENABLED
Type: boolean Default: true Since: v5.83.0
pug에 대한 계측을 활성화해요. 비활성화하면 pug 작업에 대한 스팬이 생성되지 않아요.
Q
(1)
DD_TRACE_Q_ENABLED
Type: boolean Default: true Since: v5.83.0
q에 대한 계측을 활성화해요. 비활성화하면 q 작업에 대한 스팬이 생성되지 않아요.
REACT
(1)
DD_TRACE_REACT_ENABLED
Type: boolean Default: true Since: v5.83.0
react에 대한 계측을 활성화해요. 비활성화하면 react 작업에 대한 스팬이 생성되지 않아요.
REACT_DOM
(1)
DD_TRACE_REACT_DOM_ENABLED
Type: boolean Default: true Since: v5.83.0
react dom에 대한 계측을 활성화해요. 비활성화하면 react dom 작업에 대한 스팬이 생성되지 않아요.
REDIS
(1)
DD_TRACE_REDIS_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_TRACE_INTEGRATION_REDIS_ENABLED, DD_INTEGRATION_REDIS_ENABLED
redis에 대한 계측을 활성화해요. 비활성화하면 redis 작업에 대한 스팬이 생성되지 않아요.
REDIS_CLIENT
(1)
DD_TRACE_REDIS_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
redis client에 대한 계측을 활성화해요. 비활성화하면 redis client 작업에 대한 스팬이 생성되지 않아요.
REQUEST
(1)
DD_TRACE_REQUEST_ENABLED
Type: boolean Default: true Since: v5.83.0
request에 대한 계측을 활성화해요. 비활성화하면 request 작업에 대한 스팬이 생성되지 않아요.
RESTIFY
(1)
DD_TRACE_RESTIFY_ENABLED
Type: boolean Default: true Since: v5.83.0
restify에 대한 계측을 활성화해요. 비활성화하면 restify 작업에 대한 스팬이 생성되지 않아요.
RHEA
(1)
DD_TRACE_RHEA_ENABLED
Type: boolean Default: true Since: v5.83.0
rhea에 대한 계측을 활성화해요. 비활성화하면 rhea 작업에 대한 스팬이 생성되지 않아요.
ROUTER
(1)
DD_TRACE_ROUTER_ENABLED
Type: boolean Default: true Since: v5.83.0
router에 대한 계측을 활성화해요. 비활성화하면 router 작업에 대한 스팬이 생성되지 않아요.
SELENIUM_WEBDRIVER
(1)
DD_TRACE_SELENIUM_WEBDRIVER_ENABLED
Type: boolean Default: true Since: v5.83.0
selenium webdriver에 대한 계측을 활성화해요. 비활성화하면 selenium webdriver 작업에 대한 스팬이 생성되지 않아요.
SEQUELIZE
(1)
DD_TRACE_SEQUELIZE_ENABLED
Type: boolean Default: true Since: v5.83.0
sequelize에 대한 계측을 활성화해요. 비활성화하면 sequelize 작업에 대한 스팬이 생성되지 않아요.
SHAREDB
(1)
DD_TRACE_SHAREDB_ENABLED
Type: boolean Default: true Since: v5.83.0
sharedb에 대한 계측을 활성화해요. 비활성화하면 sharedb 작업에 대한 스팬이 생성되지 않아요.
SMITHY_SMITHY_CLIENT
(1)
DD_TRACE_SMITHY_SMITHY_CLIENT_ENABLED
Type: boolean Default: true Since: v5.83.0
smithy smithy client에 대한 계측을 활성화해요. 비활성화하면 smithy smithy client 작업에 대한 스팬이 생성되지 않아요.
SQLITE3
(1)
DD_TRACE_SQLITE3_ENABLED
Type: boolean Default: true Since: v5.83.0
sqlite3에 대한 계측을 활성화해요. 비활성화하면 sqlite3 작업에 대한 스팬이 생성되지 않아요.
SUFFIXPLUGIN
(1)
DD_TRACE_SUFFIXPLUGIN_ENABLED
Type: boolean Default: true Since: v5.83.0
suffixplugin에 대한 계측을 활성화해요. 비활성화하면 suffixplugin 작업에 대한 스팬이 생성되지 않아요.
TEDIOUS
(1)
DD_TRACE_TEDIOUS_ENABLED
Type: boolean Default: true Since: v5.83.0
tedious에 대한 계측을 활성화해요. 비활성화하면 tedious 작업에 대한 스팬이 생성되지 않아요.
UNDICI
(1)
DD_TRACE_UNDICI_ENABLED
Type: boolean Default: true Since: v5.83.0
undici에 대한 계측을 활성화해요. 비활성화하면 undici 작업에 대한 스팬이 생성되지 않아요.
URL
(1)
DD_TRACE_URL_ENABLED
Type: boolean Default: true Since: v5.83.0
url에 대한 계측을 활성화해요. 비활성화하면 url 작업에 대한 스팬이 생성되지 않아요.
VERTEXAI
(2)
DD_VERTEXAI_SPAN_CHAR_LIMIT
Type: int Default: 128 Since: v5.83.0
vertexai 스팬 데이터에 기록되는 최대 문자 수예요.
DD_VERTEXAI_SPAN_PROMPT_COMPLETION_SAMPLE_RATE
Type: decimal Default: 1 Since: v5.83.0
스팬에서 Vertex AI 프롬프트 및 완료 내용 캡처의 샘플링 비율을 제어해요.
VITEST
(1)
DD_TRACE_VITEST_ENABLED
Type: boolean Default: true Since: v5.83.0
vitest에 대한 계측을 활성화해요. 비활성화하면 vitest 작업에 대한 스팬이 생성되지 않아요.
VITEST_RUNNER
(1)
DD_TRACE_VITEST_RUNNER_ENABLED
Type: boolean Default: true Since: v5.83.0
vitest runner에 대한 계측을 활성화해요. 비활성화하면 vitest runner 작업에 대한 스팬이 생성되지 않아요.
VM
(1)
DD_TRACE_VM_ENABLED
Type: boolean Default: true Since: v5.83.0
vm에 대한 계측을 활성화해요. 비활성화하면 vm 작업에 대한 스팬이 생성되지 않아요.
WEBSOCKET_MESSAGES
(2)
DD_TRACE_WEBSOCKET_MESSAGES_ENABLED
Type: boolean Default: true Since: v5.83.0
보내고 받은 웹소켓 메시지(텍스트 및 바이너리)와 연결 종료 이벤트의 추적을 활성화해요.
DD_TRACE_WEBSOCKET_MESSAGES_SEPARATE_TRACES
Type: boolean Default: true Since: v5.83.0
기본적으로 각 수신 메시지는 새 트레이스를 생성해요. 핸드셰이크는 스팬 링크로 연결돼요. 이 매개변수를 false로 설정하면 세션 중에 캡처된 모든 스팬이 동일한 트레이스에 있게 돼요.
WHEN
(1)
DD_TRACE_WHEN_ENABLED
Type: boolean Default: true Since: v5.83.0
when에 대한 계측을 활성화해요. 비활성화하면 when 작업에 대한 스팬이 생성되지 않아요.
WINSTON
(1)
DD_TRACE_WINSTON_ENABLED
Type: boolean Default: true Since: v5.83.0
winston에 대한 계측을 활성화해요. 비활성화하면 winston 작업에 대한 스팬이 생성되지 않아요.
WORKERPOOL
(1)
DD_TRACE_WORKERPOOL_ENABLED
Type: boolean Default: true Since: v5.83.0
workerpool에 대한 계측을 활성화해요. 비활성화하면 workerpool 작업에 대한 스팬이 생성되지 않아요.
WS
(1)
DD_TRACE_WS_ENABLED
Type: boolean Default: true Since: v5.83.0
ws에 대한 계측을 활성화해요. 비활성화하면 ws 작업에 대한 스팬이 생성되지 않아요.
은퇴한 키 (Retired keys)
(1)
이 키들은 현재 버전의 라이브러리에서 더 이상 지원되지 않아요. 이전 버전을 실행 중이라면 참고용으로 나열돼 있어요.
DD_TRACE_DD_TRACE_API_ENABLED
Removed in v5.88.0. Since: v5.83.0
dd trace api에 대한 계측을 활성화해요. 비활성화하면 dd trace api 작업에 대한 스팬이 생성되지 않아요.
Database Monitoring
(2)
Database Monitoring(DBM): 데이터베이스 성능과 애플리케이션 트레이스를 상호 연결하기 위한 SQL 주석 전파 모드와 쿼리 식별자 해싱.
DD_DBM_INJECT_SQL_BASEHASH
Type: boolean Default: false Since: v5.88.0
DBM 전파도 활성화된 경우 SQL 쿼리에 "base hash" 주입을 활성화해요. 이 base hash는 일치하는 스팬을 찾고 쿼리를 관련 값으로 보강하는 데 사용돼요.
DD_DBM_PROPAGATION_MODE
Type: string Default: disabled Since: v5.83.0
service 또는 full로 설정하면 APM에서 전송된 데이터와 Database Monitoring 제품 사이의 연결을 활성화해요. service 옵션은 DBM과 APM 서비스 간 연결을 활성화해요. full 옵션은 데이터베이스 스팬과 데이터베이스 쿼리 이벤트 간 연결을 활성화해요. Postgres 및 MySQL에 사용할 수 있어요.
트레이스 로깅 (Trace Logging)
(6)
트레이서 로그 출력 설정: 로그 수준, 로그 파일 경로, 로그 순환, 시작 진단.
DD_LOG_LEVEL
Type: string Since: v5.88.0
Datadog 로깅 수준을 설정해요. 유효한 값은 trace, debug, info, warn, error, critical 또는 off예요.
DD_TRACE_BEAUTIFUL_LOGS
Type: boolean Default: false Since: v5.83.0
트레이서 디버그 로그의 JSON 페이로드를 예쁘게 출력해요(들여쓰기 추가).
DD_TRACE_DEBUG
Type: boolean Default: false Since: v5.88.0 Aliases:OTEL_LOG_LEVEL
SDK에 대한 디버그 모드를 활성화해요. 설정하면 SDK는 문제 해결을 위해 자세한 로그 메시지를 내보내요. 활성화되면 DD_TRACE_LOG_LEVEL보다 우선해요. 별칭으로 OTEL_LOG_LEVEL을 사용해요.
언어별 참고 사항:
- PHP: 로그 메시지는 PHP
error_logINI 설정에 설정된 장치 또는 파일에 기록돼요. PHP-FPM/Apache 구성 파일에서 재정의될 수 있기 때문에 실제 값은php -i출력과 다를 수 있어요.
DD_TRACE_ENCODING_DEBUG
Type: boolean Default: false Since: v5.83.0
직렬화 및 페이로드 형식 문제를 해결하기 위해 트레이스 인코딩 디버그 진단을 활성화해요.
DD_TRACE_EXPERIMENTAL_STATE_TRACKING
Type: boolean Default: false Since: v5.83.0
진단 및 문제 해결을 위한 실험적인 내부 트레이서 상태 추적을 활성화해요.
DD_TRACE_LOG_LEVEL
Type: string Default: debug Since: v5.88.0 Aliases:DD_LOG_LEVEL, OTEL_LOG_LEVEL
디버그 로깅이 활성화될 때 트레이서가 사용하는 최소 로그 수준을 나타내는 문자열이에요. 가능한 수준은 info, warn, error, debug예요.
연속 프로파일링 (Continuous Profiling)
(25)
연속 프로파일러 구성: 활성화/비활성화, 업로드 설정, 프로파일링 유형, 엔진 옵션, 코드 핫스팟, 엔드포인트 프로파일링, 실험 기능.
DD_EXPERIMENTAL_PROFILING_ENABLED
Type: boolean Default: false Since: v5.88.0 Aliases:DD_PROFILING_ENABLED
트레이서에서 실험적인 프로파일링 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_PROFILING_ASYNC_CONTEXT_FRAME_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서에서 프로파일링 비동기 컨텍스트 프레임 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_PROFILING_CODEHOTSPOTS_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_PROFILING_EXPERIMENTAL_CODEHOTSPOTS_ENABLED
연속 프로파일러에 대한 코드 핫스팟 수집을 활성화하거나 비활성화해요. 비활성화하면 프로파일링 데이터가 핫스팟 귀속을 위해 추적 컨텍스트에 연결되지 않아요.
DD_PROFILING_CPU_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_PROFILING_EXPERIMENTAL_CPU_ENABLED
false로 설정하면 CPU 프로파일링이 비활성화돼요. 기본값은 true예요.
DD_PROFILING_DEBUG_SOURCE_MAPS
Type: boolean Default: false Since: v5.83.0
소스 맵 조회 및 심볼화 동작을 해결하기 위한 프로파일링 소스 맵 디버그 진단을 활성화해요.
DD_PROFILING_DEBUG_UPLOAD_COMPRESSION
Type: string Default: zstd Since: v5.83.0 Aliases:DD_PROFILING_UPLOAD_COMPRESSION
프로파일링 업로드: 프로파일 업로드의 압축 유형. 지원 값: on(zstd와 동일), off, lz4, gzip, zstd. 기본값: zstd.
DD_PROFILING_ENABLED
Type: boolean Default: false Since: v5.83.0 Aliases:DD_EXPERIMENTAL_PROFILING_ENABLED
CPU, 힙, 고루틴 및 기타 런타임 프로파일을 수집하여 Datadog에 업로드하는 연속 프로파일러를 활성화해요.
DD_PROFILING_ENDPOINT_COLLECTION_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED
스팬이 Datadog UI에서 엔드포인트별로 프로파일을 그룹화할 수 있도록 최상위 요청 엔드포인트가 있는 pprof 라벨을 추가하는지 제어해요.
DD_PROFILING_EXPERIMENTAL_CODEHOTSPOTS_ENABLED
Type: boolean Default: true Since: v5.88.0 Aliases:DD_PROFILING_CODEHOTSPOTS_ENABLED
실험이 아닌 환경 변수를 우선시하고 실험적인 것들에 대해 경고해요.
DD_PROFILING_EXPERIMENTAL_CPU_ENABLED
Type: boolean Default: true Since: v5.88.0 Aliases:DD_PROFILING_CPU_ENABLED
false로 설정하면 CPU 프로파일링이 비활성화돼요. 기본값은 true예요.
DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED
Type: boolean Default: true Since: v5.88.0 Aliases:DD_PROFILING_ENDPOINT_COLLECTION_ENABLED
트레이서에서 프로파일링 실험 엔드포인트 수집 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_PROFILING_EXPERIMENTAL_OOM_EXPORT_STRATEGIES
Type: string Default: process Since: v5.83.0
OOM 시 비동기 콜백으로 힙 프로파일을 전송해요.
DD_PROFILING_EXPERIMENTAL_OOM_HEAP_LIMIT_EXTENSION_SIZE
Type: int Default: 0 Since: v5.83.0
OOM 시 비동기 콜백으로 힙 프로파일을 전송해요.
DD_PROFILING_EXPERIMENTAL_OOM_MAX_HEAP_EXTENSION_COUNT
Type: int Default: 0 Since: v5.83.0
OOM 시 비동기 콜백으로 힙 프로파일을 전송해요.
DD_PROFILING_EXPERIMENTAL_OOM_MONITORING_ENABLED
Type: boolean Default: true Since: v5.83.0
OOM 힙 프로파일러 구성을 지원해요.
DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED
Type: boolean Default: true Since: v5.88.0 Aliases:DD_PROFILING_TIMELINE_ENABLED
- 환경 변수
DD_PROFILING_TIMELINE_ENABLED를true로 설정해요.
DD_PROFILING_EXPORTERS
Type: string Default: agent Since: v5.83.0
코드 핫스팟 및 엔드포인트 추적이 동작해요.
DD_PROFILING_HEAP_ENABLED
Type: boolean Default: false Since: v5.83.0
true로 설정하면 Live Heap 프로파일링(Preview)을 활성화해요. 기본값은 false예요.
DD_PROFILING_HEAP_SAMPLING_INTERVAL
Type: int Default: 524288 Since: v5.83.0
힙 프로파일러 샘플링 간격을 설정하여 메모리 프로파일링 세분성과 런타임 오버헤드에 영향을 미쳐요.
DD_PROFILING_PPROF_PREFIX
Type: string Since: v5.83.0
생성된 pprof 프로파일 파일의 파일명 접두사를 설정하여 프로파일러 출력 명명을 제어해요.
DD_PROFILING_PROFILERS
Type: string Default: space,wall Since: v5.83.0
DD_PROFILING_PROFILERS로 프로파일러 구성을 지원해요.
DD_PROFILING_SOURCE_MAP
Type: boolean Default: true Since: v5.83.0
프로파일러가 생성된 스택 프레임을 원래 소스 위치로 매핑하는 데 사용하는 소스 맵 해석을 구성해요.
DD_PROFILING_TIMELINE_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED
타임라인 프로파일 유형을 활성화해요.
참고: 이 값은 DD_PROFILING_EXPERIMENTAL_TIMELINE_ENABLED 환경 변수(datadog.profiling.experimental_timeline_enabled INI 설정)를 대체해요. 둘 다 설정되면 이 값이 우선해요.
언어별 참고 사항:
- PHP: This supersedes the
datadog.profiling.experimental_timeline_enabledINI setting, which was available since0.89.
DD_PROFILING_UPLOAD_TIMEOUT
Type: int Default: 60000 Since: v5.88.0
각 업로드 사이의 시간(밀리초)이에요.
DD_PROFILING_V8_PROFILER_BUG_WORKAROUND
Type: boolean Default: true Since: v5.83.0
DD_PROFILING_PROFILERS로 프로파일러 구성을 지원해요.
애플리케이션 보안 (Application Security)
(37)
애플리케이션 보안 구성: ASM 위협 탐지 및 차단, 사용자 이벤트 추적, IAST 취약점 탐지, API Security 스키마 탐색, 오류 추적.
DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE
Type: decimal Default: 0.5 Since: v5.87.0
다운스트림 요청 본문이 샘플링될 확률을 정의해요. 즉, 요청/응답 본문을 샘플링/분석해야 하는 전체 요청 수를 정의해요.
DD_API_SECURITY_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_EXPERIMENTAL_API_SECURITY_ENABLED
API Security 기능을 활성화할지 제어해요. 설정하지 않으면 API Security가 기본적으로 활성화돼요.
DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED
Type: boolean Default: true Since: v5.83.0
API Catalog에서 사용하기 위해 API 엔드포인트 정의를 수집하고 보고할지 제어해요. 엔드포인트 탐색을 억제하려면 비활성화해요.
DD_API_SECURITY_ENDPOINT_COLLECTION_MESSAGE_LIMIT
Type: int Default: 300 Since: v5.83.0
단일 엔드포인트 수집 텔레메트리 메시지에 포함되는 최대 API 엔드포인트 수를 설정해요. 설정하지 않으면 기본 제한이 사용돼요.
DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS
Type: int Default: 1 Since: v5.87.0
요청당 다운스트림 요청 수 중 요청/응답 본문을 분석해야 하는 최대 수예요.
DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE
Type: string Default: identification Since: v5.88.0 Aliases:DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING
자동 사용자 이벤트에 사용할 수집 모드를 지정해요.
DD_APPSEC_COLLECT_ALL_HEADERS
Type: boolean Default: false Since: v5.83.0
활성화하면 AppSec가 기본 허용 목록 하위 집합 대신 보안 분석을 위해 모든 요청 헤더를 수집해요. 헤더 값에는 민감한 정보가 포함될 수 있으므로 이 플래그는 주의해서 사용해야 해요. 헤더 편집 및 난독화 설정은 여전히 적용돼요. 이 플래그가 모든 헤더 수집을 강제하지 않는 한 헤더 수집 규칙(항상 수집되는 헤더와 특정 이벤트에서만 수집되는 헤더)은 계속 적용돼요.
DD_APPSEC_ENABLED
Type: boolean Since: v5.88.0
Application Security Management 기능을 활성화해요.
DD_APPSEC_GRAPHQL_BLOCKED_TEMPLATE_JSON
Type: string Since: v5.83.0
트레이서가 GraphQL 요청에 대해 차단 동작을 수행할 때 기본 백엔드 템플릿을 대체하는 로컬 JSON 응답 템플릿의 경로예요. 설정하지 않거나 파일을 읽을 수 없으면 트레이서는 기본 제공 차단 템플릿으로 대체해요.
DD_APPSEC_HEADER_COLLECTION_REDACTION_ENABLED
Type: boolean Default: true Since: v5.83.0
활성화하면 트레이서가 수집하는 모든 헤더 값에 AppSec 헤더/값 편집 정책을 적용해요. 헤더 편집은 구성된 정규식과 난독화 규칙을 사용하여 민감한 하위 문자열을 안정적인 편집 토큰으로 대체해요. 이 플래그는 AppSec 탐지 또는 텔레메트리를 위해 수집된 헤더에서 PII가 실수로 유출되는 것을 방지해요.
DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML
Type: string Since: v5.88.0
요청이 차단되고 응답이 HTML이어야 할 때 반환될 로컬 HTML 템플릿 파일의 경로예요. 설정하지 않거나 유효하지 않으면 트레이서는 제품 RFC에 정의된 기본 차단 HTML 템플릿을 사용해요. 트레이서는 Accept 헤더 또는 차단 동작의 매개변수에 따라 HTML 또는 JSON을 결정해요.
DD_APPSEC_HTTP_BLOCKED_TEMPLATE_JSON
Type: string Since: v5.88.0
요청이 차단되고 응답이 JSON이어야 할 때 반환될 로컬 JSON 템플릿 파일의 경로예요. 설정하지 않거나 유효하지 않으면 트레이서는 제품 RFC에 정의된 기본 차단 HTML 템플릿을 사용해요. 트레이서는 Accept 헤더 또는 차단 동작의 매개변수에 따라 HTML 또는 JSON을 결정해요.
DD_APPSEC_MAX_COLLECTED_HEADERS
Type: int Default: 50 Since: v5.83.0
매우 넓은 스팬/태그 벡터와 큰 페이로드를 피하기 위해 트레이서가 AppSec 용도로 저장/전달할 헤더 수를 제한해요. 구성된 상한을 초과하는 헤더는 트레이서 정책에 따라 처리돼요(건너뛰거나 이름만 수집). 이 제한은 성능과 개인정보를 보호해요. 안전한 값에 대한 지침은 헤더 수집 문서를 참고하세요.
DD_APPSEC_MAX_STACK_TRACE_DEPTH
Type: int Default: 32 Since: v5.83.0 Aliases:DD_APPSEC_MAX_STACKTRACE_DEPTH
AppSec 이벤트에 부착된 모든 스택 트레이스에 대해 유지되는 최대 스택 프레임 수예요. 한도에 도달하면 더 깊은 프레임이 잘리고 스택 상단 프레임이 보존돼요. 이벤트 페이로드 크기를 줄이려면 값을 낮춰요.
DD_APPSEC_MAX_STACK_TRACES
Type: int Default: 2 Since: v5.83.0 Aliases:DD_APPSEC_MAX_STACKTRACES
페이로드 크기를 합리적으로 유지하기 위해 AppSec/IAST 이벤트에 캡처되어 부착되는 별도의 스택 트레이스 수를 제한해요. 증거 스택 트레이스는 트라이지에 유용하지만, 무제한 캡처는 민감한 데이터를 유출하고 과도한 대역폭을 소비할 수 있어요. 이 제한은 증거 값과 안전성의 균형을 맞춰요. 모두 수집하려면 0으로 설정해요.
DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP
Type: string Default: (?i)pass|pw(?:or)?d|secret|(?:api|private|public|access)[_-]?key|token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)|bearer|authorization|jsessionid|phpsessid|asp\.net[_-]sessionid|sid|jwt Since: v5.88.0
전체 값을 편집해야 하는 매개변수 키를 식별하기 위해 AppSec 난독화기가 사용하는 정규식이에요. 키 경로가 일치하면 매개변수는 <redacted by datadog>로 대체돼요. 기본값은 일반적인 자격 증명 이름(password, token, authorization, jwt 등)과 일치해요. 키 기반 편집을 비활성화하려면 빈 문자열로 설정해요.
DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP
Type: string Default: (?i)(?:p(?:ass)?w(?:or)?d|pass(?:[_-]?phrase)?|secret(?:[_-]?key)?|(?:(?:api|private|public|access)[_-]?)key(?:[_-]?id)?|(?:(?:auth|access|id|refresh)[_-]?)?token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?|jsessionid|phpsessid|asp\.net(?:[_-]|-)sessionid|sid|jwt)(?:\s*=([^;&]+)|\"\s*:\s*(\"[^\"]+\"|\d+))|bearer\s+([a-z0-9\._\-]+)|token\s*:\s*([a-z0-9]{13})|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,}) Since: v5.88.0
공격 보고서에서 값으로 민감한 데이터를 편집하는 정규식 문자열이에요.
DD_APPSEC_RASP_COLLECT_REQUEST_BODY
Type: boolean Default: false Since: v5.83.0
RASP(런타임 익스플로잇 예방) 수집기가 탐지를 수행하거나 차단 결정을 내릴 때 요청 본문을 포함하는지 제어해요. 요청 본문에는 민감한 데이터와 큰 페이로드가 포함될 수 있으므로 수집은 크기 제한과 난독화 규칙을 따릅니다.
DD_APPSEC_RASP_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서의 RASP / 익스플로잇 예방 기능을 켜요. 활성화하면 트레이서는 동기식 사전 실행 검사를 실행하고 차단 동작이나 익스플로잇 신호를 생성할 수 있어요. RASP는 언어별로 별도의 활성화 및 구현 세부 사항이 있을 수 있어요. 활성화하면 일반적으로 추가 동기식 계측과 탐지에 대한 추가 증거 캡처가 활성화돼요.
DD_APPSEC_RULES
Type: string Since: v5.88.0
제공된 기본 규칙 파일을 재정의해요. 유효한 JSON 규칙 파일의 경로여야 해요.
DD_APPSEC_SCA_ENABLED
Type: boolean Since: v5.88.0
런타임 종속성/SBOM 정보를 보고하고 런타임 취약점 탐지를 지원하는 트레이서의 런타임 SCA(Software Composition Analysis) 기능을 활성화해요. 테스트/데모 및 프로덕션 런타임 취약점 워크플로에 유용해요. SCA에는 SCA 런북에 설명된 대로 과금/사용량 영향과 언어 호환성 제약이 있을 수 있어요.
DD_APPSEC_STACK_TRACE_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_APPSEC_STACKTRACE_ENABLED
보안 이벤트가 발생할 때 보안 관련 스택 트레이스 생성을 활성화해요.
DD_APPSEC_TRACE_RATE_LIMIT
Type: int Default: 100 Since: v5.83.0
초당 최대 AppSec 트레이스 수를 제어해요.
DD_APPSEC_WAF_TIMEOUT
Type: int Default: 5000 Since: v5.88.0
WAF 동기 실행 시간(마이크로초)을 제한해요.
DD_EXPERIMENTAL_APPSEC_STANDALONE_ENABLED
Type: boolean Default: true Since: v5.83.0
레거시 DD_EXPERIMENTAL_APPSEC_STANDALONE_ENABLED로 APM 추적을 비활성화해요.
DD_IAST_DB_ROWS_TO_TAINT
Type: int Default: 1 Since: v5.83.0
IAST: 주어진 ResultSet에 대해 오염 소스(SQL 테이블 데이터)로 처리할 JDBC ResultSet 행의 최대 수예요. 이 한도를 초과하는 행은 오염되지 않아요. 기본값: 1.
DD_IAST_DEDUPLICATION_ENABLED
Type: boolean Default: true Since: v5.83.0
취약점 중복 제거 탐지를 활성화하거나 비활성화해요. 활성화하면 취약점은 모든 발생에 대해 보고되는 대신 앱 수명 동안 한 번만 보고돼요. 기본값은 true(활성화)예요.
DD_IAST_ENABLED
Type: boolean Default: false Since: v5.88.0
IAST를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.
DD_IAST_MAX_CONCURRENT_REQUESTS
Type: int Default: 2 Since: v5.83.0
IAST가 동시에 분석하는 최대 요청 수예요. 기본값은 2예요.
DD_IAST_MAX_CONTEXT_OPERATIONS
Type: int Default: 2 Since: v5.83.0
동일한 요청에서 감지할 수 있는 코드 취약점 수를 제어해요.
DD_IAST_REDACTION_ENABLED
Type: boolean Default: true Since: v5.83.0
민감한 데이터의 IAST 편집을 활성화하거나 비활성화해요. 기본값은 TracerSettings에 있어요.
DD_IAST_REDACTION_NAME_PATTERN
Type: string Default: (?:p(?:ass)?w(?:or)?d|pass(?:_?phrase)?|secret|(?:api_?|private_?|public_?|access_?|secret_?)key(?:_?id)?|token|consumer_?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?|(?:sur|last)name|user(?:name)?|address|e?mail) Since: v5.83.0
취약점 보고서에서 민감한 소스 이름을 편집할 정규식을 지정해요.
DD_IAST_REDACTION_VALUE_PATTERN
Type: string Default: (?:bearer\s+[a-z0-9\._\-]+|glpat-[\w\-]{20}|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[\-]{5}|ssh-rsa\s*[a-z0-9/\.+]{100,})|[\w\.-]+@[a-zA-Z\d\.-]+\.[a-zA-Z]{2,}) Since: v5.83.0
취약점 보고서에서 민감한 소스 값을 편집할 정규식을 지정해요.
DD_IAST_REQUEST_SAMPLING
Type: int Default: 30 Since: v5.83.0
IAST가 분석하는 요청의 비율로, 1~100 사이예요. 기본값은 30이에요.
DD_IAST_SECURITY_CONTROLS_CONFIGURATION
Type: string Since: v5.88.0
IAST: 세미콜론으로 구분된 구성 문자열로 사용자 지정 보안 제어(새니타이저/입력 검증기)를 구성해요. 설정하면 트레이서는 지정된 클래스/메서드를 계측하는 트랜스포머를 설치하여 IAST가 특정 취약점 유형에 대해 데이터를 검증/새니타이즈된 것으로 표시할 수 있게 해요.
DD_IAST_STACK_TRACE_ENABLED
Type: boolean Default: true Since: v5.88.0 Aliases:DD_IAST_STACKTRACE_ENABLED
IAST: 활성화(기본)하면 사용자 코드 스택 트레이스를 캡처하여(스택 id를 통해) IAST 취약점 보고서에 부착해요. 취약한 코드가 실행된 위치를 찾는 데 유용해요. 이 값은 사용되지 않는 별칭 DD_IAST_STACKTRACE_ENABLED도 허용해요.
DD_IAST_TELEMETRY_VERBOSITY
Type: string Default: INFORMATION Since: v5.88.0
IAST: IAST 텔레메트리 상세 수준(OFF, MANDATORY, INFORMATION, DEBUG)을 제어해요. 트레이서 텔레메트리가 비활성화되면 OFF로 강제돼요. 기본값: INFORMATION.
동적 계측 및 디버깅 (Dynamic Instrumentation & Debugging)
(8)
원격 디버깅 기능: 라이브 프로브용 Dynamic Instrumentation, 자동 변수 캡처용 Exception Replay, 소스 수준 디버깅용 Symbol Database, 스팬을 소스 코드로 연결하는 Code Origin for Spans.
DD_CODE_ORIGIN_FOR_SPANS_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서에서 스팬에 대한 코드 출처 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_CODE_ORIGIN_FOR_SPANS_EXPERIMENTAL_EXIT_SPANS_ENABLED
Type: boolean Default: false Since: v5.83.0
트레이서에서 스팬에 대한 코드 출처 실험 종료 스팬 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT_MS
Type: int Default: 15 Since: v5.83.0
스냅샷 수집 중 변수 값 캡처의 타임아웃(밀리초)이에요.
DD_DYNAMIC_INSTRUMENTATION_ENABLED
Type: boolean Default: false Since: v5.83.0
Dynamic Instrumentation을 활성화하여 재배포 없이 Datadog UI에서 실행 중인 서비스에 로그 프로브와 메트릭 프로브를 추가할 수 있게 해요.
DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE
Type: string Since: v5.88.0
로컬 프로브 정의 JSON 파일의 경로예요. 설정하면 트레이서는 원격 구성 구독 대신 시작 시 이 파일에서 프로브 정의를 로드해요.
DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS
Type: array Since: v5.83.0
캡처된 스냅샷 데이터에서 편집할 추가 식별자 키워드의 쉼표로 구분된 목록이에요.
DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS
Type: array Since: v5.88.0
편집에서 제외할 식별자를 설정하는 환경 변수예요.
DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS
Type: int Default: 1 Since: v5.83.0
프로브 데이터 업로드 사이의 간격(초)이에요.
CI Visibility
(48)
CI Visibility 및 Test Optimization: 테스트 보고, 코드 커버리지 수집, git 메타데이터, 플래키 테스트 관리, 테스트 건너뛰기, CI 제공자 통합.
DD_ACTION_EXECUTION_ID
Type: string Since: v5.83.0
AWS CodePipeline 빌드에 대한 CI 메타데이터로 보고되는 작업 실행 ID를 설정해요. 이 값은 CodePipeline이 시작한 CodeBuild 작업을 실행할 때 CI 작업 식별자로 사용돼요.
DD_CIVISIBILITY_AGENTLESS_ENABLED
Type: boolean Default: false Since: v5.83.0
CI Visibility에 대한 에이전트리스 모드를 활성화하여 로컬 Agent 대신 Datadog intake에 테스트 데이터를 직접 전송해요.
DD_CIVISIBILITY_AGENTLESS_URL
Type: string Since: v5.83.0
에이전트리스 CI 테스트 보고에 사용되는 intake 기본 URL을 재정의해요. 설정하면 페이로드는 기본 사이트 기반 intake URL 대신 이 URL로 전송돼요.
DD_CIVISIBILITY_AUTO_INSTRUMENTATION_PROVIDER
Type: boolean Default: false Since: v5.88.0
CI Visibility에 대한 자동 계측 제공자를 식별해요. 이는 사용된 계측 방법(예: single-step, manual 등)을 추적하는 데 사용돼요.
DD_CIVISIBILITY_DANGEROUSLY_FORCE_COVERAGE
Type: boolean Default: false Since: v5.83.0
원격 설정이 비활성화하더라도 디버깅을 위해 CI Visibility 코드 커버리지 수집을 강제로 활성화해요.
DD_CIVISIBILITY_DANGEROUSLY_FORCE_TEST_SKIPPING
Type: boolean Default: false Since: v5.83.0
원격 설정이 비활성화하더라도 디버깅을 위해 테스트 건너뛰기 로직을 강제로 활성화해요.
DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED
Type: boolean Default: true Since: v5.88.0
CI Visibility Early Flake Detection(EFD)을 활성화해요. 이 기능은 백엔드 제공 실행 설정을 기반으로 플래키함을 감지하기 위해 선택된 테스트를 일찍 여러 번 실행할 수 있어요.
DD_CIVISIBILITY_ENABLED
Type: boolean Default: false Since: v5.83.0
테스트 실행에 대한 CI Visibility 계측을 활성화하여 테스트 세션, 모듈, 스위트 및 개별 테스트 결과를 Datadog에 보고해요.
DD_CIVISIBILITY_FLAKY_RETRY_COUNT
Type: int Default: 5 Since: v5.83.0
테스트 케이스당 최대 재시도 횟수를 변경하도록 음수가 아닌 숫자로 설정할 수 있어요.
DD_CIVISIBILITY_FLAKY_RETRY_ENABLED
Type: boolean Default: true Since: v5.83.0
CI Visibility 자동 테스트 재시도 기능의 킬 스위치예요. false면 원격 설정이 재시도를 활성화하더라도 실패한 테스트는 자동으로 다시 실행되지 않아요.
DD_CIVISIBILITY_GIT_UNSHALLOW_ENABLED
Type: boolean Default: true Since: v5.83.0
git 메타데이터를 검색할 때 git unshallow 프로세스를 활성화/비활성화할 수 있는 옵션을 제공해요.
DD_CIVISIBILITY_GIT_UPLOAD_ENABLED
Type: boolean Default: true Since: v5.83.0
DD_CIVISIBILITY_GIT_UPLOAD_ENABLED가 false로 설정되면 git 업로드를 비활성화해요.
DD_CIVISIBILITY_IMPACTED_TESTS_DETECTION_ENABLED
Type: boolean Default: true Since: v5.83.0
CI Visibility 영향받은 테스트 탐지(TIA)를 활성화해요. 활성화하면 영향받은 테스트 탐지가 자식 프로세스로 전파되는 실행 설정의 일부로 요청/적용돼요.
DD_CIVISIBILITY_ITR_ENABLED
Type: boolean Default: true Since: v5.83.0
CI Visibility에서 Intelligent Test Runner를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.
DD_CIVISIBILITY_MANUAL_API_ENABLED
Type: boolean Default: true Since: v5.83.0
프레임워크 자동 계측 없이 프로그래밍 방식으로 테스트 이벤트를 보고하기 위한 CI Visibility 수동 API 모드를 활성화해요.
DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS
Type: int Default: 500 Since: v5.83.0
CI Visibility(Selenium): 브라우저 테스트 끝에서 window.DD_RUM.stopSession()을 호출한 후 RUM 데이터가 플러시되도록 이 밀리초만큼 기다린 후 진행해요(기본값: 500ms).
DD_CIVISIBILITY_TEST_COMMAND
Type: string Since: v5.83.0
CI Visibility: 자식 테스트 JVM으로 전파되는 테스트 명령 문자열을 설정해요(예: mvn test 또는 gradle test). 명시적 세션 이름이 설정되지 않았을 때 CI Visibility 테스트 세션 이름을 만드는 데 사용돼요.
DD_CIVISIBILITY_TEST_MODULE_ID
Type: string Since: v5.83.0
작업자 프로세스 간 스팬을 상호 연결하는 데 사용되는 CI Visibility 테스트 모듈 식별자예요.
DD_CIVISIBILITY_TEST_SESSION_ID
Type: string Since: v5.83.0
작업자 프로세스 간 스팬을 상호 연결하는 데 사용되는 CI Visibility 테스트 세션 트레이스 식별자예요.
DD_CUSTOM_TRACE_ID
Type: string Since: v5.83.0
Jenkins Datadog Plugin이 전파하는 사용자 지정 트레이스 ID로, Jenkins 파이프라인 실행을 테스트 중인 애플리케이션이 내보낸 트레이스와 상호 연결하는 데 사용돼요.
DD_EXPERIMENTAL_TEST_OPT_GIT_CACHE_DIR
Type: string Default: ${os.tmpdir()}/dd-trace-git-cache Since: v5.83.0
Test Optimization Git 캐시를 실행 간에 유지하는 데 사용되는 디렉터리 경로예요.
DD_EXPERIMENTAL_TEST_OPT_GIT_CACHE_ENABLED
Type: boolean Default: false Since: v5.83.0
트레이서에서 실험적인 테스트 최적화 git 캐시 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_EXPERIMENTAL_TEST_OPT_SETTINGS_CACHE
Type: string Since: v5.85.0
실행 간의 반복적인 원격 구성 조회를 줄이기 위해 Test Optimization 설정 캐싱을 활성화해요.
DD_GIT_BRANCH
Type: string Since: v5.83.0
CI Visibility가 저장소 및 커밋 상호 연결에 사용하는 Git 분기 값을 재정의해요.
DD_GIT_COMMIT_AUTHOR_DATE
Type: string Since: v5.83.0
COMMIT_AUTHOR_DATE: ISO 8601 형식의 커밋 작성자 날짜를 CI 메타데이터로 보고하도록 재정의해요.
DD_GIT_COMMIT_AUTHOR_EMAIL
Type: string Since: v5.83.0
CI 메타데이터로 보고되는 git 커밋 작성자 이메일을 재정의해요.
DD_GIT_COMMIT_AUTHOR_NAME
Type: string Since: v5.83.0
CI 메타데이터로 보고되는 git 커밋 작성자 이름을 재정의해요.
DD_GIT_COMMIT_COMMITTER_DATE
Type: string Since: v5.83.0
ISO 8601 형식의 커밋 커미터 날짜를 CI 메타데이터로 보고하도록 재정의해요.
DD_GIT_COMMIT_COMMITTER_EMAIL
Type: string Since: v5.83.0
CI 메타데이터로 보고되는 git 커밋 커미터 이메일을 재정의해요.
DD_GIT_COMMIT_COMMITTER_NAME
Type: string Since: v5.83.0
CI 메타데이터로 보고되는 git 커밋 커미터 이름을 재정의해요.
DD_GIT_COMMIT_HEAD_SHA
Type: string Since: v5.83.0
CI Visibility: 현재 빌드/풀 리퀘스트의 git 헤드 커밋 SHA를 설정해요. 사용자 제공 git 메타데이터가 필요할 때 풀 리퀘스트 정보와 CI git 태그(예: git.commit.head.sha)를 채우는 데 사용돼요.
DD_GIT_COMMIT_MESSAGE
Type: string Since: v5.83.0
CI 메타데이터로 보고되는 git 커밋 메시지를 재정의해요.
DD_GIT_COMMIT_SHA
Type: string Since: v5.83.0
CI 메타데이터로 보고되고 활성화될 때 git 메타데이터 태깅에 사용되는 git 커밋 SHA를 재정의해요.
DD_GIT_FOLDER_PATH
Type: string Since: v5.83.0
jest 작업자 내부에 있으면 텔레메트리를 비활성화해요.
DD_GIT_PROPERTIES_FILE
Type: string Since: v5.83.0
jest 작업자 내부에 있으면 텔레메트리를 비활성화해요.
DD_GIT_PULL_REQUEST_BASE_BRANCH
Type: string Since: v5.83.0
CI Visibility: 풀 리퀘스트 기본/대상 분기 이름을 설정해요. 사용자 제공 git 메타데이터가 필요할 때 풀 리퀘스트 정보와 CI git 태그(예: git.pull_request.base_branch)를 채우는 데 사용돼요.
DD_GIT_PULL_REQUEST_BASE_BRANCH_SHA
Type: string Since: v5.83.0
CI 기능에 대한 git 메타데이터로 보고되는 풀 리퀘스트 기본 커밋 SHA를 재정의해요. 자동으로 감지할 수 없을 때 기본 커밋을 설정하는 데 사용해요.
DD_GIT_REPOSITORY_URL
Type: string Since: v5.83.0
CI 메타데이터로 보고되고 활성화될 때 git 메타데이터 태깅에 사용되는 git 저장소 URL을 재정의해요. URL에 포함된 자격 증명은 사용 전에 제거돼요.
DD_GIT_TAG
Type: string Since: v5.83.0
CI Visibility가 저장소 및 릴리스 상호 연결에 사용하는 Git 태그를 재정의해요.
DD_PIPELINE_EXECUTION_ID
Type: string Since: v5.83.0
AWS CodePipeline 빌드에 대한 CI 메타데이터로 보고되는 파이프라인 실행 ID를 설정해요. 이 값은 CodePipeline이 시작한 CodeBuild 작업을 실행할 때 CI 파이프라인 식별자로 사용돼요.
DD_PLAYWRIGHT_WORKER
Type: string Since: v5.83.0
CI Visibility IPC 페이로드 라우팅을 위해 Playwright 작업자 프로세스를 감지하는 데 사용되는 내부 표시(1로 설정)예요.
DD_TEST_FAILED_TEST_REPLAY_ENABLED
Type: boolean Default: true Since: v5.83.0
CI Visibility: Failed Test Replay 기능(킬 스위치)을 활성화해요. 실행 설정에서 활성화되면 트레이서는 실패한 테스트 재생을 위한 데이터를 캡처하기 위해 테스트 실행 중에 예외 재생 디버깅을 활성화해요. 기본값: true(여전히 백엔드/원격 설정으로 활성화해야 함).
DD_TEST_FLEET_CONFIG_PATH
Type: string Since: v5.83.0
구성 속성이 사용되면 통계를 비활성화해요.
DD_TEST_LOCAL_CONFIG_PATH
Type: string Since: v5.83.0
구성 속성이 사용되면 통계를 비활성화해요.
DD_TEST_MANAGEMENT_ENABLED
Type: boolean Default: true Since: v5.83.0
CI Visibility Test Management 기능(비활성화, 격리, 시도-수정(attempt-to-fix) 테스트)의 로컬 킬 스위치예요. 원격 설정이 활성화하더라도 Test Management를 비활성화하려면 false로 설정해요.
DD_TEST_SESSION_NAME
Type: string Since: v5.83.0
CI Visibility에 보고되는 자동 생성 테스트 세션 이름을 재정의해요. 설정하지 않으면 트레이서는 감지된 CI 제공자, 저장소 및 분기 정보로 이름을 만들어요.
DD_TEST_TIA_KEEP_COV_CONFIG
Type: boolean Default: false Since: v5.89.0
테스트 최적화의 테스트 영향 분석이 활성화된 경우에도 사용자가 jest의 코드 커버리지 구성을 유지할 수 있게 해요.
DD_TRACE_GIT_METADATA_ENABLED
Type: boolean Default: true Since: v5.83.0
활성화하면 트레이서가 루트 스팬에 git 저장소 URL과 커밋 SHA 태그를 부착하여 트레이스를 Datadog UI의 해당 소스 코드에 연결할 수 있게 해요.
크래시 추적 및 진단 (Crash Tracking & Diagnostics)
(4)
애플리케이션 크래시를 캡처하고 보고하기 위한 크래시 추적과 힙 스냅샷 구성.
DD_CRASHTRACKING_ENABLED
Type: boolean Default: true Since: v5.83.0
Crash Tracking을 활성화해요. 활성화하면 트레이서가 크래시 추적을 초기화하고 JVM 크래시/OOM 훅(예: -XX:OnError 및 -XX:OnOutOfMemoryError)을 구성하여 hs_err_pid*.log 크래시 로그와 OOME 알림을 업로드하는 Datadog 제공 스크립트를 실행해요. 기본값: true.
DD_HEAP_SNAPSHOT_COUNT
Type: int Default: 0 Since: v5.83.0
작성할 힙 스냅샷 수예요. 비활성화하려면 0으로 설정해요.
DD_HEAP_SNAPSHOT_DESTINATION
Type: string Since: v5.83.0
힙 스냅샷이 작성되는 디렉터리 경로예요.
DD_HEAP_SNAPSHOT_INTERVAL
Type: int Default: 3600 Since: v5.83.0
힙 스냅샷 사이의 지연(초)을 설정하여 스냅샷 빈도와 메모리 프로파일링 오버헤드에 영향을 미쳐요. 첫 번째 스냅샷은 초기 전체 지연 후에 생성돼요.
로그 제출 및 상호 연결 (Log Submission & Correlation)
(4)
Datadog에 대한 직접 로그 제출, 에이전트리스 로그 전달, 트레이스-로그 상호 연결을 위한 로그 주입, OpenTelemetry 로그 내보내기.
DD_AGENTLESS_LOG_SUBMISSION_ENABLED
Type: boolean Default: false Since: v5.83.0
Datadog Agent를 통해 로그를 라우팅하지 않고 Datadog에 직접 로그를 제출할 수 있게 해요.
DD_AGENTLESS_LOG_SUBMISSION_URL
Type: string Since: v5.83.0
에이전트리스 로그 제출이 활성화될 때 사용되는 intake URL을 재정의해요.
DD_LOGS_INJECTION
Type: boolean Default: true Since: v5.88.0
애플리케이션 로그에 상호 연결 식별자(트레이스 ID, 스팬 ID) 자동 주입을 활성화하거나 비활성화해요.
언어별 참고 사항:
- .NET: 로거에는
trace_id매핑을 올바르게 설정하는source가 필요해요. .NET 애플리케이션의 기본 소스인csharp는 이를 자동으로 수행해요.
DD_LOGS_OTEL_ENABLED
Type: boolean Default: false Since: v5.83.0
OpenTelemetry Logs API를 통해 생성된 로그의 수집 및 내보내기를 활성화해요.
런타임 메트릭 (Runtime Metrics)
(6)
런타임 메트릭 수집과 메트릭 제출을 위한 DogStatsD 연결 구성.
DD_DOGSTATSD_HOST
Type: string Default: localhost Since: v5.83.0 Aliases:DD_DOGSTATSD_HOSTNAME
기본 트레이서가 DogStatsD 메트릭을 제출하려고 시도하는 트레이스 Agent 호스트의 주소를 재정의해요. DD_DOGSTATSD_HOST를 재정의하려면 DD_AGENT_HOST를 사용해요.
DD_DOGSTATSD_PORT
Type: int Default: 8125 Since: v5.83.0
메트릭이 제출되는 DogStatsD Agent의 포트예요. Agent 구성이 dogstatsd_port 또는 DD_DOGSTATSD_PORT를 기본값 8125이 아닌 값으로 설정하면 이 추적 라이브러리 DD_DOGSTATSD_PORT가 그 값과 일치해야 해요.
DD_RUNTIME_METRICS_ENABLED
Type: boolean Default: false Since: v5.83.0
애플리케이션에 대한 런타임 메트릭(가비지 컬렉션 통계, 메모리 사용량, 스레드 수 등) 수집을 활성화하거나 비활성화해요.
DD_RUNTIME_METRICS_EVENT_LOOP_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서에서 런타임 메트릭 이벤트 루프 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_RUNTIME_METRICS_GC_ENABLED
Type: boolean Default: true Since: v5.83.0
트레이서에서 런타임 메트릭 gc 동작을 활성화해요. 비활성화하면 관련 데이터 수집 및 처리를 건너뛰어요.
DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED
Type: boolean Default: false Since: v5.83.0 Aliases:DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED
활성화하면 개별 프로세스를 구분하기 위해 런타임 메트릭에 runtime-id 태그를 추가해요.
Data Streams Monitoring
(1)
메시지 큐와 스트리밍 파이프라인 전반의 종단 간 지연을 추적하기 위한 Data Streams Monitoring.
DD_DATA_STREAMS_ENABLED
Type: boolean Default: false Since: v5.83.0
Data Streams Monitoring(DSM) 및 체크포인트 전파를 활성화해요. 활성화하면 트레이서는 DSM 전파기를 등록하고 경로 통계와 페이로드를 보고해요.
계측 텔레메트리 (Instrumentation Telemetry)
(4)
트레이서 자체 보고 텔레메트리: 하트비트 간격, 종속성 및 로그 수집, 텔레메트리 포워더 구성.
DD_TELEMETRY_DEBUG
Type: boolean Default: false Since: v5.83.0
계측 텔레메트리에 대한 디버그 모드를 활성화해요. 설정하면 다른 구성과 관계없이 텔레메트리 디버그 모드를 강제로 켜요.
DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED
Type: boolean Default: true Since: v5.83.0
런타임에 애플리케이션 종속성을 감지하여 Datadog에 보고하는 계측 텔레메트리 종속성 수집기를 활성화해요.
DD_TELEMETRY_LOG_COLLECTION_ENABLED
Type: boolean Default: true Since: v5.83.0
내부 트레이서 로그를 계측 텔레메트리의 일부로 전달할지 제어해요.
DD_TELEMETRY_METRICS_ENABLED
Type: boolean Default: true Since: v5.83.0
계측 텔레메트리가 내부 메트릭을 보내는지 제어해요.
원격 구성 (Remote Configuration)
(1)
Datadog에서 라이브 구성 업데이트를 받기 위한 Remote Configuration.
DD_REMOTE_CONFIGURATION_ENABLED
Type: boolean Default: true Since: v5.83.0 Aliases:DD_REMOTE_CONFIG_ENABLED
원격 구성을 활성화하거나 비활성화해요.
OpenTelemetry 호환성 (OpenTelemetry Compatibility)
(28)
Datadog SDK가 지원하는 표준 OpenTelemetry 환경 변수: 리소스 속성, 전파기, 트레이스 샘플러, OTLP 익스포터 구성, 배치 스팬 프로세서 설정.
DD_METRICS_OTEL_ENABLED
Type: boolean Default: false Since: v5.83.0
OpenTelemetry 메트릭 내보내기를 활성화해요. 메트릭은 기본적으로 비활성화되며 truthy 값으로 설정될 때만 활성화돼요.
DD_TRACE_OTEL_ENABLED
Type: boolean Default: false Since: v5.83.0
트레이스에 대한 Datadog SDK의 OpenTelemetry 상호운용성을 활성화해요.
OTEL_BSP_MAX_EXPORT_BATCH_SIZE
Type: int Default: 512 Since: v5.83.0
OpenTelemetry 배치 프로세서 플러시당 내보내는 최대 항목 수를 설정해요.
OTEL_BSP_MAX_QUEUE_SIZE
Type: int Default: 2048 Since: v5.83.0
버리기 전에 큐에 넣을 최대 로그 수예요.
OTEL_BSP_SCHEDULE_DELAY
Type: int Default: 5000 Since: v5.83.0
OpenTelemetry 배치 프로세서 내보내기 주기 사이의 지연(밀리초)을 설정해요.
OTEL_EXPORTER_OTLP_ENDPOINT
Type: string Since: v5.83.0
재정의되지 않는 한 모든 신호에 대한 OTLP 데이터 전송의 기본 URL을 지정해요. 기본(gRPC): http://localhost:4317. 기본(HTTP): http://localhost:4318.
OTEL_EXPORTER_OTLP_HEADERS
Type: map Since: v5.88.0
모든 나가는 OTLP 요청의 헤더로 사용할 key-value 쌍의 쉼표로 구분된 목록을 지정해요(예: api-key=key,other-config=value).
OTEL_EXPORTER_OTLP_LOGS_ENDPOINT
Type: string Since: v5.83.0 Aliases: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
Type: map Since: v5.88.0 Aliases:OTEL_EXPORTER_OTLP_HEADERS
모든 나가는 otlp 로그에 적용할 헤더 맵이에요.
OTEL_EXPORTER_OTLP_LOGS_PROTOCOL
Type: string Default: http/protobuf Since: v5.88.0 Aliases:OTEL_EXPORTER_OTLP_PROTOCOL
로그 데이터에 사용할 OTLP 전송 프로토콜을 지정해요.
OTEL_EXPORTER_OTLP_LOGS_TIMEOUT
Type: int Default: 10000 Since: v5.83.0 Aliases:OTEL_EXPORTER_OTLP_TIMEOUT
단일 나가는 OTLP 로그 요청의 타임아웃(밀리초)을 지정해요. 일반 OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.
OTEL_EXPORTER_OTLP_METRICS_ENDPOINT
Type: string Since: v5.83.0 Aliases: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
Type: map Since: v5.83.0
나가는 OTLP 메트릭 요청의 헤더로 사용할 key-value 쌍의 쉼표로 구분된 목록을 지정해요(예: api-key=key,other-config=value). 일반 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.
OTEL_EXPORTER_OTLP_METRICS_PROTOCOL
Type: string Default: http/protobuf Since: v5.88.0 Aliases:OTEL_EXPORTER_OTLP_PROTOCOL
OpenTelemetry OTLP 메트릭 내보내기에 사용되는 프로토콜을 선택해요. http/protobuf만 지원돼요.
OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE
Type: string Default: delta Since: v5.83.0
메트릭 집계 시간성을 제어해요. 허용 값: delta 또는 cumulative(대소문자 무시). 빈/유효하지 않은 값은 delta로 처리돼요.
OTEL_EXPORTER_OTLP_METRICS_TIMEOUT
Type: int Default: 10000 Since: v5.88.0 Aliases:OTEL_EXPORTER_OTLP_TIMEOUT
단일 나가는 OTLP 메트릭 요청의 타임아웃(밀리초)이에요. OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.
OTEL_EXPORTER_OTLP_PROTOCOL
Type: string Default: http/protobuf Since: v5.83.0
재정의되지 않는 한 모든 신호에 사용할 전송 프로토콜을 지정해요. 허용 값: grpc, http/protobuf, http/json.
OTEL_EXPORTER_OTLP_TIMEOUT
Type: int Default: 10000 Since: v5.83.0
OTLP 내보내기 요청의 기본 타임아웃(밀리초)이에요. 신호별 타임아웃이 설정되지 않았을 때 대체값으로 사용돼요.
OTEL_LOG_LEVEL
Type: string Since: v5.88.0
로그 수준을 설정하는 구성 키예요.
OTEL_LOGS_EXPORTER
Type: string Since: v5.83.0
OpenTelemetry 로그 익스포터 선택을 제어해요. 이 설정은 지원되지 않으며 무시돼요.
OTEL_METRIC_EXPORT_INTERVAL
Type: int Default: 10000 Since: v5.83.0
메트릭 내보내기 시도 사이의 간격(밀리초)이에요. 기본값 10000(10초)은 Datadog 권장 값이며 OpenTelemetry 사양 기본값인 60000ms와 다릅니다.
OTEL_METRIC_EXPORT_TIMEOUT
Type: int Default: 7500 Since: v5.83.0
단일 배치의 메트릭을 수집하고 내보내는 데 허용되는 최대 시간(밀리초)이에요. 기본값 7500(7.5초)은 Datadog 권장 값이며 OpenTelemetry 사양 기본값인 30000ms와 다릅니다.
OTEL_METRICS_EXPORTER
Type: string Since: v5.88.0
OTEL_METRICS_EXPORTER는 익스포터를 선택하는 데 사용되지 않아요. 메트릭을 강제로 끄는 none에 대해서만 실질적으로 인정돼요. 설정하지 않으면 스스로 메트릭을 활성화하지 않으며 실제로 메트릭을 생성하려면 DD_METRICS_OTEL_ENABLED가 true로 설정되어야 해요.
OTEL_PROPAGATORS
Type: array Since: v5.83.0
트레이스 컨텍스트를 추출하고 주입하는 데 사용되는 전파기를 구성해요.
OTEL_RESOURCE_ATTRIBUTES
Type: string Since: v5.88.0
해당 트레이서 태그 설정이 설정되지 않았을 때 트레이서 태그로 매핑되는 OpenTelemetry 리소스 속성을 설정해요. 서비스, 환경, 버전에 대한 예약 속성은 표준 태그로 매핑되며 처음 10개 속성만 적용돼요. 퍼센트 인코딩된 쉼표와 등호 구분 기호는 리터럴로 유지돼요.
OTEL_SERVICE_NAME
Type: string Since: v5.88.0
애플리케이션의 기본 서비스 이름을 설정해요. DD_SERVICE가 설정되지 않았을 때 DD_SERVICE의 별칭이에요.
OTEL_TRACES_SAMPLER
Type: string Default: parentbased_always_on Since: v5.88.0
SDK가 트레이스를 샘플링하는 데 사용하는 Sampler를 지정해요.
OTEL_TRACES_SAMPLER_ARG
Type: decimal Since: v5.88.0
트레이스 샘플러에 대한 추가 인수를 설정하는 구성 키예요.
Real User Monitoring (RUM)
(1)
백엔드 Real User Monitoring 주입 설정: 세션 구성, 개인정보 보호 수준, 리소스 추적.
DD_TRACE_EXPERIMENTAL_GET_RUM_DATA_ENABLED
Type: boolean Default: false Since: v5.83.0
실험적인 get rum data에 대한 계측을 활성화해요. 비활성화하면 실험적인 get rum data 작업에 대한 스팬이 생성되지 않아요.
AI & LLM Observability
(8)
AI 관측 기능: AI Guard 콘텐츠 검사, LLM Observability, 제공자별 통합 설정.
DD_AI_GUARD_ENABLED
Type: boolean Default: false Since: v5.83.0
트레이서에서 AI Guard 요청 검사를 활성화해요. 비활성화하면 AI Guard 검사를 건너뛰어요.
DD_AI_GUARD_ENDPOINT
Type: string Since: v5.83.0
AI Guard: AI Guard REST API의 기본 엔드포인트 URL을 설정해요. 설정하지 않으면 기본값은 https://app.<DD_SITE>/api/v2/ai-guard예요(트레이서가 /evaluate를 추가).
DD_AI_GUARD_MAX_CONTENT_SIZE
Type: int Default: 524288 Since: v5.83.0
meta-struct에 설정되는 content 속성의 최대 크기예요.
DD_AI_GUARD_MAX_MESSAGES_LENGTH
Type: int Default: 16 Since: v5.83.0
meta-struct에 설정할 수 있는 대화 메시지의 최대 수예요.
DD_AI_GUARD_TIMEOUT
Type: int Default: 10000 Since: v5.83.0
AI Guard REST API 호출에 사용되는 타임아웃(밀리초)이에요(기본 5000).
DD_LLMOBS_AGENTLESS_ENABLED
Type: boolean Since: v5.83.0
Datadog Agent가 필요한 데이터 전송을 비활성화하려면 true로 설정해요.
DD_LLMOBS_ENABLED
Type: boolean Default: false Since: v5.83.0
LLM Observability에 데이터 제출을 활성화하려면 전환해요.
DD_LLMOBS_ML_APP
Type: string Since: v5.88.0
LLM Observability 데이터에 사용되는 기본 ML 앱 이름을 설정해요. 이 값은 LLM Observability가 활성화될 때 필요해요.
계측 및 플랫폼 (Instrumentation & Platform)
(3)
계측 설정 및 플랫폼별 구성: 자동 주입, 타사 라이브러리 탐지, 플랫폼 어댑터.
DD_AZURE_RESOURCE_GROUP
Type: string Since: v5.83.0
CI Visibility 및 텔레메트리 상호 연결을 위한 클라우드 메타데이터로 보고되는 Azure 리소스 그룹 이름이에요.
DD_INJECT_FORCE
Type: boolean Default: false Since: v5.83.0
Single Step Instrumentation(SSI): 여러 JVM 에이전트가 감지된 경우에도 트레이서 javaagent가 로드되도록 강제해요. 이는 여러 에이전트 실행을 피하기 위해 시작을 중단하는 SSI 가드레일을 우회해요. DD_INJECT_FORCE 또는 시스템 속성 dd.inject.force로 설정할 수 있어요. 기본값: false.
DD_INSTRUMENTATION_CONFIG_ID
Type: string Since: v5.83.0
원격 구성 상호 연결을 위해 텔레메트리에 부착되는 내부 계측 구성 식별자예요.
기타 (Miscellaneous)
(2)
아직 다른 범주에 맞지 않는 구성 키예요. 이 목록은 백로그로 취급해요. 각 키는 결국 실제 자리가 있어야 해요.
DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED
Type: boolean Default: false Since: v5.83.0
원격 구성에서 플래그를 평가하는 실험적인 기능 플래그 제공자를 활성화해요. 활성화하지 않으면 제공자는 no-op이며 기본값을 반환해요.
DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS
Type: int Default: 30000 Since: v5.84.0
OpenFeature 제공자 초기화의 타임아웃(밀리초)이에요. 이 시간 내에 구성을 받지 못하면 초기화가 실패해요. DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS 환경 변수로 구성할 수 있어요.
더 알아보기 (Learn more)
추가로 도움이 되는 문서, 링크, 글: