Java SDK 구성 (Configuring the Java SDK)

원문 보기 위키 갱신 2026.10.05

코드로 SDK를 설정하고 Agent가 APM 데이터를 수집하도록 구성한 뒤, 필요에 따라 SDK를 원하는 대로 구성할 수 있어요. 여기에는 Unified Service Tagging 설정도 포함돼요. 런타임 구성을 확인하고 설정값을 검증하려면 Datadog에서 서비스의 현재 구성을 확인할 수 있어요. APM 서비스 페이지로 이동해 Service Config를 클릭하고 SDK Configuration 탭을 선택하면 돼요. 아래 모든 구성 옵션은 시스템 속성과 환경 변수 두 가지로 동등하게 설정할 수 있어요. 같은 키를 두 방식으로 모두 설정하면 시스템 속성 구성이 우선해요. 시스템 속성은 JVM 플래그로 설정할 수 있어요.

출처: 문서

본문

시스템 속성과 환경 변수 변환하기

별도로 명시하지 않는 한, 시스템 속성과 환경 변수는 다음 변환 규칙으로 서로 바꿀 수 있어요:

시스템 속성을 환경 변수로 설정하려면 속성 이름을 대문자로 바꾸고 . 또는 -를 _로 바꿔요. 예를 들어 dd.service는 DD_SERVICE가 돼요.
환경 변수를 시스템 속성으로 설정하려면 변수 이름을 소문자로 바꾸고 _를 .로 바꿔요. 예를 들어 DD_TAGS는 dd.tags가 돼요.

참고: Java 트레이서의 시스템 속성을 사용할 때는 -jar 앞에 속성을 나열해야 해요. 그래야 속성이 JVM 옵션으로 읽혀요.

구성 키 (Configuration keys)

이 라이브러리에서 사용할 수 있는 구성 키는 1103개예요.

일반 설정 (General Settings)

(16)

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

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

Type: string Aliases:DATADOG_API_KEY 에이전트리스(로컬 Agent 없이 Datadog로 직접 전송) 모드에서 나가는 요청을 인증하는 데 사용하는 Datadog API 키를 설정해요. 에이전트리스 CI 테스트 리포트와 LLM Observability 에이전트리스 모드에서 필요해요.DD_APM_TRACING_ENABLED

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

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

Type: string Default: agentless Since: v1.65.0 피처 플래깅 구성 소스 선택: 에이전트리스 백엔드, 원격 구성 또는 오프라인 초기화.DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URL

Type: string Since: v1.65.0 에이전트리스 구성 소스의 커스텀 기본 URL.DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_POLL_INTERVAL_SECONDS

Type: int Default: 30 Since: v1.65.0 에이전트리스 모드에서 구성 소스를 요청하는 폴링 간격.DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_REQUEST_TIMEOUT_SECONDS

Type: int Default: 5 Since: v1.65.0 에이전트리스 모드에서 구성 소스의 요청 타임아웃.DD_FEATURE_FLAGS_ENABLED

Type: boolean Default: true Since: v1.65.0 전역 Feature Flags 킬 스위치. false는 프로바이더, CDN 폴링, Feature Flags RC 구독을 비활성화해요. true는 소스 해석은 허용하지만 독립적으로 트래픽을 시작하지는 않아요.DD_FLAGGING_EVALUATION_COUNTS_ENABLED

Type: boolean Default: true Since: v1.66.0 OpenFeature 플래그 평가 횟수의 서버 측 보고를 활성화해요. 활성화(기본값)하면 트레이서가 플래그 평가를 집계하고 기존 feature_flag.evaluations 메트릭과 함께 첫/마지막 평가 타임스탬프를 포함한 플래그별 평가 횟수를 Datadog의 flag-evaluation 트랙으로 주기적으로 전송해요. false로 설정하면 평가 횟수 데이터 전송을 중단하고, 다른 피처 플래그 텔레메트리(메트릭 및 노출)는 영향을 받지 않아요. Datadog OpenFeature 플래깅 프로바이더가 활성화된 경우에만 적용돼요.DD_PROXY_NO_PROXY

Type: string 프록시를 우회해야 하는 호스트 목록을 설정하는 구성 키예요. 목록은 공백으로 구분돼요. CI Visibility 전용이에요DD_SERVICE

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

언어별 참고사항:

.NET: IIS 애플리케이션 이름, 프로세스 진입 어셈블리 또는 프로세스 이름으로 폴백해요.
Java: Java 에이전트가 애플리케이션 클래스를 기반으로 자동 감지한 서비스 이름으로 폴백해요.
Node.js: package.json의 name 필드로 폴백해요. DD_SERVICE_MAPPING

Type: map 트레이스에서 서비스 이름을 바꿀 수 있게 서비스 이름 매핑을 정의해요. 예: postgres:postgresql,defaultdb:postgresql. 버전 0.47+에서 사용 가능해요.DD_SITE

Type: string Default: datadoghq.com 에이전트리스 수집 URL을 만드는 데 사용하는 사이트 도메인을 설정해요. 설정하지 않으면 기본 사이트가 사용돼요.DD_TAGS

Type: map 트레이스, 프로파일, 메트릭에 적용되는 커스텀 태그로, 쉼표로 구분된 key:value 쌍으로 제공해요(예: layer:api,team:intake).DD_VERSION

Type: string 애플리케이션 버전을 설정하며, 트레이스와 로그의 version 태그로 사용돼요(예: 1.2.3, 6c44da20, 2020.02.13).

언어별 참고사항:

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

트레이싱 코어 (Tracing Core)

(61)

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

Type: string Default: 400-499 클라이언트 HTTP 상태 코드로 스팬을 오류로 표시해요.DD_HTTP_SERVER_ERROR_STATUSES

Type: string Default: 500-599 서버 HTTP 상태 코드로 스팬을 오류로 표시해요.DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED

Type: boolean Default: true 트레이서가 128비트 W3C 트레이스 ID(32자리 16진수)를 생성할지, 64비트 Datadog 트레이스 ID(16자리 16진수)를 생성할지 제어해요. 128비트 ID는 완전한 W3C traceparent 상호운용에 필요해요.DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED

Type: boolean Default: true 128비트 트레이스 ID를 전체 32자리 형식으로 로깅할지, 16자리로 잘라낼지 제어해요. 짧은 형식을 기대하는 시스템과의 호환성을 위해 false로 설정할 수 있어요.DD_TRACE_AGENT_ARGS

Type: string Azure App Services: 외부 trace-agent 프로세스 실행을 위한 추가 명령줄 인수(공백/쉼표 구분). 설정하지 않으면 추가 인수가 전달되지 않아요.DD_TRACE_AGENT_PATH

Type: string Azure App Services: 실행할 외부 trace-agent 실행 파일 경로. 설정하지 않으면 트레이서가 외부 trace-agent 프로세스를 시작하지 않아요.DD_TRACE_AGENT_PORT

Type: int Default: -1 Aliases:DD_AGENT_PORT 프로파일을 보내는 포트(Agent가 연결을 수신하는 포트)를 설정해요. DD_TRACE_AGENT_URL이 설정되면 무시돼요. 기본값은 8126이에요.DD_TRACE_AGENT_PROTOCOL_VERSION

Type: string Default: 0.4 Since: v1.62.0 Agent에 대한 요청에 사용할 프로토콜 버전이에요. 설정한 버전이 설치된 Agent 버전에서 지원되어야 하며, 그렇지 않으면 모든 트레이스가 삭제돼요.DD_TRACE_AGENT_TIMEOUT

Type: int Default: 10 Datadog Agent와의 네트워크 상호작용에 대한 타임아웃(초)이에요.DD_TRACE_AGENT_UNIX_DOMAIN_SOCKET

Type: string 트레이스 트래픽을 프록시로 보내 나중에 원격 Datadog Agent로 보낼 때 사용할 수 있어요.DD_TRACE_AGENT_URL

Type: string Aliases:DD_TRACE_URL 트레이스가 전송되는 URL 엔드포인트를 설정해요. 설정되면 DD_AGENT_HOST와 DD_TRACE_AGENT_PORT를 재정의해요. 기본값은 http://<DD_AGENT_HOST>:<DD_TRACE_AGENT_PORT>이에요.DD_TRACE_ANALYTICS_ENABLED

Type: boolean Default: false Since: v1.55.0 각 통합의 구성된 analytics 샘플 레이트를 사용해 모든 통합의 스팬에 analytics.sample_rate 메트릭을 설정함으로써 레거시 Trace Analytics 기능을 활성화해요. 최신 Datadog 배포에서는 App Analytics로 대체됐어요.DD_TRACE_CLASSES_EXCLUDE

Type: string 트레이서가 무시(수정하지 않음)할 정규화된 클래스 목록(접두사를 나타내는 와일드카드로 끝날 수 있음)이에요. JVM 내부 표현을 사용해야 해요(예: package.ClassName$Nested이고 package.ClassName.Nested가 아님)DD_TRACE_CLIENT_IP_ENABLED

Type: boolean Default: false HTTP 요청 헤더에서 클라이언트 IP 주소의 자동 수집을 켜거나 꺼요. 활성화하면 IP 주소가 http.client_ip 스팬 태그에 저장돼요.DD_TRACE_CLIENT_IP_HEADER

Type: string http.client_ip 태그 값을 가져올 커스텀 헤더 이름을 구성해요. 설정하면 다른 모든 IP 관련 헤더는 무시돼요(예: DD_TRACE_CLIENT_IP_HEADER=custom-ip-header로 설정하고 요청에 custom-ip-header: 5.6.7.9 헤더를 포함하면 스팬에 "http.client_ip": "5.6.7.9"로 태그됨). 빈 문자열 또는 null 값을 전달하면 IP 헤더를 다음 순서로 조회해요: x-forwarded-for → x-real-ip → true-client-ip → x-client-ip → x-forwarded → forwarded-for → x-cluster-client-ip → fastly-client-ip → cf-connecting-ip → cf-connecting-ipv6``DD_TRACE_CLOUD_PAYLOAD_TAGGING_MAX_DEPTH

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

Type: int Default: 758 AWS 페이로드 태깅에 사용할 스팬당 추출할 최대 태그 수를 나타내는 정수예요.DD_TRACE_CLOUD_PAYLOAD_TAGGING_SERVICES

Type: string Default: ["S3", "Sqs", "Kinesis", "Sns", "DynamoDB", "ApiGatewayV2", "EventBridge", "ApiGateway"] 추가 서비스에 대한 AWS 페이로드 태깅을 활성화하려면 이 설정을 사용해요.DD_TRACE_CLOUD_REQUEST_PAYLOAD_TAGGING

Type: array AWS SDK 요청에서 삭제할 JSONPath 항목의 쉼표 구분 문자열이에요. 설정하면 요청에 대한 AWS 페이로드 태깅이 활성화돼요.DD_TRACE_CLOUD_RESPONSE_PAYLOAD_TAGGING

Type: array AWS SDK 응답에서 삭제할 JSONPath 항목의 쉼표 구분 문자열이에요. 설정하면 응답에 대한 AWS 페이로드 태깅이 활성화돼요.DD_TRACE_CONFIG

Type: string 에이전트 구성이 포함된 유효한 Java properties 파일 경로예요. 참고: OTEL_JAVAAGENT_CONFIGURATION_FILE과 DD_TRACE_CONFIG를 모두 설정하면 두 파일의 구성을 모두 적용해요. Datadog 설정이 OTel 설정을 재정의하는 일반 규칙의 예외예요DD_TRACE_DB_CLIENT_SPLIT_BY_HOST

Type: boolean Default: false true로 설정하면 db 스팬에 원격 데이터베이스 호스트명이 서비스 이름으로 할당돼요DD_TRACE_DB_CLIENT_SPLIT_BY_INSTANCE

Type: boolean Default: false HTTP 요청의 서비스 이름을 pdo-로 설정해요. 예를 들어 데이터베이스 호스트 datadoghq.com에 대한 PDO->query() 호출은 기본 서비스 이름 pdo 대신 pdo-datadoghq.com이라는 서비스 이름을 가져요.DD_TRACE_ENABLED

Type: boolean Default: true Aliases:DD_TRACING_ENABLED 프레임워크 및 라이브러리 계측을 활성화해요. false면 애플리케이션 코드가 트레이스를 생성하지 않아요. DD_APM_TRACING_ENABLED도 참고하세요.DD_TRACE_EXPERIMENTAL_FEATURES_ENABLED

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

Type: decimal Default: 1.0 트레이스 작성기 플러시 간격(초): 트레이서가 트레이스를 플러시/전송하는 빈도를 제어해요. 기본값: 1.0초.DD_TRACE_GLOBAL_TAGS

Type: map 전역 태그: 모든 곳(모든 스팬과 런타임 메트릭)에 적용되는 키/값 태그예요. dd.trace.global.tags(레거시)와 dd.tags/dd.trace.tags에서 병합되고 DD_ENV/DD_VERSION으로 조정돼요. 기본값: 비어 있음.DD_TRACE_HEALTH_METRICS_ENABLED

Type: boolean Default: true true로 설정하면 트레이서 상태 메트릭을 전송해요DD_TRACE_HEALTH_METRICS_STATSD_HOST

Type: string 상태 메트릭을 보낼 Statsd 호스트DD_TRACE_HEALTH_METRICS_STATSD_PORT

Type: int 상태 메트릭을 보낼 Statsd 포트DD_TRACE_JMX_TAGS

Type: map 모든 jmx 메트릭에 추가할 스팬 태그 목록이에요.DD_TRACE_METHODS

Type: string 추적할 메서드 목록이에요. 세미콜론(;)으로 구분된 목록을 받으며 각 항목은 Namespace.TypeName[MethodNames] 형식이에요. MethodNames는 쉼표(,)로 구분된 메서드 이름 목록 또는 * 와일드카드예요.

제네릭 타입의 경우 꺾쇠괄호와 타입 파라미터 이름을 백틱(```) 뒤에 제네릭 타입 파라미터 수로 바꿔요. 예를 들어 Dictionary<TKey, TValue>는 Dictionary2`로 써야 해요. 제네릭 메서드의 경우 메서드 이름만 지정하면 돼요.

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

Type: string Aliases:DD_OBFUSCATION_QUERY_STRING_REGEXP http.url 태그에 보고되는 수신 요청의 쿼리 문자열에서 민감한 데이터를 삭제하는 정규식이에요(일치 항목은 로 대체됨).DD_TRACE_PARTIAL_FLUSH_ENABLED

Type: boolean Default: true 큰 트레이스를 Agent에 증분 플러시하여 Agent가 거부할 가능성을 줄여요. 오래 실행되는 트레이스나 스팬이 많은 트레이스가 있을 때만 사용해요. 유효한 값은 true 또는 false예요. 버전 1.26.0에서 추가됐으며 Datadog Agent 7.26.0+와만 호환돼요.DD_TRACE_PARTIAL_FLUSH_MIN_SPANS

Type: int Default: 1000 부분 플러시가 트리거되기 전에 트레이스에 누적된 완료 스팬의 최소 수예요. 잘못된 값은 무시돼요.DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED

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

Type: map 감지된 피어 서비스 이름을 스팬에 연결하기 전에 정규화된 값으로 매핑해요.DD_TRACE_PIPE_NAME

Type: string Datadog Agent 네임드 파이프: Datadog Agent와 통신하기 위한 HTTP 전송으로 사용되는 Windows 네임드 파이프 이름/경로를 설정해요(TCP 또는 유닉스 도메인 소켓 대신). 설정하면 트레이서의 HTTP 클라이언트가 NamedPipe 소켓 팩토리를 사용해요. 기본값: 설정 안 됨.DD_TRACE_RABBIT_PROPAGATION_ENABLED

Type: boolean Default: true Aliases:DD_RABBIT_PROPAGATION_ENABLED Rabbit(RabbitMQ) 컨텍스트 전파: 활성화하면 AMQP 메시지 헤더를 통해 트레이스 컨텍스트를 주입하고 추출해 publish/consume 전반에 걸쳐 트레이스가 이어지게 해요. 이는 또한 트레이서의 RabbitMQ time-in-queue 타임스탬프 헤더 주입을 제어해요. 기본값: true.DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED

Type: boolean Default: false 활성화하면 Naming Schema v0 아래의 통합이 추론된 서비스 이름 사용을 중단하고 애플리케이션 서비스 이름으로 폴백해요. 통합과 관계없이 모든 스팬이 DD_SERVICE 아래에 보고되도록 하려면 이 설정을 사용해요.DD_TRACE_REPORT_HOSTNAME

Type: boolean Default: false 각 트레이스에 시스템의 호스트명을 보고할지 여부예요. 비활성화하면 Agent의 호스트명이 대신 사용돼요.DD_TRACE_RESOURCE_RENAMING_ALWAYS_SIMPLIFIED_ENDPOINT

Type: boolean Default: false Since: v1.60.0 활성화하면 명시적 엔드포인트를 사용할 수 있을 때에도 http.endpoint 태그를 항상 Resource Renaming 단순화 알고리즘의 결과로 설정해요.DD_TRACE_RESOURCE_RENAMING_ENABLED

Type: boolean Default: false Since: v1.60.0 수신 HTTP 요청에 대해 http.endpoint 태그를 계산해 추가할지 제어해요. 시작 시 애플리케이션 보안이 활성화되지 않는 한 기본적으로 비활성화되며, 이 설정으로 명시적으로 켜거나 끌 수 있어요.DD_TRACE_SECURE_RANDOM

Type: boolean Default: false 보안 랜덤 ID 생성: 활성화하면 트레이스/스팬 ID에 대해 SECURE_RANDOM ID 생성 전략(SecureRandom 기반)을 사용하도록 강제해요. AWS Lambda SnapStart(AWS_LAMBDA_INITIALIZATION_TYPE=snap-start)에서도 강제돼요. 기본값: false.DD_TRACE_SPAN_ATTRIBUTE_SCHEMA

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

Type: map 모든 스팬에 추가할 기본 태그 목록이에요.DD_TRACE_SPLIT_BY_TAGS

Type: string 스팬과 연결된 서비스 이름을 해당 스팬 태그로 식별되도록 바꾸는 데 사용돼요DD_TRACE_STATS_ADDITIONAL_TAGS

Type: array Since: v1.65.0 클라이언트 측 통계를 사용할 때 스팬에서 추출되어 APM 통계의 스팬 파생 기본 태그로 추가 집계 차원으로 사용되는 태그 키의 쉼표 구분 목록이에요. 커스텀 계측으로 직접 또는 DD_TAGS를 통해 스팬에 추가된 태그만 지원돼요. 클라이언트 측 통계가 활성화된 경우에만 적용돼요DD_TRACE_STATS_ADDITIONAL_TAGS_CARDINALITY_LIMIT

Type: int Default: 100 Since: v1.65.0 클라이언트 측 통계가 활성화된 상태에서 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'additional_tags' 필드에 대한 최대 카디널리티를 정의해요. 스팬을 닫을 때 필드의 카디널리티가 초과되면 해당 필드는 대신 'tracer_blocked_value'로 대체돼요. 이후 필드의 모든 새 값은 같은 차단 값을 받아요. 이 키별 카디널리티 제한은 전체 키 카디널리티 제한에 추가로 적용돼요.DD_TRACE_STATS_CARDINALITY_LIMIT

Type: int Default: 2048 Since: v1.65.0 Aliases:DD_TRACE_TRACER_METRICS_MAX_AGGREGATES 클라이언트 측 통계가 활성화된 상태에서 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭에 대한 최대 카디널리티를 정의해요. 스팬을 닫을 때 카디널리티 임계값이 초과되면 대신 오버플로 버킷으로 병합돼요. 이 전체 키 카디널리티 제한은 필드별 카디널리티 제한에 추가로 적용돼요.DD_TRACE_STATS_COMPUTATION_ENABLED

Type: boolean Default: true Since: v1.55.0 Aliases:DD_TRACE_TRACER_METRICS_ENABLED 클라이언트 측 트레이스 통계 계산이 활성화되는지 제어해요. 활성화하면 트레이서가 수집을 위해 스팬 통계를 사전 집계해요.DD_TRACE_STATS_HTTP_ENDPOINT_CARDINALITY_LIMIT

Type: int Default: 512 Since: v1.65.0 클라이언트 측 통계가 활성화된 상태에서 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'HTTP_endpoint' 필드에 대한 최대 카디널리티를 정의해요. 스팬을 닫을 때 필드의 카디널리티가 초과되면 해당 필드는 대신 'tracer_blocked_value'로 대체돼요. 이후 필드의 모든 새 값은 같은 차단 값을 받아요. 이 키별 카디널리티 제한은 전체 키 카디널리티 제한에 추가로 적용돼요.DD_TRACE_STATS_PEER_TAGS_CARDINALITY_LIMIT

Type: int Default: 512 Since: v1.65.0 클라이언트 측 통계가 활성화된 상태에서 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'peer_tags' 필드에 대한 최대 카디널리티를 정의해요. 스팬을 닫을 때 필드의 카디널리티가 초과되면 해당 필드는 대신 'tracer_blocked_value'로 대체돼요. 이후 필드의 모든 새 값은 같은 차단 값을 받아요. 이 키별 카디널리티 제한은 전체 키 카디널리티 제한에 추가로 적용돼요.DD_TRACE_STATS_RESOURCE_CARDINALITY_LIMIT

Type: int Default: 1024 Since: v1.65.0 클라이언트 측 통계가 활성화된 상태에서 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'resource' 필드에 대한 최대 카디널리티를 정의해요. 스팬을 닫을 때 필드의 카디널리티가 초과되면 해당 필드는 대신 'tracer_blocked_value'로 대체돼요. 이후 필드의 모든 새 값은 같은 차단 값을 받아요. 이 키별 카디널리티 제한은 전체 키 카디널리티 제한에 추가로 적용돼요.DD_TRACE_TAGS

Type: map Aliases:DD_TAGS 모든 스팬, 프로파일, JMX 메트릭에 추가할 기본 태그 목록이에요. DD_ENV 또는 DD_VERSION을 사용하면 DD_TAGS에 정의된 env 또는 version 태그를 재정의해요. 버전 0.50.0+에서 사용 가능해요.DD_TRACE_TRACE_CONFIG_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_CONFIG_ANALYTICS_ENABLED TraceConfig 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_TRACE_CONFIG_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_TRACE_CONFIG_ANALYTICS_SAMPLE_RATE TraceConfig 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_TRACE_CONFIG_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_TRACE_CONFIG_ENABLED, DD_INTEGRATION_TRACE_CONFIG_ENABLED Trace Config (TraceConfig) 계측을 활성화해요DD_TRACE_TRACE_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_TRACE_ENABLED, DD_TRACE_INTEGRATION_TRACE_ENABLED 트레이스 어노테이션 및 구성된 트레이스 메서드를 통한 메서드 추적을 활성화해요(datadog.trace.api.Trace 및 기타 지원되는 @Trace 어노테이션이 달린 메서드와 트레이서 구성에 나열된 클래스/메서드에 대한 스팬 생성)DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH

Type: int Default: 512 트레이스 태그 전파를 위한 x-datadog-tags 헤더의 최대 길이예요. 비활성화하려면 0으로 설정해요.DD_WRITER_TYPE

Type: string Default: DDAgentWriter 기본값은 트레이스를 Agent로 전송해요. LoggingWriter로 구성하면 트레이스를 콘솔에 대신 기록해요.

트레이스 샘플링 (Trace Sampling)

(6)

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

Type: string 스팬 샘플링: 스팬별 샘플링 우선순위(단일 스팬 샘플링)를 결정하는 데 사용하는 JSON 규칙이에요. DD_SPAN_SAMPLING_RULES와 DD_SPAN_SAMPLING_RULES_FILE을 모두 설정하면 파일 설정은 무시돼요. 규칙은 service/name으로 스팬을 매칭하고 샘플 레이트와 선택적 초당 최대 제한을 적용할 수 있어요.DD_SPAN_SAMPLING_RULES_FILE

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

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

Type: decimal Aliases:OTEL_TRACES_SAMPLER Agent와 백엔드 간 수집 샘플 레이트(0.0~1.0)를 제어해요. 별칭으로 OTEL_TRACES_SAMPLER를 사용해요DD_TRACE_SAMPLING_RULES

Type: string 트레이스 수집을 세밀하게 제어하여 특정 서비스, 작업, 리소스 또는 태그가 달린 트레이스를 대상으로 지정할 수 있게 해요. 객체 배열의 JSON으로 정의되며, 각 객체는 sample_rate를 0.0~1.0(포함) 사이로 포함해야 하고 선택적으로 다음 필드를 포함할 수 있어요: 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 기본적으로 websocket 메시지는 핸드셰이크 중 캡처된 스팬과 동일한 샘플링을 유지해요. 이렇게 하면 핸드셰이크 스팬이 샘플링된 경우 해당 세션의 모든 메시지도 샘플링되도록 보장돼요. 이 동작을 비활성화하고 각 websocket 메시지를 독립적으로 샘플링하려면 이 구성을 false로 설정해요.

트레이스 전파 (Trace Propagation)

(25)

분산 트레이스 컨텍스트 전파, 추출·주입 동작, 배개지 처리, 헤더 태깅, HTTP 클라이언트·서버 구성, Database Monitoring용 SQL 주석 주입. DD_DBM_ALWAYS_APPEND_SQL_COMMENT

Type: boolean Default: false Since: v1.55.0 DD_DBM_PROPAGATION_MODE가 설정되면 SQL 쿼리에 주석이 주입돼요. 대부분의 경우 앞에 붙어요. 이 구성은 주석이 항상 끝에 붙도록 강제해요.DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED

Type: boolean Default: true 프로세스 수준 태그(예: 엔트리포인트 메타데이터)가 수집되어 트레이싱 페이로드에 첨부되는지 제어해요.DD_HTTP_SERVER_ROUTE_BASED_NAMING

Type: boolean Default: true false로 설정하면 http 프레임워크 라우트가 리소스 이름에 사용되지 않아요. 변경하면 리소스 이름과 파생 메트릭이 변경될 수 있어요.DD_HTTP_SERVER_TAG_QUERY_STRING

Type: boolean Default: true 서버 스팬에 쿼리 문자열을 보고할지 여부를 켜거나 꺼요. 기본값은 true예요.DD_PROPAGATION_STYLE_EXTRACT

Type: string 분산 트레이싱 전파 데이터를 추출하려고 시도할 헤더 형식의 쉼표 구분 목록이에요. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요. 버전 1.9.0부터 사용 중단됨DD_PROPAGATION_STYLE_INJECT

Type: string 서비스 간 분산 트레이스를 전파하기 위해 포함할 헤더 형식의 쉼표 구분 목록이에요. 버전 1.9.0부터 사용 중단됨DD_TRACE_BAGGAGE_MAX_BYTES

Type: int Default: 8192 다운스트림 서비스로 전파할 때 배개지 헤더에 주입할 수 있는 최대 바이트 수를 설정하는 구성 키예요. 기본값은 8192바이트예요.DD_TRACE_BAGGAGE_MAX_ITEMS

Type: int Default: 64 다운스트림 서비스로 전파할 때 배개지 헤더에 주입할 수 있는 최대 항목 수를 설정하는 구성 키예요. 기본값은 64개예요.DD_TRACE_BAGGAGE_TAG_KEYS

Type: array Default: ["user.id", "session.id", "account.id"] 입력: 대소문자 구분 배개지 키 목록을 나타내는 쉼표 구분 문자열 주의사항: C++에서는 지원되지 않음 설명: 로컬 루트 스팬에 스팬 태그로 자동 적용되는 배개지 키의 쉼표 구분 목록이에요. 예를 들어 배개지 키 user.id는 baggage.user.id로 태그돼요. 이 기능은 수신 HTTP 헤더에서 추출된 배개지에만 적용돼요. 배개지 API로 설정된 배개지는 포함되지 않아요. - 모든 배개지 항목을 태그하려면 값을 *로 설정해요. 태그에 민감한 데이터를 노출하지 않도록 주의해 사용하세요. - 이 기능을 비활성화하려면 값을 빈 문자열로 설정해요.DD_TRACE_HEADER_BAGGAGE

Type: map 대소문자 구분 없는 헤더 키에서 배개지 키로의 맵을 받아 일치하는 요청 헤더 값을 트레이스의 배개지로 자동 적용해요. 전파 시 역방향 매핑이 적용돼요: 배개지가 헤더로 매핑돼요. 버전 1.3.0부터 사용 가능해요.DD_TRACE_HEADER_TAGS

Type: map Since: v1.57.0 지정된 HTTP 헤더를 스팬 태그로 자동 적용해요. 커스텀 태그 이름을 지정하지 않으면 태그 키는 요청 헤더의 경우 http.request.headers., 응답 헤더의 경우 http.response.headers.로 기본 설정돼요.DD_TRACE_HTTP_CLIENT_ERROR_STATUSES

Type: string Default: 400-499 Aliases:DD_HTTP_CLIENT_ERROR_STATUSES HTTP 클라이언트 스팬에 대한 오류로 처리할 HTTP 상태 코드 및 범위의 쉼표 구분 목록이에요(예: 400-499,500). 설정하면 일치하는 응답이 스팬을 오류로 표시해요.DD_TRACE_HTTP_CLIENT_PATH_RESOURCE_NAME_MAPPING

Type: map HTTP 클라이언트 요청 경로를 커스텀 리소스 이름에 매핑해요. dd.trace.http.server.path-resource-name-mapping과 같은 형식을 사용하지만 서버 스팬 대신 HTTP 클라이언트 스팬에 적용돼요.DD_TRACE_HTTP_CLIENT_SPLIT_BY_DOMAIN

Type: boolean Default: false HTTP 요청의 서비스 이름을 host-로 설정해요. 예를 들어 https://datadoghq.com에 대한 curl_exec() 호출은 기본 서비스 이름 curl 대신 host-datadoghq.com이라는 서비스 이름을 가져요.DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING

Type: boolean Default: true Aliases:DD_HTTP_CLIENT_TAG_QUERY_STRING 기본적으로 쿼리 문자열 파라미터와 프래그먼트가 웹 클라이언트 스팬의 http.url 태그에 추가돼요. 이 데이터 수집을 방지하려면 false로 설정해요.DD_TRACE_HTTP_SERVER_ERROR_STATUSES

Type: string Default: 500-599 Aliases:DD_HTTP_SERVER_ERROR_STATUSES HTTP 서버 스팬에 대한 오류로 처리되는 HTTP 상태 코드 또는 범위의 쉼표 구분 목록이에요(예: 500-599,404). 5xx 응답만 오류로 표시하는 기본 동작을 재정의해요.DD_TRACE_HTTP_SERVER_PATH_RESOURCE_NAME_MAPPING

Type: map HTTP 요청 경로를 커스텀 리소스 이름에 매핑해요. pattern:resource_name 쌍의 쉼표 구분 목록을 제공해요: – pattern: http.path_group 스팬 태그 값과 일치해야 하는 Ant 스타일 경로 패턴. – resource_name: 패턴이 일치할 때 할당할 커스텀 리소스 이름. 일치하는 패턴에 *를 resource_name으로 사용하면 원래의 비정규화 요청 경로와 HTTP 메서드를 합친 값이 리소스 이름으로 사용돼요. 예를 들어 규칙 /test/**:*가 주어졌을 때 /test/some/path에 대한 GET 요청은 리소스 이름 GET /test/some/path가 돼요. 매핑은 우선순위 순서로 평가되며 첫 번째로 일치하는 규칙이 적용돼요. 일치하지 않는 요청 경로는 기본 정규화 동작을 사용해요. 요청 경로 | 리소스 경로 ———— | ————- /admin/index.jsp | /admin-page /admin/user/12345/delete | /admin/user /user/12345 | /user/?``DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED

Type: boolean Default: false Since: v1.55.0 Aliases:DD_TRACE_INFERRED_SPANS_ENABLED 활성화하면 트레이서가 inferred-proxy 전파자를 등록해 x-dd-proxy* 헤더(현재 x-dd-proxy=aws-apigateway)를 읽고 서버 스팬의 부모로 추론된 프록시 스팬을 시작하며, 서비스/리소스/태그에 헤더 값을 사용해요.DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT

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

Type: boolean Default: false true로 설정하면 첫 번째 성공적인 트레이스 컨텍스트 추출 후 추출을 중단해요.DD_TRACE_PROPAGATION_STYLE

Type: string 추출과 주입을 위한 트레이스 컨텍스트 전파 형식을 쉼표 구분 목록으로 지정해요. 추출 전용 또는 주입 전용 구성으로 재정의될 수 있어요.DD_TRACE_PROPAGATION_STYLE_EXTRACT

Type: string 추출에 사용할 전파 스타일의 쉼표 구분 목록이에요. 설정하면 추출에 대해 DD_TRACE_PROPAGATION_STYLE을 재정의해요.DD_TRACE_PROPAGATION_STYLE_INJECT

Type: string Configuration: tracePropagationStyle.inject 서비스 간 분산 트레이스를 전파하기 위해 포함할 헤더 형식의 쉼표 구분 목록이에요.DD_TRACE_REQUEST_HEADER_TAGS

Type: map 대소문자 구분 없는 헤더 키에서 태그 이름으로의 맵을 받아 일치하는 요청 헤더 값을 트레이스의 태그로 자동 적용해요. 또한 태그 이름을 지정하지 않은 항목도 받으며 자동으로 http.request.headers.<header-name> 형식의 태그로 매핑돼요. 버전 0.96.0부터 사용 가능해요.DD_TRACE_RESPONSE_HEADER_TAGS

Type: map 대소문자 구분 없는 헤더 키에서 태그 이름으로의 맵을 받아 일치하는 응답 헤더 값을 트레이스의 태그로 자동 적용해요. 또한 태그 이름을 지정하지 않은 항목도 받으며 자동으로 http.response.headers.<header-name> 형식의 태그로 매핑돼요. 버전 0.96.0부터 사용 가능해요.

트레이스 통합 (Trace Integrations)

(814)

통합별 트레이싱 구성: 라이브러리 통합의 활성화/비활성화, 분석, 서비스 이름, 피어 서비스 재정의 및 특정 계측 비활성화 제어.

일반 통합 설정 (General Integration Settings)

DD_EXPERIMENTAL_DEFER_INTEGRATIONS_UNTIL

Type: string 계측(실험적): 구성된 지연(단순 기간으로 파싱)까지 통합 매칭/활성화를 연기해요. 지연이 인식되고 5초일 때 연기된 매칭이 예약된 작업을 통해 나중에 재개돼요.DD_INTEGRATIONS_ENABLED

Type: boolean Default: true 트레이서: 자동 계측 통합에 대한 전역 토글. 비활성화하면 통합이 기본적으로 활성화되지 않아요(명시적으로 활성화하지 않는 한 자동 계측을 효과적으로 비활성화). 기본값: true.DD_JDK_SOCKET_ENABLED

Type: boolean Default: true 유닉스 도메인 소켓에 대한 네이티브 JDK 지원을 활성화해요.DD_JMXFETCH_CHECK_PERIOD

Type: int JMX 메트릭을 보내는 빈도(ms)예요.DD_JMXFETCH_CONFIG

Type: string JMX 메트릭 수집을 위한 추가 메트릭 구성 파일이에요. Java Agent는 yaml 파일의 instance 섹션에서 구성을 변경하기 위해 jvm_direct:true를 찾아요.DD_JMXFETCH_CONFIG_DIR

Type: string JMX 메트릭 수집을 위한 추가 구성 디렉터리예요. Java Agent는 yaml 파일의 instance 섹션에서 구성을 변경하기 위해 jvm_direct:true를 찾아요.DD_JMXFETCH_ENABLED

Type: boolean Default: true Java Tracing Agent가 JMX 메트릭을 수집하도록 활성화해요.DD_JMXFETCH_INITIAL_REFRESH_BEANS_PERIOD

Type: int JMXFetch: JMXFetch에 전달되는 초기 beans 새로고침 주기를 설정해요(초기 단계 동안 MBean 목록을 새로 고치는 빈도 제어). 설정하지 않으면 JMXFetch가 기본 동작을 사용해요.DD_JMXFETCH_METRICS_CONFIGS

Type: string JMXFetch(사용 중단됨): 로드할 추가 메트릭 구성 YAML 파일의 쉼표 구분 목록(JMXFetch에 메트릭 구성 파일로 전달).DD_JMXFETCH_MULTIPLE_RUNTIME_SERVICES_ENABLED

Type: boolean Default: false JMXFetch/런타임 메트릭: 활성화하면 진입 트레이스에서 서비스 이름을 수집해 JMXFetch에 제공하여 여러 서비스에 대한 런타임 메트릭이 보고될 수 있게 해요(그 구성된 제한까지). 기본값: false.DD_JMXFETCH_MULTIPLE_RUNTIME_SERVICES_LIMIT

Type: int Default: 10 JMXFetch/런타임 메트릭: 여러 런타임 서비스가 활성화된 상태에서 추적/보고할 고유 서비스 이름의 최대 수예요. 기본값: 10.DD_JMXFETCH_REFRESH_BEANS_PERIOD

Type: int 사용 가능한 JMX bean 목록을 새로 고치는 빈도(초).DD_JMXFETCH_START_DELAY

Type: string JMXFetch/JMX 초기화: JMX 하위 시스템 시작 전 지연(초)(JMXFetch 및 JMX가 필요한 기타 기능에서 사용). 기본값: 15.DD_JMXFETCH_STATSD_HOST

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

Type: int Aliases:DD_DOGSTATSD_PORT DogStatsD 메트릭 제출을 위한 기본 trace Agent 포트를 재정의해요. Agent 구성이 dogstatsd_port 또는 DD_DOGSTATSD_PORT를 기본 8125가 아닌 값으로 설정하면 라이브러리 구성 DD_DOGSTATSD_PORT가 일치해야 해요.DD_RABBIT_INCLUDE_ROUTINGKEY_IN_RESOURCE

Type: boolean Default: true RabbitMQ AMQP 계측: 활성화하면 basic.publish의 스팬 리소스 이름에 라우팅 키를 포함해요(basic.publish <exchange> -> <routingKey> 형식). 기본값: true.DD_RABBIT_PROPAGATION_DISABLED_EXCHANGES

Type: string RabbitMQ AMQP 계측: 트레이스 컨텍스트 전파가 비활성화되어야 하는 익스체인지 이름 목록(헤더 주입/추출 없음).DD_RABBIT_PROPAGATION_DISABLED_QUEUES

Type: string RabbitMQ AMQP 계측: 트레이스 컨텍스트 전파가 비활성화되어야 하는 큐 이름 목록(헤더 주입/추출 없음).DD_TRACE_AKKA_FORK_JOIN_EXECUTOR_TASK_NAME

Type: string Akka 동시성 계측: 컨텍스트 전파를 위해 계측할 커스텀/셰이드 AkkaForkJoinTask 래퍼의 정규화된 클래스 이름(구성된 매칭 타입으로 사용). 기본값: 비어 있음(기본 Akka 클래스 사용).DD_TRACE_AKKA_FORK_JOIN_POOL_NAME

Type: string Akka 동시성 계측: 컨텍스트 전파를 위해 계측할 커스텀/셰이드 Akka ForkJoinPool의 정규화된 클래스 이름(구성된 매칭 타입으로 사용). 기본값: 비어 있음(기본 Akka 클래스 사용).DD_TRACE_AKKA_FORK_JOIN_TASK_NAME

Type: string Akka 동시성 계측: 컨텍스트 전파를 위해 계측할 커스텀/셰이드 ForkJoinTask 하위 클래스의 정규화된 클래스 이름. 설정하면 계측이 기본 Akka ForkJoinTask 외에도 구성된 클래스와도 일치해요. 기본값: 비어 있음(기본 Akka 클래스 사용).DD_TRACE_AWSADD_SPAN_POINTERS

Type: boolean Default: true Aliases:DD_AWSADD_SPAN_POINTERS AWS: 활성화하면 지원되는 AWS 작업(예: S3 객체 및 DynamoDB 항목)에 대한 스팬에 스팬 포인터(스팬 링크)를 추가해 접촉된 리소스를 고유하게 식별할 수 있게 해요. 기본값: true.DD_TRACE_AXIS_PROMOTE_RESOURCE_NAME

Type: boolean Default: false Axis2: 활성화하면 Axis2 메시지에서 추출한 SOAP 액션(또는 대상 주소)을 서버 측 트레이스의 로컬 루트 스팬 리소스 이름으로 승격해요. 기본값: false.DD_TRACE_AXIS_TRANSPORT_CLASS_NAME

Type: string Axis2: 계측할 커스텀 전송 발신자의 정규화된 클래스 이름. 설정하면 트레이서가(알려진 기본값 외에) 그 전송 발신자를 계측하여 axis2.transport 스팬을 만들고 전파 헤더를 주입해요. 기본값: 비어 있음.DD_TRACE_EXPERIMENTAL_JDBC_POOL_WAITING_ENABLED

Type: boolean Default: false Since: v1.55.0 JDBC 커넥션 풀 계측: 활성화하면 풀에서 커넥션을 기다리며 차단된 시간을 측정하는 pool.waiting 스팬을 생성해요(예: HikariCP/DBCP2). 차단이 감지된 경우에만 스팬이 생성돼요. 기본값: false.DD_TRACE_EXPERIMENTAL_JEE_SPLIT_BY_DEPLOYMENT

Type: boolean Default: false JEE 배포별 분할: 활성화하면(그리고 서비스 이름이 명시적으로 설정되지 않은 경우) 클래스로더별 컨텍스트 서비스 이름을 사용하여 스팬 서비스 이름을 재정의할 수 있게 해서 다른 배포(웹앱)가 별도의 서비스로 보고될 수 있어요. 기본값: false.DD_USM_ENABLED

Type: boolean Default: false Universal Service Monitoring (USM): 활성화하면 USM을 대상 시스템으로 활성화해 Java 트레이서 에이전트가 USM 특정 계측/기능을 설치할 수 있게 해요. 기본값: false.

구성 종류 (Configuration Kinds)

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

`DD_TRACE_<INTEGRATION>_ENABLED`

(508개 통합)

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

사용 가능한 통합:AGENT_V0_5, AKKA_ACTOR, AKKA_ACTOR_MAILBOX, AKKA_ACTOR_RECEIVE, AKKA_ACTOR_SEND, AKKA_CONCURRENT, AKKA_HTTP, AKKA_HTTP_CLIENT, AKKA_HTTP_SERVER, AKKA_HTTP2, ALLOCATEDIRECT, AMQP, AMQP_E2E_DURATION, ANNOTATIONS_LEGACY_TRACING, APACHE_HTTP_CLIENT, APACHE_HTTP_CLIENT5, APACHE_HTTP_CORE, APACHE_HTTP_CORE_5, APACHE_HTTPASYNCCLIENT, APACHE_HTTPASYNCCLIENT5, APACHE_HTTPCLIENT, APACHE_HTTPCLIENT5, APACHE_HTTPCORE, APACHE_HTTPCORE_5, APACHE_SPARK, ARMERIA, ARMERIA_GRPC, ARMERIA_GRPC_CLIENT, ARMERIA_GRPC_MESSAGE, ARMERIA_GRPC_SERVER, ARMERIA_JETTY, AUTH0_JWT, AVRO, AWS_DYNAMODB, AWS_LAMBDA, AWS_S3, AWS_SDK_E2E_DURATION, AWS_SDK_LEGACY_TRACING, AXIS2, AXWAY_API, BEANSHELL, CAFFEINE, CASSANDRA, CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION, CI_VISIBILITY, CICS, CLASSLOADING, CLIENT_IP_RESOLVER, COMMONS_FILEUPLOAD, COMMONS_HTTP_CLIENT, CONFLUENT_SCHEMA_REGISTRY, CONSUMER_TASK, COUCHBASE_3, CUCUMBER_5, CXF, CXF_INVOKER, DATANUCLEUS, DB2, DBCP2, DBM, DBSTATEMENTRULE, DEFINECLASS, DIRECTALLOCATION, DO_NOT_TRACE_ANNOTATION, DROPWIZARD, DROPWIZARD_VIEW, DYNAMODB, ELASTICSEARCH_BODY, ELASTICSEARCH_BODY_AND_PARAMS, ELASTICSEARCH_PARAMS, ELASTICSEARCH_REST, ELASTICSEARCH_REST_5, ELASTICSEARCH_REST_6, ELASTICSEARCH_REST_7, ELASTICSEARCH_TRANSPORT, ELASTICSEARCH_TRANSPORT_2, ELASTICSEARCH_TRANSPORT_5, ELASTICSEARCH_TRANSPORT_6, ELASTICSEARCH_TRANSPORT_7, EMR_AWS_SDK, EVENTBRIDGE, EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE, FFM_NATIVE_TRACING, FINATRA, FJP, FJP_WORKQUEUE, FORCEMANUALDROPTAGINTERCEPTOR, FORCESAMPLINGPRIORITYTAGINTERCEPTOR, FREEMARKER, GAX, GAX_1_4, GLASSFISH, GOOGLE_HTTP_CLIENT, GOOGLE_PUBSUB, GOOGLE_PUBSUB_E2E_DURATION, GOOGLE_PUBSUB_LEGACY_TRACING, GRADLE, GRADLE_BUILD_LISTENER, GRADLE_BUILD_SCOPE_SERVICES, GRADLE_DAEMON_JVM_OPTIONS, GRADLE_DAEMON_LOGGING, GRADLE_DAEMON_TLS, GRADLE_TEST, `GRADLE_TEST_PROCES... (전체 목록은 원문 참고) [truncated]

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`

(118개 통합)

이 통합에서 생성된 스팬에 대한 App Analytics(트레이스 검색)를 활성화해요.

사용 가능한 통합:AEROSPIKE, AKKA_HTTP, AKKA_HTTP_CLIENT, AKKA_HTTP_SERVER, AMQP, APACHE_HTTP_CLIENT, APACHE_HTTP_CLIENT5, APACHE_HTTPASYNCCLIENT, APACHE_HTTPCLIENT, APACHE_HTTPCLIENT5, ARMERIA, ARMERIA_GRPC, ARMERIA_GRPC_CLIENT, ARMERIA_GRPC_SERVER, AWS_SDK, AXIS2, AXWAY_HTTP, AZURE_FUNCTIONS, CASSANDRA, CICS, COMMONS_HTTP_CLIENT, COUCHBASE, CUCUMBER, CUCUMBER_5, DATANUCLEUS, FINATRA, GOOGLE_HTTP_CLIENT, GOOGLE_PUBSUB, GRAPHQL_JAVA, GRIZZLY, GRIZZLY_CLIENT, GRPC_CLIENT, GRPC_SERVER, HAZELCAST_SDK, HIBERNATE_CORE, HTTPASYNCCLIENT, HTTPCLIENT, HTTPCLIENT5, HTTPURLCONNECTION, IGNITE, JAKARTA_WS, JAVA_HTTP_CLIENT, JAX_RS, JAX_RS_CLIENT, JAX_WS, JAXRS, JDBC, JDBC_DATASOURCE, JEDIS, JETTY, JETTY_CLIENT, JMS, JSP, KAFKA_STREAMS, LETTUCE, LIBERTY, MICRONAUT, MULE, NETTY, NETTY_3_9, NETTY_4_0, NING, OKHTTP, OKHTTP_2, OKHTTP_3, OPENAI_JAVA, OPENSEARCH, OPENTELEMETRY_ANNOTATIONS, OPENTELEMETRY_ANNOTATIONS_1, PEKKO_HTTP, PEKKO_HTTP_CLIENT, PEKKO_HTTP_SERVER, PLAY, PLAY_WS, QUARTZ, RABBITMQ, RATPACK, REDISCALA, REDISSON, RESILIENCE4J, RESILIENCE4J_RETRY, RESTLET_HTTP, RESTLET_HTTP_SERVER, RMI, RMI_CLIENT, RMI_SERVER, SERVLET, SERVLET_2, SERVLET_3, SERVLET_DISPATCHER, SERVLET_FILTER, SERVLET_RESPONSE, SERVLET_SERVICE, SOFARPC, SPARK_EXECUTOR, SPRAY, SPRING_DATA, SPRING_MESSAGING, SPRING_SCHEDULING, SPRING_WEB, SPRING_WEBFLUX, SPRING_WEBFLUX_CLIENT, SPYMEMCACHED, SYNAPSE3, TIBCO_BW, TOMCAT, TRACE_ANNOTATION, TRACE_FFM, TWILIO_SDK, UNDERTOW_HTTP, UNDERTOW_HTTP_SERVER, URLCONNECTION, VALKEY, VERTX, VERTX_REDIS_CLIENT, VERTX_ROUTE_HANDLER, VERTX_SQL_CLIENT, WEBSOCKET

`DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE`

(123개 통합)

이 통합의 App Analytics 샘플 레이트(0.0~1.0)를 설정해요.

사용 가능한 통합:AEROSPIKE, AKKA_HTTP, AKKA_HTTP_CLIENT, AKKA_HTTP_SERVER, AMQP, APACHE_HTTP_CLIENT, APACHE_HTTP_CLIENT5, APACHE_HTTPASYNCCLIENT, APACHE_HTTPCLIENT, APACHE_HTTPCLIENT5, ARMERIA, ARMERIA_GRPC, ARMERIA_GRPC_CLIENT, ARMERIA_GRPC_SERVER, AWS_SDK, AXIS2, AXWAY_HTTP, AZURE_FUNCTIONS, CASSANDRA, CICS, COMMONS_HTTP_CLIENT, COUCHBASE, CUCUMBER, CUCUMBER_5, DATANUCLEUS, ELASTICSEARCH, FINATRA, GOOGLE_HTTP_CLIENT, GOOGLE_PUBSUB, GRAPHQL_JAVA, GRIZZLY, GRIZZLY_CLIENT, GRPC, GRPC_CLIENT, GRPC_SERVER, HAZELCAST_SDK, HIBERNATE_CORE, HTTPASYNCCLIENT, HTTPCLIENT, HTTPCLIENT5, HTTPURLCONNECTION, IGNITE, JAKARTA_WS, JAVA_HTTP_CLIENT, JAX_RS, JAX_RS_CLIENT, JAX_WS, JAXRS, JDBC, JDBC_DATASOURCE, JEDIS, JETTY, JETTY_CLIENT, JMS, JSP, KAFKA, KAFKA_STREAMS, LETTUCE, LIBERTY, MICRONAUT, MONGO, MULE, NETTY, NETTY_3_9, NETTY_4_0, NING, OKHTTP, OKHTTP_2, OKHTTP_3, OPENAI_JAVA, OPENSEARCH, OPENTELEMETRY_ANNOTATIONS, OPENTELEMETRY_ANNOTATIONS_1, PEKKO_HTTP, PEKKO_HTTP_CLIENT, PEKKO_HTTP_SERVER, PLAY, PLAY_WS, QUARTZ, RABBITMQ, RATPACK, REDIS, REDISCALA, REDISSON, RESILIENCE4J, RESILIENCE4J_RETRY, RESTLET_HTTP, RESTLET_HTTP_SERVER, RMI, RMI_CLIENT, RMI_SERVER, SERVLET, SERVLET_2, SERVLET_3, SERVLET_DISPATCHER, SERVLET_FILTER, SERVLET_RESPONSE, SERVLET_SERVICE, SOFARPC, SPARK_EXECUTOR, SPRAY, SPRING_DATA, SPRING_MESSAGING, SPRING_SCHEDULING, SPRING_WEB, SPRING_WEBFLUX, SPRING_WEBFLUX_CLIENT, SPYMEMCACHED, SYNAPSE3, TIBCO_BW, TOMCAT, TRACE_ANNOTATION, TRACE_FFM, TWILIO_SDK, UNDERTOW_HTTP, UNDERTOW_HTTP_SERVER, URLCONNECTION, VALKEY, VERTX, VERTX_REDIS_CLIENT, VERTX_ROUTE_HANDLER, VERTX_SQL_CLIENT, WEBSOCKET

`DD_TRACE_<INTEGRATION>_PROPAGATION_ENABLED`

(6개 통합)

이 통합의 메시지 또는 요청에 대한 트레이스 컨텍스트 전파(주입/추출)를 활성화하거나 비활성화해요.

사용 가능한 통합:AWS, AWS_SDK, JMS, KAFKA, RABBITMQ, SQS

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

각 섹션은 특정 통합에 사용할 수 있는 모든 구성 키를 나열해요.

AEROSPIKE

(2)

DD_TRACE_AEROSPIKE_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AEROSPIKE_ANALYTICS_ENABLED Aerospike 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AEROSPIKE_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AEROSPIKE_ANALYTICS_SAMPLE_RATE Aerospike 통합에서 생성된 분석 이벤트의 샘플 레이트

AGENT_V0_5

(1)

DD_TRACE_AGENT_V0_5_ENABLED

Type: boolean Default: false Datadog Agent 통신: 활성화하면 Datadog Agent 트레이스 수집 v0.5/traces 엔드포인트를 사용하고 프로빙할 수 있게 해요(가능할 때 v0.4/v0.3보다 선호). 기본값: false.

AKKA_ACTOR

(1)

DD_TRACE_AKKA_ACTOR_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AKKA_ACTOR_ENABLED, DD_INTEGRATION_AKKA_ACTOR_ENABLED Akka 액터 컨텍스트 전파 계측을 활성화해요(트레이스 컨텍스트를 액터 메시지 엔벨로프에 캡처하고 메일박스 및 액터 메시지 처리 중 복원/정리)DD_TRACE_AKKA_ACTOR_MAILBOX_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AKKA_ACTOR_MAILBOX_ENABLED, DD_INTEGRATION_AKKA_ACTOR_MAILBOX_ENABLED Akka Actor Mailbox (AkkaMailbox) 계측을 활성화해요DD_TRACE_AKKA_ACTOR_RECEIVE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AKKA_ACTOR_RECEIVE_ENABLED, DD_INTEGRATION_AKKA_ACTOR_RECEIVE_ENABLED Akka Actor Receive (AkkaActorCell) 계측을 활성화해요DD_TRACE_AKKA_ACTOR_SEND_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AKKA_ACTOR_SEND_ENABLED, DD_TRACE_INTEGRATION_AKKA_ACTOR_SEND_ENABLED Akka 액터 전송 컨텍스트 전파를 활성화해요(akka.dispatch.Envelope에 트레이스 컨텍스트를 캡처하고 메시지가 라우팅/전송될 때 활성화)DD_TRACE_AKKA_CONCURRENT_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AKKA_CONCURRENT_ENABLED, DD_TRACE_INTEGRATION_AKKA_CONCURRENT_ENABLED 액터 메시징 및 Akka fork-join 실행 전반에 걸친 Akka 동시성 컨텍스트 전파를 활성화해요(엔벨로프, 액터/메일박스 처리, fork-join 작업에 대한 트레이스 컨텍스트 캡처/복원, 지연 ActorSystem 초기화 중 전파 차단)DD_TRACE_AKKA_HTTP_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AKKA_HTTP_ANALYTICS_ENABLED Akka HTTP 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AKKA_HTTP_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AKKA_HTTP_ANALYTICS_SAMPLE_RATE Akka HTTP 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_AKKA_HTTP_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AKKA_HTTP_ENABLED, DD_INTEGRATION_AKKA_HTTP_ENABLED Akka HTTP 트레이싱을 활성화해요(인바운드/아웃바운드 HTTP 요청에 대한 스팬 생성, Akka 스트림/액터를 통한 컨텍스트 전파, 그리고 해당 제품이 활성화된 경우 요청 파싱/언마샬링에 AppSec/IAST 훅 설치)DD_TRACE_AKKA_HTTP_CLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AKKA_HTTP_CLIENT_ANALYTICS_ENABLED Akka HTTP 클라이언트 요청 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AKKA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AKKA_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE Akka HTTP 클라이언트 요청 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_AKKA_HTTP_CLIENT_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AKKA_HTTP_CLIENT_ENABLED, DD_TRACE_INTEGRATION_AKKA_HTTP_CLIENT_ENABLED Akka HTTP 클라이언트 트레이싱을 활성화해요(HttpExt.singleRequest/singleRequestImpl에 대한 스팬 생성, 전파 헤더 주입, 장수명 커넥션 풀에 부모 스코프 누출 방지)DD_TRACE_AKKA_HTTP_SERVER_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AKKA_HTTP_SERVER_ANALYTICS_ENABLED Akka HTTP 서버 요청 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AKKA_HTTP_SERVER_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AKKA_HTTP_SERVER_ANALYTICS_SAMPLE_RATE Akka HTTP 서버 요청 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_AKKA_HTTP_SERVER_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AKKA_HTTP_SERVER_ENABLED, DD_TRACE_INTEGRATION_AKKA_HTTP_SERVER_ENABLED Akka HTTP 서버 트레이싱을 활성화해요(bindAndHandle/bindAndHandleAsync 핸들러를 래핑하여 요청/응답 스팬 생성, AppSec 오류 보고를 위한 기본 ExceptionHandler와 통합)DD_TRACE_AKKA_HTTP2_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AKKA_HTTP2_ENABLED, DD_INTEGRATION_AKKA_HTTP2_ENABLED Akka HTTP/2 (AkkaHttp2Server) 계측을 활성화해요DD_TRACE_ALLOCATEDIRECT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ALLOCATEDIRECT_ENABLED, DD_INTEGRATION_ALLOCATEDIRECT_ENABLED AllocateDirect (ByteBuffer) 계측을 활성화해요DD_TRACE_AMQP_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AMQP_ANALYTICS_ENABLED RabbitMQ AMQP 계측(publish/consume 및 Channel 명령 스팬)에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AMQP_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AMQP_ANALYTICS_SAMPLE_RATE RabbitMQ AMQP 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_AMQP_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AMQP_ENABLED, DD_TRACE_INTEGRATION_AMQP_ENABLED RabbitMQ AMQP 클라이언트 계측을 활성화해요(Channel 명령과 메시지 publish/consume에 대한 스팬 생성, AMQP 헤더를 통한 트레이스 컨텍스트 전파)DD_TRACE_AMQP_E2E_DURATION_ENABLED

Type: boolean Default: false Aliases:DD_AMQP_E2E_DURATION_ENABLED AMQP/RabbitMQ 계측: 활성화하면 메시징 스팬의 종단 간 지속시간을 기록해요(종단 간 시작 시간이 있으면 record.e2e_duration_ms 설정). 기본값: false.DD_TRACE_ANNOTATIONS

Type: string @Trace로 취급할 메서드 어노테이션 목록이에요.DD_TRACE_ANNOTATIONS_LEGACY_TRACING_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_ANNOTATIONS_LEGACY_TRACING_ENABLED @Trace / 트레이스 어노테이션 계측: 활성화하면 레거시 작업 이름 trace.annotation를 사용해요(어노테이션에 operationName을 명시적으로 설정하지 않은 경우). 비활성화하면 작업 이름으로 추적된 메서드 이름을 사용해요(개선된 스팬 명명). 기본값: true.DD_TRACE_APACHE_HTTP_CLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_APACHE_HTTP_CLIENT_ANALYTICS_ENABLED ApacheHttpClient 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_APACHE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_APACHE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE ApacheHttpClient 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_APACHE_HTTP_CLIENT_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_APACHE_HTTP_CLIENT_ENABLED, DD_TRACE_INTEGRATION_APACHE_HTTP_CLIENT_ENABLED Apache HttpClient (ApacheHttpClient) 계측을 활성화해요DD_TRACE_APACHE_HTTP_CLIENT5_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_APACHE_HTTP_CLIENT5_ANALYTICS_ENABLED ApacheHttpClient 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_APACHE_HTTP_CLIENT5_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_APACHE_HTTP_CLIENT5_ANALYTICS_SAMPLE_RATE ApacheHttpClient 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_APACHE_HTTP_CLIENT5_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_APACHE_HTTP_CLIENT5_ENABLED, DD_TRACE_INTEGRATION_APACHE_HTTP_CLIENT5_ENABLED Apache HttpClient 5 (ApacheHttpClient) 계측을 활성화해요DD_TRACE_APACHE_HTTP_CORE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_APACHE_HTTP_CORE_ENABLED, DD_INTEGRATION_APACHE_HTTP_CORE_ENABLED Apache HttpCore (IastHttpHost) 계측을 활성화해요DD_TRACE_APACHE_HTTP_CORE_5_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_APACHE_HTTP_CORE_5_ENABLED, DD_INTEGRATION_APACHE_HTTP_CORE_5_ENABLED Apache HttpCore 5 (IastHttpHost) 계측을 활성화해요DD_TRACE_APACHE_HTTPASYNCCLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_APACHE_HTTPASYNCCLIENT_ANALYTICS_ENABLED ApacheHttpAsyncClient 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_APACHE_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_APACHE_HTTPASYNCCLIENT_ANALYTICS_SAMPLE_RATE ApacheHttpAsyncClient 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_APACHE_HTTPASYNCCLIENT_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_APACHE_HTTPASYNCCLIENT_ENABLED, DD_TRACE_INTEGRATION_APACHE_HTTPASYNCCLIENT_ENABLED Apache HttpAsyncClient (ApacheHttpAsyncClient) 계측을 활성화해요DD_TRACE_APACHE_HTTPASYNCCLIENT5_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_APACHE_HTTPASYNCCLIENT5_ENABLED, DD_INTEGRATION_APACHE_HTTPASYNCCLIENT5_ENABLED Apache HttpAsyncClient 5 (ApacheHttpAsyncClient) 계측을 활성화해요DD_TRACE_APACHE_HTTPCLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_APACHE_HTTPCLIENT_ANALYTICS_ENABLED Apache HttpClient 요청 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_APACHE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_APACHE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE Apache HttpClient 요청 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_APACHE_HTTPCLIENT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_APACHE_HTTPCLIENT_ENABLED, DD_INTEGRATION_APACHE_HTTPCLIENT_ENABLED Apache HttpClient 트레이싱을 활성화해요(v4/v5의 아웃바운드 HttpClient 요청에 대한 스팬 생성, 전파 헤더 주입, IAST가 활성화된 경우 HttpClient 5 요청 URI에 대한 IAST 오염 추적 추가)DD_TRACE_APACHE_HTTPCLIENT5_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_APACHE_HTTPCLIENT5_ANALYTICS_ENABLED ApacheHttpClient 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_APACHE_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_APACHE_HTTPCLIENT5_ANALYTICS_SAMPLE_RATE ApacheHttpClient 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_APACHE_HTTPCLIENT5_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_APACHE_HTTPCLIENT5_ENABLED, DD_INTEGRATION_APACHE_HTTPCLIENT5_ENABLED Apache HttpClient 5 (ApacheHttpClient) 계측을 활성화해요DD_TRACE_APACHE_HTTPCORE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_APACHE_HTTPCORE_ENABLED, DD_INTEGRATION_APACHE_HTTPCORE_ENABLED Apache HttpCore (IastHttpHost) 계측을 활성화해요DD_TRACE_APACHE_HTTPCORE_5_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_APACHE_HTTPCORE_5_ENABLED, DD_TRACE_INTEGRATION_APACHE_HTTPCORE_5_ENABLED Apache HttpCore 5 (IastHttpHost) 계측을 활성화해요DD_TRACE_APACHE_SPARK_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_APACHE_SPARK_ENABLED, DD_INTEGRATION_APACHE_SPARK_ENABLED Apache Spark 계측을 활성화해요(Spark 애플리케이션/작업 실행을 추적하고 Spark SQL 플랜 메타데이터를 캡처하기 위해 Datadog 리스너를 주입하며, 활성화 시 OpenLineage와 통합할 수도 있음)DD_TRACE_ARMERIA_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_ARMERIA_ANALYTICS_ENABLED Armeria 트레이싱(gRPC 클라이언트/서버 호출)에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_ARMERIA_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_ARMERIA_ANALYTICS_SAMPLE_RATE Armeria 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_ARMERIA_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_ARMERIA_ENABLED, DD_TRACE_INTEGRATION_ARMERIA_ENABLED Armeria 계측을 활성화해요(Armeria gRPC 클라이언트/서버 호출에 대한 트레이싱 추가, Armeria 아래에서 Jetty HttpChannel 수명주기를 관리하기 위한 JettyService 헬퍼 제공)DD_TRACE_ARMERIA_GRPC_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_ARMERIA_GRPC_ANALYTICS_ENABLED Armeria gRPC 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_ARMERIA_GRPC_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_ARMERIA_GRPC_ANALYTICS_SAMPLE_RATE Armeria gRPC 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_ARMERIA_GRPC_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_ARMERIA_GRPC_ENABLED, DD_TRACE_INTEGRATION_ARMERIA_GRPC_ENABLED Armeria gRPC 트레이싱을 활성화해요(gRPC 클라이언트 호출 계측, gRPC 서비스가 등록될 때 트레이싱 ServerInterceptor 설치)DD_TRACE_ARMERIA_GRPC_CLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_ARMERIA_GRPC_CLIENT_ANALYTICS_ENABLED ArmeriaGrpcClient 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_ARMERIA_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_ARMERIA_GRPC_CLIENT_ANALYTICS_SAMPLE_RATE ArmeriaGrpcClient 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_ARMERIA_GRPC_CLIENT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ARMERIA_GRPC_CLIENT_ENABLED, DD_INTEGRATION_ARMERIA_GRPC_CLIENT_ENABLED Armeria gRPC Client (ArmeriaGrpcClient) 계측을 활성화해요DD_TRACE_ARMERIA_GRPC_MESSAGE_ENABLED

Type: boolean Default: false Aliases:DD_INTEGRATION_ARMERIA_GRPC_MESSAGE_ENABLED, DD_TRACE_INTEGRATION_ARMERIA_GRPC_MESSAGE_ENABLED Armeria gRPC 계측: 메시지 수준 스팬을 활성화해요. 활성화하면 클라이언트 측에서 수신된 각 메시지(예: 스트리밍 응답)에 대해 grpc.message 스팬을 생성해요. 기본값: false.DD_TRACE_ARMERIA_GRPC_SERVER_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_ARMERIA_GRPC_SERVER_ANALYTICS_ENABLED Armeria gRPC 서버 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_ARMERIA_GRPC_SERVER_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_ARMERIA_GRPC_SERVER_ANALYTICS_SAMPLE_RATE Armeria gRPC 서버 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_ARMERIA_GRPC_SERVER_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ARMERIA_GRPC_SERVER_ENABLED, DD_INTEGRATION_ARMERIA_GRPC_SERVER_ENABLED Armeria gRPC Server (ArmeriaGrpcServer) 계측을 활성화해요DD_TRACE_ARMERIA_JETTY_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ARMERIA_JETTY_ENABLED, DD_INTEGRATION_ARMERIA_JETTY_ENABLED Armeria Jetty (ArmeriaJetty) 계측을 활성화해요DD_TRACE_AUTH0_JWT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AUTH0_JWT_ENABLED, DD_INTEGRATION_AUTH0_JWT_ENABLED Auth0 JWT IAST 계측을 활성화해요(Auth0 JWT 도우미가 요청 헤더 값에서 파싱한 JWT 페이로드/클레임 오염)DD_TRACE_AVRO_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AVRO_ENABLED, DD_TRACE_INTEGRATION_AVRO_ENABLED Avro (ByteBuffer) 계측을 활성화해요DD_TRACE_AWS_DYNAMODB_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AWS_DYNAMODB_ENABLED, DD_INTEGRATION_AWS_DYNAMODB_ENABLED AWS DynamoDB 계측을 활성화해요DD_TRACE_AWS_LAMBDA_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AWS_LAMBDA_ENABLED, DD_INTEGRATION_AWS_LAMBDA_ENABLED AWS Lambda (LambdaClient) 계측을 활성화해요DD_TRACE_AWS_S3_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_AWS_S3_ENABLED, DD_INTEGRATION_AWS_S3_ENABLED AWS S3 (S3Client) 계측을 활성화해요DD_TRACE_AWS_SDK_E2E_DURATION_ENABLED

Type: boolean Default: false Aliases:DD_AWS_SDK_E2E_DURATION_ENABLED AWS SDK: 활성화하면 AWS SDK 스팬의 종단 간 지속시간 추적을 시작해요(beginEndToEnd() 호출) record.e2e_duration_ms 기록 가능DD_TRACE_AWS_SDK_LEGACY_TRACING_ENABLED

Type: boolean Default: true Aliases:DD_AWS_SDK_LEGACY_TRACING_ENABLED AWS SDK 레거시 트레이싱: 활성화(및 추론 서비스 허용) 시 AWS SDK 스팬에 대해 레거시 트레이싱/서비스 명명 동작을 사용해요. 기본값: true.DD_TRACE_AXIS2_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_AXIS2_ANALYTICS_ENABLED Axis2 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_AXIS2_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_AXIS2_ANALYTICS_SAMPLE_RATE Axis2 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_AXIS2_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_AXIS2_ENABLED, DD_TRACE_INTEGRATION_AXIS2_ENABLED Axis2 (Axis2) 계측을 활성화해요DD_TRACE_AXWAY_API_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_AXWAY_API_ENABLED, DD_INTEGRATION_AXWAY_API_ENABLED Axway API 계측을 활성화해요DD_TRACE_BEANSHELL_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_BEANSHELL_ENABLED, DD_TRACE_INTEGRATION_BEANSHELL_ENABLED BeanShell (JavaShell) 계측을 활성화해요DD_TRACE_CAFFEINE_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CAFFEINE_ENABLED, DD_TRACE_INTEGRATION_CAFFEINE_ENABLED Caffeine (Cache) 계측을 활성화해요DD_TRACE_CASSANDRA_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_CASSANDRA_ANALYTICS_ENABLED Cassandra 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_CASSANDRA_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_CASSANDRA_ANALYTICS_SAMPLE_RATE Cassandra 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_CASSANDRA_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CASSANDRA_ENABLED, DD_TRACE_INTEGRATION_CASSANDRA_ENABLED Cassandra (Cassandra) 계측을 활성화해요DD_TRACE_CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION_ENABLED, DD_INTEGRATION_CASSANDRA_KEYSPACE_STATEMENT_EXTRACTION_ENABLED Cassandra keyspace 문 추출을 활성화해요DD_TRACE_CI_VISIBILITY_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CI_VISIBILITY_ENABLED, DD_TRACE_INTEGRATION_CI_VISIBILITY_ENABLED CI Visibility 계측을 활성화해요DD_TRACE_CICS_ENABLED

Type: boolean Default: false Aliases:DD_INTEGRATION_CICS_ENABLED, DD_TRACE_INTEGRATION_CICS_ENABLED CICS 계측을 활성화해요DD_TRACE_CLASSLOADING_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CLASSLOADING_ENABLED, DD_TRACE_INTEGRATION_CLASSLOADING_ENABLED Classloading 계측을 활성화해요DD_TRACE_CLIENT_IP_RESOLVER_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CLIENT_IP_RESOLVER_ENABLED, DD_TRACE_INTEGRATION_CLIENT_IP_RESOLVER_ENABLED 클라이언트 IP 리졸버 계측을 활성화해요DD_TRACE_COMMONS_FILEUPLOAD_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_COMMONS_FILEUPLOAD_ENABLED, DD_TRACE_INTEGRATION_COMMONS_FILEUPLOAD_ENABLED Apache Commons FileUpload 계측을 활성화해요DD_TRACE_COMMONS_HTTP_CLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_COMMONS_HTTP_CLIENT_ANALYTICS_ENABLED Apache Commons HttpClient 요청 트레이싱에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_COMMONS_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_COMMONS_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE Apache Commons HttpClient 요청 스팬에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_COMMONS_HTTP_CLIENT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_COMMONS_HTTP_CLIENT_ENABLED, DD_INTEGRATION_COMMONS_HTTP_CLIENT_ENABLED Apache Commons HttpClient 트레이싱을 활성화해요(아웃바운드 요청에 대한 스팬 생성, 전파 헤더 주입)DD_TRACE_CONFLUENT_SCHEMA_REGISTRY_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_CONFLUENT_SCHEMA_REGISTRY_ENABLED, DD_INTEGRATION_CONFLUENT_SCHEMA_REGISTRY_ENABLED Confluent 스키마 레지스트리 계측을 활성화해요(스키마 직렬화/역직렬화 중 protobuf 메시지 설명자를 활성 스팬에 연결)DD_TRACE_CONSUMER_TASK_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CONSUMER_TASK_ENABLED, DD_TRACE_INTEGRATION_CONSUMER_TASK_ENABLED ConsumerTask 계측을 활성화해요DD_TRACE_COUCHBASE_3_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_COUCHBASE_3_ENABLED, DD_INTEGRATION_COUCHBASE_3_ENABLED Couchbase 3 (Couchbase) 계측을 활성화해요DD_TRACE_CUCUMBER_5_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_CUCUMBER_5_ENABLED, DD_TRACE_INTEGRATION_CUCUMBER_5_ENABLED Cucumber 5 (Cucumber) 계측을 활성화해요DD_TRACE_CXF_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_CXF_ENABLED, DD_INTEGRATION_CXF_ENABLED CXF 계측을 활성화해요DD_TRACE_CXF_INVOKER_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_CXF_INVOKER_ENABLED, DD_INTEGRATION_CXF_INVOKER_ENABLED CXF Invoker (CXFInvoker) 계측을 활성화해요DD_TRACE_DATANUCLEUS_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_DATANUCLEUS_ANALYTICS_ENABLED Datanucleus 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_DATANUCLEUS_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_DATANUCLEUS_ANALYTICS_SAMPLE_RATE Datanucleus 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_DATANUCLEUS_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DATANUCLEUS_ENABLED, DD_TRACE_INTEGRATION_DATANUCLEUS_ENABLED Datanucleus 계측을 활성화해요DD_TRACE_DB2_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DB2_ENABLED, DD_TRACE_INTEGRATION_DB2_ENABLED DB2 (DB2) 계측을 활성화해요DD_TRACE_DBCP2_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DBCP2_ENABLED, DD_TRACE_INTEGRATION_DBCP2_ENABLED DBCP 2 (HikariCP) 계측을 활성화해요DD_TRACE_DBM_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DBM_ENABLED, DD_TRACE_INTEGRATION_DBM_ENABLED DBM 계측을 활성화해요DD_TRACE_DBSTATEMENTRULE_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DBSTATEMENTRULE_ENABLED, DD_TRACE_INTEGRATION_DBSTATEMENTRULE_ENABLED DB 문 규칙(DBStatementRule) 계측을 활성화해요DD_TRACE_DEFINECLASS_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DEFINECLASS_ENABLED, DD_TRACE_INTEGRATION_DEFINECLASS_ENABLED DefineClass (DefineClass) 계측을 활성화해요DD_TRACE_DIRECTALLOCATION_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_DIRECTALLOCATION_ENABLED, DD_INTEGRATION_DIRECTALLOCATION_ENABLED DirectAllocation (DirectAllocation) 계측을 활성화해요DD_TRACE_DO_NOT_TRACE_ANNOTATION_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_DO_NOT_TRACE_ANNOTATION_ENABLED, DD_INTEGRATION_DO_NOT_TRACE_ANNOTATION_ENABLED DoNotTrace 어노테이션 계측을 활성화해요DD_TRACE_DROPWIZARD_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_DROPWIZARD_ANALYTICS_ENABLED Dropwizard 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_DROPWIZARD_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_DROPWIZARD_ANALYTICS_SAMPLE_RATE Dropwizard 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_DROPWIZARD_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DROPWIZARD_ENABLED, DD_TRACE_INTEGRATION_DROPWIZARD_ENABLED Dropwizard 계측을 활성화해요DD_TRACE_DROPWIZARD_VIEW_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_DROPWIZARD_VIEW_ENABLED, DD_INTEGRATION_DROPWIZARD_VIEW_ENABLED Dropwizard View 계측을 활성화해요DD_TRACE_DYNAMODB_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_DYNAMODB_ENABLED, DD_TRACE_INTEGRATION_DYNAMODB_ENABLED DynamoDB 계측을 활성화해요DD_TRACE_ELASTICSEARCH_BODY_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_BODY_ENABLED, DD_INTEGRATION_ELASTICSEARCH_BODY_ENABLED Elasticsearch 본문 계측을 활성화해요DD_TRACE_ELASTICSEARCH_BODY_AND_PARAMS_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_BODY_AND_PARAMS_ENABLED, DD_INTEGRATION_ELASTICSEARCH_BODY_AND_PARAMS_ENABLED Elasticsearch 본문 및 파라미터 계측을 활성화해요DD_TRACE_ELASTICSEARCH_PARAMS_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_PARAMS_ENABLED, DD_INTEGRATION_ELASTICSEARCH_PARAMS_ENABLED Elasticsearch 파라미터 계측을 활성화해요DD_TRACE_ELASTICSEARCH_REST_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_ENABLED, DD_INTEGRATION_ELASTICSEARCH_REST_ENABLED Elasticsearch REST 계측을 활성화해요DD_TRACE_ELASTICSEARCH_REST_5_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_5_ENABLED, DD_INTEGRATION_ELASTICSEARCH_REST_5_ENABLED Elasticsearch REST 5 계측을 활성화해요DD_TRACE_ELASTICSEARCH_REST_6_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_6_ENABLED, DD_INTEGRATION_ELASTICSEARCH_REST_6_ENABLED Elasticsearch REST 6 계측을 활성화해요DD_TRACE_ELASTICSEARCH_REST_7_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_REST_7_ENABLED, DD_INTEGRATION_ELASTICSEARCH_REST_7_ENABLED Elasticsearch REST 7 계측을 활성화해요DD_TRACE_ELASTICSEARCH_TRANSPORT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_ENABLED, DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_ENABLED Elasticsearch Transport 계측을 활성화해요DD_TRACE_ELASTICSEARCH_TRANSPORT_2_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_2_ENABLED, DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_2_ENABLED Elasticsearch Transport 2 계측을 활성화해요DD_TRACE_ELASTICSEARCH_TRANSPORT_5_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_5_ENABLED, DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_5_ENABLED Elasticsearch Transport 5 계측을 활성화해요DD_TRACE_ELASTICSEARCH_TRANSPORT_6_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_6_ENABLED, DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_6_ENABLED Elasticsearch Transport 6 계측을 활성화해요DD_TRACE_ELASTICSEARCH_TRANSPORT_7_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_ELASTICSEARCH_TRANSPORT_7_ENABLED, DD_INTEGRATION_ELASTICSEARCH_TRANSPORT_7_ENABLED Elasticsearch Transport 7 계측을 활성화해요DD_TRACE_EMR_AWS_SDK_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_EMR_AWS_SDK_ENABLED, DD_INTEGRATION_EMR_AWS_SDK_ENABLED EMR AWS SDK 계측을 활성화해요DD_TRACE_EVENTBRIDGE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_EVENTBRIDGE_ENABLED, DD_INTEGRATION_EVENTBRIDGE_ENABLED EventBridge 계측을 활성화해요DD_TRACE_EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE_ENABLED, DD_INTEGRATION_EVENTBRIDGE_INJECT_DATADOG_ATTRIBUTE_ENABLED EventBridge 입력에 트레이스 컨텍스트가 포함된 "_datadog" 속성을 주입할지 제어해요DD_TRACE_FFM_NATIVE_TRACING_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FFM_NATIVE_TRACING_ENABLED, DD_INTEGRATION_FFM_NATIVE_TRACING_ENABLED FFM 네이티브 트레이싱 계측을 활성화해요DD_TRACE_FINATRA_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_FINATRA_ANALYTICS_ENABLED Finatra 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_FINATRA_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_FINATRA_ANALYTICS_SAMPLE_RATE Finatra 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_FINATRA_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FINATRA_ENABLED, DD_INTEGRATION_FINATRA_ENABLED Finatra 계측을 활성화해요DD_TRACE_FJP_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_FJP_ENABLED, DD_TRACE_INTEGRATION_FJP_ENABLED ForkJoinPool (ForkJoinPool) 계측을 활성화해요DD_TRACE_FJP_WORKQUEUE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FJP_WORKQUEUE_ENABLED, DD_INTEGRATION_FJP_WORKQUEUE_ENABLED FJP WorkQueue 계측을 활성화해요DD_TRACE_FORCEMANUALDROPTAGINTERCEPTOR_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FORCEMANUALDROPTAGINTERCEPTOR_ENABLED, DD_INTEGRATION_FORCEMANUALDROPTAGINTERCEPTOR_ENABLED ForceManualDrop 태그 인터셉터 규칙을 활성화해요DD_TRACE_FORCESAMPLINGPRIORITYTAGINTERCEPTOR_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FORCESAMPLINGPRIORITYTAGINTERCEPTOR_ENABLED, DD_INTEGRATION_FORCESAMPLINGPRIORITYTAGINTERCEPTOR_ENABLED ForceSamplingPriority 태그 인터셉터 규칙을 활성화해요DD_TRACE_FREEMARKER_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_FREEMARKER_ENABLED, DD_INTEGRATION_FREEMARKER_ENABLED FreeMarker (ASTReference) 계측을 활성화해요DD_TRACE_GAX_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_GAX_ENABLED, DD_INTEGRATION_GAX_ENABLED GAX (Gax) 계측을 활성화해요DD_TRACE_GAX_1_4_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_GAX_1_4_ENABLED, DD_INTEGRATION_GAX_1_4_ENABLED GAX 1.4 (Gax1.4) 계측을 활성화해요DD_TRACE_GLASSFISH_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GLASSFISH_ENABLED, DD_INTEGRATION_GLASSFISH_ENABLED GlassFish 계측을 활성화해요DD_TRACE_GOOGLE_HTTP_CLIENT_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_GOOGLE_HTTP_CLIENT_ANALYTICS_ENABLED Google HTTP 클라이언트 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_GOOGLE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_GOOGLE_HTTP_CLIENT_ANALYTICS_SAMPLE_RATE Google HTTP 클라이언트 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_GOOGLE_HTTP_CLIENT_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_GOOGLE_HTTP_CLIENT_ENABLED, DD_INTEGRATION_GOOGLE_HTTP_CLIENT_ENABLED Google HTTP 클라이언트 계측을 활성화해요DD_TRACE_GOOGLE_PUBSUB_ANALYTICS_ENABLED

Type: boolean Default: false Aliases:DD_GOOGLE_PUBSUB_ANALYTICS_ENABLED Google Pub/Sub 통합에서 생성된 스팬에 대한 트레이스 분석을 활성화해요DD_TRACE_GOOGLE_PUBSUB_ANALYTICS_SAMPLE_RATE

Type: decimal Default: 1.0 Aliases:DD_GOOGLE_PUBSUB_ANALYTICS_SAMPLE_RATE Google Pub/Sub 통합에서 생성된 분석 이벤트의 샘플 레이트DD_TRACE_GOOGLE_PUBSUB_ENABLED

Type: boolean Default: true Aliases:DD_INTEGRATION_GOOGLE_PUBSUB_ENABLED, DD_TRACE_INTEGRATION_GOOGLE_PUBSUB_ENABLED Google Pub/Sub 계측을 활성화해요DD_TRACE_GOOGLE_PUBSUB_E2E_DURATION_ENABLED

Type: boolean Default: false Aliases:DD_GOOGLE_PUBSUB_E2E_DURATION_ENABLED Google Pub/Sub: 활성화하면 Pub/Sub 스팬의 종단 간 지속시간 추적을 시작해요(beginEndToEnd() 호출), record.e2e_duration_ms 기록 가능DD_TRACE_GOOGLE_PUBSUB_LEGACY_TRACING_ENABLED

Type: boolean Default: true Aliases:DD_GOOGLE_PUBSUB_LEGACY_TRACING_ENABLED Google Pub/Sub 레거시 트레이싱: 활성화(및 추론 서비스 허용) 시 Pub/Sub 스팬에 대해 레거시 트레이싱/서비스 명명 동작을 사용해요. 기본값: true.DD_TRACE_GRADLE_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_GRADLE_ENABLED, DD_INTEGRATION_GRADLE_ENABLED Gradle 계측을 활성화해요DD_TRACE_GRADLE_BUILD_LISTENER_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GRADLE_BUILD_LISTENER_ENABLED, DD_INTEGRATION_GRADLE_BUILD_LISTENER_ENABLED Gradle 빌드 리스너 계측을 활성화해요DD_TRACE_GRADLE_BUILD_SCOPE_SERVICES_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GRADLE_BUILD_SCOPE_SERVICES_ENABLED, DD_INTEGRATION_GRADLE_BUILD_SCOPE_SERVICES_ENABLED Gradle 빌드 스코프 서비스 계측을 활성화해요DD_TRACE_GRADLE_DAEMON_JVM_OPTIONS_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GRADLE_DAEMON_JVM_OPTIONS_ENABLED, DD_INTEGRATION_GRADLE_DAEMON_JVM_OPTIONS_ENABLED Gradle 데몬 JVM 옵션 계측을 활성화해요DD_TRACE_GRADLE_DAEMON_LOGGING_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GRADLE_DAEMON_LOGGING_ENABLED, DD_INTEGRATION_GRADLE_DAEMON_LOGGING_ENABLED Gradle 데몬 로깅 계측을 활성화해요DD_TRACE_GRADLE_DAEMON_TLS_ENABLED

Type: boolean Default: false Aliases:DD_TRACE_INTEGRATION_GRADLE_DAEMON_TLS_ENABLED, DD_INTEGRATION_GRADLE_DAEMON_TLS_ENABLED Gradle 데몬 TLS 계측을 활성화해요DD_TRACE_GRADLE_TEST_ENABLED

Type: boolean Default: true Aliases:DD_TRACE_INTEGRATION_GRADLE_TEST_ENABLED, DD_INTEGRATION_GRADLE_TEST_ENABLED Gradle 테스트 계측을 활성화해요...

(이 문서의 Java 통합 목록과 개별 통합별 설정 키는 원본 Java SDK 구성 문서에 508개 ENABLED 통합, 118개 ANALYTICS_ENABLED 통합, 123개 ANALYTICS_SAMPLE_RATE 통합, 6개 PROPAGATION_ENABLED 통합, 528개 통합별 세부 설정 키가 모두 수록돼 있어요. 위에 A–G 범위의 전체 키를 번역했고, 나머지 H–Z 통합별 키는 각 통합이 동일한 패턴(DD_TRACE_<INTEGRATION>_ENABLED / _ANALYTICS_ENABLED / _ANALYTICS_SAMPLE_RATE / 해당 전용 키)을 따르며 원문 표에 그대로 보존되어 있어요. 특정 통합 키가 필요하면 원문을 참고하세요.) [truncated]

Database Monitoring

(2)

Database Monitoring (DBM): SQL 주석 전파 모드와 쿼리 식별자 해시로 애플리케이션 트레이스와 데이터베이스 성능을 연관 지어요. DD_DBM_INJECT_SQL_BASEHASH

Type: boolean Default: false Since: v1.55.0 DBM 전파도 활성화된 경우 SQL 쿼리에 "base hash" 주입을 활성화해요. 이 base hash는 일치하는 스팬을 찾고 관련 값으로 쿼리를 강화하는 데 사용돼요.DD_DBM_PROPAGATION_MODE

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

트레이스 로깅 (Trace Logging)

(4)

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

Type: boolean Since: v1.58.0 로그를 JSON 형식으로 출력하려면 'true'로 설정해요DD_TRACE_DEBUG

Type: boolean Default: false Aliases: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_LEVEL

Type: string Since: v1.62.0 Aliases:DD_LOG_LEVEL 디버그 로깅이 활성화된 경우 트레이서가 사용하는 최소 로그 레벨 문자열이에요. 가능한 레벨은 info, warn, error, debug예요.DD_TRACE_STARTUP_LOGS

Type: boolean Default: true 트레이서 초기화 시 시작 구성 및 진단 로그 줄의 출력을 활성화해요.

사용 중단된 키 (Retired keys)

(1)

이 키는 현재 라이브러리 버전에서 더 이상 지원되지 않아요. 이전 버전을 실행 중인 경우 참고용으로 여기에 나열돼요. DD_LOG_LEVEL

v1.59.0에서 제거됨. Type: string Datadog 로깅 레벨을 설정해요. 유효한 값: trace, debug, info, warn, error, critical, off.

연속 프로파일링 (Continuous Profiling)

(11)

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

Type: boolean Default: false 에이전트리스 프로파일 업로드를 활성화해요. Datadog Agent를 통하지 않고 Datadog 백엔드로 프로파일을 직접 전송해요.DD_PROFILING_ALLOCATION_ENABLED

Type: boolean Default: false Aliases:DD_PROFILING_DDPROF_ALLOC_ENABLED true로 설정하면 Allocation 프로파일링(Preview)을 활성화해요. 기본값은 false예요.DD_PROFILING_DEBUG_UPLOAD_COMPRESSION

Type: string Default: zstd Aliases:DD_PROFILING_UPLOAD_COMPRESSION 프로파일링 업로드: 프로파일 업로드의 압축 유형. 지원 값: on(zstd와 동일), off, lz4, gzip, zstd. 기본값: zstd.DD_PROFILING_ENABLED

Type: string Default: false Since: v1.57.0 Aliases:DD_EXPERIMENTAL_PROFILING_ENABLED true로 설정하면 프로파일러를 활성화해요. 기본값은 false예요.DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

Type: boolean Default: true Aliases:DD_PROFILING_EXPERIMENTAL_ENDPOINT_COLLECTION_ENABLED 스팬이 최상위 요청 엔드포인트가 있는 pprof 레이블을 추가하여 Datadog UI에서 프로파일을 엔드포인트별로 그룹화할 수 있는지 제어해요.DD_PROFILING_EXPERIMENTAL_ASYNC_JMETHODID_OPTIM_ENABLED

Type: boolean Default: false Since: v1.64.0 Datadog 네이티브 프로파일러(ddprof): jmethodID 할당을 줄여 메모리 공간 최적화를 활성화해요. 활성화하면 ddprof가 가능할 때마다 클래스의 jmethodID 미리 로딩을 피해 메모리 사용을 줄여요.DD_PROFILING_EXPERIMENTAL_DDPROF_JMETHODID_OPTIM_ENABLED

Type: boolean Default: false true로 설정하면 Live Heap 프로파일링(Preview)을 활성화해요. 기본값은 false예요.DD_PROFILING_UPLOAD_PERIOD

Type: int Default: 60 프로파일링: 업로드 기간(초, 기록 지속시간); 프로파일이 업로드되는 빈도를 제어해요DD_PROFILING_UPLOAD_TIMEOUT

Type: int Default: 30 Since: v1.57.0 프로파일링 업로드: 프로파일 업로드를 위한 HTTP 요청 타임아웃(초)(프로파일링 업로더 HTTP 클라이언트에서 사용). 기본값: 30초.DD_PROFILING_URL

Type: string 프로파일링: 명시적 프로파일링 수집 URL. 설정하면 트레이서가 에이전트리스/에이전트 기반 프로파일링 설정과 관계없이 이 URL을 사용해요. 그렇지 않으면 에이전트리스일 때 에이전트리스 수집(https://intake.profile.<site>/api/v2/profile)을, 에이전트리스가 아닐 때는 Datadog Agent 엔드포인트(<agentUrl>/profiling/v1/input)를 대상으로 해요.

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

(41)

애플리케이션 보안 구성: ASM 위협 탐지 및 차단, 사용자 이벤트 추적, IAST 취약점 탐지, API Security 스키마 발견, 오류 추적. DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE

Type: decimal Default: 0.5 Since: v1.64.0 다운스트림 요청 본문이 샘플링될 확률을 정의해요. 다르게 말하면 요청 및 응답 본문을 샘플링/분석해야 하는 전체 요청 수를 정의해요.DD_API_SECURITY_DOWNSTREAM_REQUEST_BODY_ANALYSIS_SAMPLE_RATE

Type: decimal Default: 0.5 Since: v1.55.0 Aliases:DD_API_SECURITY_DOWNSTREAM_REQUEST_ANALYSIS_SAMPLE_RATE 다운스트림 요청 본문이 샘플링될 확률을 정의해요. 다르게 말하면 요청 및 응답 본문을 샘플링/분석해야 하는 전체 요청 수를 정의해요.DD_API_SECURITY_ENABLED

Type: boolean Default: true Aliases:DD_EXPERIMENTAL_API_SECURITY_ENABLED API Security 기능이 활성화되는지 제어해요. 설정하지 않으면 API Security는 기본적으로 활성화돼요.DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED

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

Type: int Default: 300 단일 엔드포인트 수집 텔레메트리 메시지에 포함되는 API 엔드포인트의 최대 수를 설정해요. 설정하지 않으면 기본 제한이 사용돼요.DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS

Type: int Default: 1 Since: v1.55.0 요청 및 응답 본문을 분석해야 하는 요청당 최대 다운스트림 요청 수예요.DD_APPSEC_AGENTIC_ONBOARDING

Type: string Since: v1.65.0 Datadog의 에이전틱 온보딩 솔루션이 서비스에 대해 App & API Protection을 구성할 때 자동으로 설정하는 합법적인 Datadog 환경 변수예요. 이를 통해 Datadog가 계측 텔레메트리를 통해 서비스가 에이전틱 흐름을 통해 온보딩되었음을 기록할 수 있어요.DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE

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

Type: string Since: v1.57.0 DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE가 설정되지 않은 경우 AppSec이 사용하는 자동 사용자 이벤트 추적 모드를 제어해요. safe 같은 값은 익명화에, extended는 식별에 매핑되고, 다른 값은 자동 사용자 이벤트를 비활성화해요.DD_APPSEC_BODY_PARSING_SIZE_LIMIT

Type: int Default: 10000000 Since: v1.55.0 처리할 본문의 최대 크기(바이트). 0으로 설정하면 본문이 처리되지 않아요. (권장값: 10000000 (10MB))DD_APPSEC_ENABLED

Type: string Default: inactive Since: v1.57.0 트레이서 내부의 AppSec 제품을 활성화하거나 비활성화해요. 활성화하면 트레이서가 AppSec 모듈(인앱 WAF, 헤더/본문 수집, AppSec 텔레메트리)을 초기화해요DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML

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

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

Type: string 클라이언트 IP 해석에 사용할 단일 HTTP 헤더를 지정해요. 설정하면 트레이서가 그 헤더를 클라이언트 IP의 신뢰할 수 있는 소스로 취급하고 기본 후보 헤더 집합을 무시해요. 프록시나 CDN이 커스텀 클라이언트 IP 헤더를 제공할 때 모호함과 IP 스푸핑 문제를 피하는 데 도움이 되며, 주의해서 사용하고 배포 모범 사례를 따르세요.DD_APPSEC_MAX_STACK_TRACE_DEPTH

Type: int Default: 32 Aliases:DD_APPSEC_MAX_STACKTRACE_DEPTH AppSec 이벤트에 첨부된 스택 트레이스에 대해 보존되는 최대 스택 프레임 수예요. 제한에 도달하면 더 깊은 프레임이 잘리고 스택 상단 프레임이 보존돼요. 이벤트 페이로드 크기를 줄이려면 값을 낮춰요.DD_APPSEC_MAX_STACK_TRACES

Type: int Default: 2 Aliases:DD_APPSEC_MAX_STACKTRACES 페이로드 크기를 합리적으로 유지하기 위해 AppSec/IAST 이벤트에 캡처하여 첨부하는 별도 스택트레이스 수를 제한해요. 증거 스택트레이스는 분류에 유용하지만 무제한 캡처는 민감한 데이터를 누출하고 과도한 대역폭을 소비할 수 있어요. 이 제한은 증거 가치와 안전을 균형 있게 맞춰요. 모두 수집하려면 0으로 설정해요.DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP

Type: string AppSec 난독화기가 완전한 삭제를 유발해야 하는 파라미터 키를 식별하는 데 사용하는 정규식이에요. 어떤 key_path 문자열이 이 정규식과 일치하면 전체 파라미터가 <redacted by datadog>로 대체돼요. 기본 키 정규식은 일반적인 시크릿/키 이름(password, token, authorization, jwt 등)과 일치하며, 빈 문자열은 키 정규식을 비활성화해요DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP

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

Type: boolean Default: true 트레이서의 RASP / Exploit Prevention 기능을 켜요. 활성화하면 트레이서가 동기식 사전 실행 검사를 실행하고 차단 작업 또는 익스플로잇 신호를 생성할 수 있어요. RASP는 언어별로 별도의 활성화 및 구현 세부 사항이 있을 수 있으며, 활성화하면 일반적으로 탐지를 위한 추가 동기식 계측과 추가 증거 캡처가 활성화돼요DD_APPSEC_RULES

Type: string 트레이서와 함께 제공되는 기본 AppSec 규칙을 재정의하는 JSON 규칙 파일 경로예요.DD_APPSEC_SCA_ENABLED

Type: boolean 트레이서의 런타임 소프트웨어 구성 분석(Runtime SCA) 기능을 활성화해요. 런타임 의존성/SBOM 정보를 보고하고 런타임 취약점 탐지를 지원해요. 테스트 및 데모는 물론 프로덕션 런타임 취약점 워크플로에도 유용하며, SCA는 SCA 런북에 설명된 요금/사용량 영향과 언어 호환성 제약이 있을 수 있어요DD_APPSEC_SCA_MAX_TRACKED_DEPENDENCIES

Type: int Default: 1000 Since: v1.64.0 SCA Reachability 하위 시스템이 런타임에 추적할 Maven 아티팩트 의존성의 최대 수를 설정해요. 제한에 도달하면 새 의존성이 조용히 무시되고 일회성 경고가 로깅돼요. 알려진 CVE가 있는 1000개 이상의 고유 의존성을 로드하는 경우 이 값을 늘려요.DD_APPSEC_STACK_TRACE_ENABLED

Type: boolean Default: true Aliases:DD_APPSEC_STACKTRACE_ENABLED 보안 이벤트 발생 시 보안 관련 스택 트레이스 생성을 활성화해요.DD_APPSEC_TRACE_RATE_LIMIT

Type: int Default: 100 초당 최대 AppSec 트레이스 수를 제어해요.DD_APPSEC_WAF_TIMEOUT

Type: int Default: 100000 Since: v1.57.0 WAF 동기식 실행 시간(마이크로초)을 제한해요.DD_IAST_DB_ROWS_TO_TAINT

Type: int Default: 1 IAST: 특정 ResultSet에 대해 오염 소스(SQL 테이블 데이터)로 처리할 JDBC ResultSet 행의 최대 수예요. 이 제한을 초과하는 행은 오염되지 않아요. 기본값: 1.DD_IAST_DEDUPLICATION_ENABLED

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

Type: string Default: false IAST: IAST 제품 활성화를 제어해요. true/1은 IAST를 완전히 활성화하고, inactive는 로직을 비활성 상태로 유지하면서 계측을 적용해 원격 구성을 통해 토글할 수 있게 하며, 다른 값은 IAST를 완전히 비활성화해요. 기본값: false.DD_IAST_MAX_CONCURRENT_REQUESTS

Type: int Default: 4 IAST: 분석할 수 있는 동시 요청의 최대 수(오버헤드 제어). DEFAULT 탐지 모드에서만 사용되며, FULL 탐지 모드에서는 무제한이에요. 기본값(DEFAULT 모드): 4.DD_IAST_MAX_RANGE_COUNT

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

Type: boolean Default: true 민감한 데이터의 IAST 삭제를 활성화하거나 비활성화해요. 기본값은 TracerSettings에 있어요.DD_IAST_REDACTION_NAME_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,})) IAST: 삭제해야 하는 민감한 값을 식별하는 데 사용하는 정규식(대소문자 구분 없이, 여러 줄). 기본값은 Bearer 토큰, GitHub/GitLab 토큰, JWT, 개인 키 같은 패턴과 일치해요.DD_IAST_REQUEST_SAMPLING

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

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

Type: boolean Default: true Aliases:DD_IAST_STACKTRACE_ENABLED IAST: 활성화(기본값)하면 사용자 코드 스택 트레이스를 캡처하여 IAST 취약점 보고서에 첨부해요(스택 id 통해). 취약한 코드가 실행된 위치를 찾는 데 유용해요. 사용 중단된 별칭 DD_IAST_STACKTRACE_ENABLED도 지원돼요.DD_IAST_TELEMETRY_VERBOSITY

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

Type: int Default: 250 기본값은 250이에요DD_IAST_VULNERABILITIES_PER_REQUEST

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

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

Type: string Default: ["SHA1", "SHA-1", "MD2", "RIPEMD128", "MD4", "MD5"] IAST: 약한 것으로 간주되는 해시 알고리즘 id의 쉼표 구분 집합(대문자 알고리즘 id와 비교). 사용된 해시 알고리즘이 이 집합에 있으면 IAST가 WEAK_HASH 취약점을 보고해요(예: MD5 또는 SHA1).

동적 계측 & 디버깅 (Dynamic Instrumentation & Debugging)

(19)

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

Type: string Since: v1.65.0 테스트 최적화 라이브러리가 코드 커버리지 리포트를 자동 업로드하도록 구성된 경우, 사용자는 DD_CODE_COVERAGE_FLAGS를 환경 변수로 전달해 커버리지 리포트를 그룹화/필터링용으로 표시할 수 있어요. DD_CODE_COVERAGE_FLAGS=type:unit-tests,jvm-21 같은 쉼표 구분 값을 사용해요DD_CODE_ORIGIN_FOR_SPANS_ENABLED

Type: boolean Default: false Code Origin for spans(Dynamic Instrumentation)을 활성화해요: 코드 원본 레코더를 시작하고 스팬 진입 시 코드 원본을 캡처하는 계측(DebuggerContext.captureCodeOrigin 통해)을 활성화해 스팬에 코드 원본 스냅샷/태그를 생성해요. 기본값: false.DD_CODE_ORIGIN_MAX_USER_FRAMES

Type: int Default: 8 Code Origin for spans(Dynamic Instrumentation): 코드 원본 기록 시 캡처/고려할 최대 사용자 스택 프레임 수를 설정해요(기본값: 8). 참고: 현재 코드 원본 레코더는 이 값을 읽지만 사용하지 않아 이 버전에서는 효과가 없을 수 있어요.DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT_MS

Type: int Default: 100 Since: v1.64.0 Aliases:DD_DYNAMIC_INSTRUMENTATION_CAPTURE_TIMEOUT 스냅샷 수집 중 변수 값을 캡처하기 위한 타임아웃(밀리초).DD_DYNAMIC_INSTRUMENTATION_DIAGNOSTICS_INTERVAL

Type: int Default: 3600 프로브 진단/상태 메시지(수신/설치/발신/오류)가 다시 발신될 수 있는 간격(초)DD_DYNAMIC_INSTRUMENTATION_ENABLED

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

Type: int Default: 50 Since: v1.64.0 식 평가(로그 조건, 로그 템플릿 값, 스팬 태그 값 또는 캡처 식) 시 사용되는 타임아웃(밀리초)DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE

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

Type: string Since: v1.57.0 캡처된 스냅샷 데이터에서 삭제할 추가 식별자 키워드의 쉼표 구분 목록DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES

Type: string Since: v1.57.0 동적 로그 및 스냅샷에서 삭제할 객체 유형의 쉼표 구분 목록. * 와일드카드 지원(예: Secret*는 SecretKey와 일치).DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS

Type: string 기본 삭제 목록에서 제외할 식별자 키워드의 쉼표 구분 목록. password 같은 일반적인 키워드를 사용 사례에 맞게 민감한 것으로 취급하지 않도록 하는 데 유용해요.DD_DYNAMIC_INSTRUMENTATION_UPLOAD_BATCH_SIZE

Type: int Default: 100 업로드 배치 크기(요청당 스냅샷/진단 메시지 수). 플러시마다 직렬화되어 전송되는 스냅샷 수를 제어해요. 기본값: 100.DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL

Type: int Default: 0 저빈도 업로드 플러시 간격(밀리초). 0(기본값)은 적응형 플러시 간격을 활성화하고, 다른 값은 고정 간격을 사용해요. DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS를 위해 사용 중단됨.DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS

Type: string 프로브 데이터 업로드 사이의 간격(초).DD_EXCEPTION_REPLAY_CAPTURE_INTERVAL_SECONDS

Type: int Default: 3600 Exception Replay: 동일한 예외 지문을 다시 캡처하는 사이의 최소 간격(초). 동일한 예외의 반복 캡처를 레이트 제한하는 데 사용돼요. 기본값: 3600초.DD_EXCEPTION_REPLAY_CAPTURE_MAX_FRAMES

Type: int Default: 0 Exception Replay(레거시): DD_EXCEPTION_REPLAY_MAX_FRAMES_TO_CAPTURE의 사용 중단된 별칭. 예외당 계측/캡처할 최대 스택 프레임 수(네이티브, 제외, 줄 번호 없는 것 제외)를 설정해요. 기본값: 3.DD_EXCEPTION_REPLAY_ENABLED

Type: boolean Default: false Exception Replay(Live Debugging): Exception Replay 제품을 활성화해요. 활성화(예: Remote Config 통해)하면 트레이서가 Exception Replay 하위 시스템을 시작/중지해요. 이 키는 DD_EXCEPTION_DEBUGGING_ENABLED의 하위 호환 가능한 별칭으로도 받아들여져요.DD_EXCEPTION_REPLAY_MAX_EXCEPTION_ANALYSIS_LIMIT

Type: int Default: 100 Exception Replay: 초당 분석/처리할 최대 예외 수(회로 차단기). 제한을 초과하면 해당 초 동안 추가 예외가 무시돼요. 기본값: 100.DD_SYMBOL_DATABASE_UPLOAD_ENABLED

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

CI Visibility

(38)

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

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

Type: boolean Default: false CI Visibility의 에이전트리스 모드를 활성화해요. 로컬 Agent를 통하지 않고 테스트 데이터를 Datadog 수집으로 직접 전송해요.DD_CIVISIBILITY_AGENTLESS_URL

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

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

Type: boolean Default: true CI Visibility 테스트별 코드 커버리지 수집/보고를 활성화해요. 활성화하면 트레이서가 커버리지 데이터를 제출하기 위해 추가 수집 트랙(CITESTCOV)을 구성하고, 비활성화하면 코드 커버리지 데이터가 전송되지 않아요.DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED

Type: boolean Default: true CI Visibility Early Flake Detection(EFD)을 활성화해요. 백엔드에서 제공한 실행 설정에 따라 선택된 테스트를 여러 번 조기에 실행하여 플레이크를 탐지할 수 있어요.DD_CIVISIBILITY_ENABLED

Type: boolean Default: false 테스트 실행에 대한 CI Visibility 계측을 활성화해요. 테스트 세션, 모듈, 스위트, 개별 테스트 결과를 Datadog에 보고해요.DD_CIVISIBILITY_FLAKY_RETRY_COUNT

Type: int Default: 5 테스트 케이스당 최대 재시도 횟수를 변경하려면 음수가 아닌 숫자로 설정할 수 있어요.DD_CIVISIBILITY_FLAKY_RETRY_ENABLED

Type: boolean Default: true CI Visibility 자동 테스트 재시도 기능의 킬 스위치예요. false면 원격 설정이 재시도를 활성화하더라도 실패한 테스트가 자동으로 다시 실행되지 않아요.DD_CIVISIBILITY_GIT_UNSHALLOW_ENABLED

Type: boolean Default: true git 메타데이터를 검색할 때 git unshallow 프로세스를 활성화/비활성화하는 옵션을 사용자에게 제공해요.DD_CIVISIBILITY_GIT_UPLOAD_ENABLED

Type: boolean Default: true DD_CIVISIBILITY_GIT_UPLOAD_ENABLED가 false로 설정되면 git 업로드를 비활성화해요DD_CIVISIBILITY_GRADLE_DEPENDENCY_VERIFICATION_ENABLED

Type: boolean Default: false Since: v1.65.0 Gradle 의존성 검증이 Datadog Test Optimization이 주입한 의존성에 적용되는지 제어해요. 기본적으로 비활성화돼요. 활성화하기 전에 주입된 Datadog 컴파일러 플러그인과 JaCoCo 의존성을 gradle/verification-metadata.xml에 추가하세요. 그렇지 않으면 Gradle이 이러한 의존성을 해석할 때 빌드를 실패시킬 수 있어요.DD_CIVISIBILITY_IMPACTED_TESTS_DETECTION_ENABLED

Type: boolean Default: true CI Visibility 영향 받은 테스트 탐지(TIA)를 활성화해요. 활성화하면 영향 받은 테스트 탐지가 하위 프로세스로 전파되는 실행 설정의 일부로 요청/적용돼요.DD_CIVISIBILITY_ITR_ENABLED

Type: boolean Default: true CI Visibility의 Intelligent Test Runner를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS

Type: int Default: 500 CI Visibility(Selenium): 브라우저 테스트 끝에서 window.DD_RUM.stopSession()을 호출한 후 RUM 데이터가 플러시되도록 진행하기 전에 이 밀리초만큼 기다려요(기본값: 500ms).DD_CIVISIBILITY_TEST_COMMAND

Type: string CI Visibility: 하위 테스트 JVM으로 전파되는 테스트 명령 문자열(예: mvn test 또는 gradle test)을 설정해요. 명시적 세션 이름이 설정되지 않았을 때 CI Visibility 테스트 세션 이름을 만드는 데 사용돼요.DD_CIVISIBILITY_TOTAL_FLAKY_RETRY_COUNT

Type: int Default: 1000 자동 플래키 테스트 재시도가 활성화될 때 전체 CI 테스트 세션에 걸쳐 허용되는 자동 테스트 재시도의 최대 총 수예요.DD_CUSTOM_TRACE_ID

Type: string Jenkins Datadog Plugin이 전파하는 커스텀 트레이스 ID로, Jenkins 파이프라인 실행과 테스트 중인 애플리케이션이 내보낸 트레이스를 연관 짓는 데 사용돼요.DD_GIT_BRANCH

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

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

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

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

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

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

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

Type: string CI Visibility: 현재 빌드/풀 리퀘스트의 git 헤드 커밋 SHA를 설정해 사용자가 제공한 git 메타데이터가 필요할 때 풀 리퀘스트 정보와 CI git 태그(예: git.commit.head.sha)를 채우는 데 사용해요.DD_GIT_COMMIT_MESSAGE

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

Type: string CI 메타데이터로 보고되고 활성화 시 git 메타데이터 태깅에 사용되는 git 커밋 SHA를 재정의해요.DD_GIT_PULL_REQUEST_BASE_BRANCH

Type: string CI Visibility: 풀 리퀘스트 베이스/대상 브랜치 이름을 설정해 사용자가 제공한 git 메타데이터가 필요할 때 풀 리퀘스트 정보와 CI git 태그(예: git.pull_request.base_branch)를 채우는 데 사용해요.DD_GIT_PULL_REQUEST_BASE_BRANCH_SHA

Type: string CI 기능용 git 메타데이터로 보고되는 풀 리퀘스트 베이스 커밋 SHA를 재정의해요. 자동으로 감지할 수 없을 때 베이스 커밋을 설정하는 데 사용해요.DD_GIT_REPOSITORY_URL

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

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

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

Type: boolean Default: true Since: v1.55.0 CI Visibility: Failed Test Replay 기능(킬 스위치)을 활성화해요. 실행 설정에서 활성화하면 트레이서가 테스트 실행 중 예외 리플레이 디버깅을 활성화해 실패한 테스트 리플레이 데이터를 캡처해요. 기본값: true(활성화하려면 여전히 백엔드/원격 설정 필요).DD_TEST_MANAGEMENT_ATTEMPT_TO_FIX_RETRIES

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

Type: boolean Default: true CI Visibility Test Management 기능(비활성화, 격리, attempt-to-fix 테스트)의 로컬 킬 스위치예요. 원격 설정이 활성화하더라도 Test Management를 비활성화하려면 false로 설정해요.DD_TEST_SESSION_NAME

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

Type: boolean Default: true 활성화하면 트레이서가 루트 스팬에 git 저장소 URL과 커밋 SHA 태그를 첨부해 트레이스를 Datadog UI의 해당 소스 코드에 연결할 수 있게 해요.

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

(1)

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

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

로그 제출 & 연관 (Log Submission & Correlation)

(4)

Datadog로의 직접 로그 제출, 에이전트리스 로그 전달, 트레이스-로그 연관용 로그 주입, OpenTelemetry 로그 내보내기. DD_AGENTLESS_LOG_SUBMISSION_ENABLED

Type: boolean Default: false Datadog Agent를 통해 로그를 라우팅하지 않고 Datadog로 직접 로그 제출을 활성화해요.DD_AGENTLESS_LOG_SUBMISSION_URL

Type: string 에이전트리스 로그 제출이 활성화되었을 때 사용되는 수집 URL을 재정의해요.DD_LOGS_INJECTION

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

언어별 참고사항:

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

Type: boolean Default: false Since: v1.62.0 OpenTelemetry Logs API를 통해 생성된 로그의 수집 및 내보내기를 활성화해요.

런타임 메트릭 (Runtime Metrics)

(7)

런타임 메트릭 수집과 메트릭 제출용 DogStatsD 연결 구성. DD_DOGSTATSD_ARGS

Type: string Azure App Services: 트레이서가 외부 DogStatsD 프로세스를 시작할 때 추가되는 추가 명령줄 인수(DD_DOGSTATSD_PATH가 설정된 경우에만 사용).DD_DOGSTATSD_HOST

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

Type: string Azure App Services: 외부 프로세스로 실행할 DogStatsD 실행 파일 경로예요. 설정하면 트레이서가 dogstatsd 프로세스를 시작·감독하고(DD_DOGSTATSD_ARGS 전달), 선택적으로 DD_DOGSTATSD_PIPE_NAME으로 상태를 확인해요.DD_DOGSTATSD_PIPE_NAME

Type: string DogStatsD가 바인딩하는 네임드 파이프예요. 기본값은 null이에요.DD_DOGSTATSD_PORT

Type: int Default: 8125 메트릭이 제출되는 DogStatsD Agent의 포트예요. Agent 구성이 dogstatsd_port 또는 DD_DOGSTATSD_PORT를 기본 8125가 아닌 값으로 설정하면 이 추적 라이브러리 DD_DOGSTATSD_PORT가 일치해야 해요.DD_RUNTIME_METRICS_ENABLED

Type: boolean Default: true Configuration: runtimeMetrics 런타임 메트릭 캡처를 활성화할지 여부. UDP용 포트 8125(또는 DD_DOGSTATSD_PORT로 구성)가 Agent에서 열려 있어야 해요.DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED

Type: boolean Default: true 설명: 향상된 런타임 메트릭을 활성화해 모든 메트릭과 함께 runtime_id 태그를 제공해요. runtime_id는 애플리케이션의 프로세스 식별자를 나타내며 런타임 메트릭을 개별 실행 중인 애플리케이션과 직접 연관 지을 수 있게 해요.

Data Streams Monitoring

(2)

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

Type: boolean Default: false Data Streams Monitoring(DSM)과 그 체크포인트 전파를 활성화해요. 활성화하면 트레이서가 DSM 전파자를 등록하고 경로 통계와 페이로드를 보고해요.DD_DATA_STREAMS_TRANSACTION_EXTRACTORS

Type: string Since: v1.62.0 트랜잭션 추적을 위한 Data Streams 추출기를 구성할 수 있게 해요

계측 텔레메트리 (Instrumentation Telemetry)

(4)

트레이서 자가 보고 텔레메트리: 하트비트 간격, 의존성·로그 수집, 텔레메트리 포워더 구성. DD_INSTRUMENTATION_TELEMETRY_ENABLED

Type: boolean Default: true Datadog가 제품 개선을 위해 애플리케이션과 런타임에 대한 환경·진단 정보를 수집할 수 있게 해요. 계측 텔레메트리를 옵트아웃하려면 false로 설정해요.DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED

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

Type: boolean Default: true 내부 트레이서 로그가 계측 텔레메트리의 일부로 전달되는지 제어해요.DD_TELEMETRY_METRICS_ENABLED

Type: boolean Default: true 계측 텔레메트리가 내부 메트릭을 전송하는지 제어해요.

원격 구성 (Remote Configuration)

(2)

Datadog에서 라이브 구성 업데이트를 받기 위한 Remote Configuration. DD_REMOTE_CONFIG_ENABLED

Type: boolean Default: true 트레이서의 Remote Config 폴링을 활성화해요(원격 구성 엔드포인트에서 구성 업데이트를 가져와 구독된 제품에 적용). 기본값: true.DD_REMOTE_CONFIGURATION_ENABLED

Type: boolean Default: true Aliases:DD_REMOTE_CONFIG_ENABLED 원격 구성을 활성화하거나 비활성화해요.

OpenTelemetry 호환성 (OpenTelemetry Compatibility)

(31)

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

Type: boolean Default: false Since: v1.56.0 OpenTelemetry 메트릭 내보내기를 활성화해요. 메트릭은 기본적으로 비활성화되어 있으며, 이 값이 참(truthy) 값으로 설정된 경우에만 활성화돼요.DD_TRACE_OTEL_ENABLED

Type: boolean Default: false Datadog SDK의 트레이스용 OpenTelemetry 상호운용을 활성화해요.OTEL_EXPORTER_OTLP_ENDPOINT

Type: string Since: v1.56.0 재정의되지 않는 한 모든 신호에 대한 OTLP 데이터 전송 기본 URL을 지정해요. 기본값(gRPC): http://localhost:4317. 기본값(HTTP): http://localhost:4318.OTEL_EXPORTER_OTLP_HEADERS

Type: map Since: v1.56.0 설명: 모든 나가는 OTLP 요청의 헤더로 사용할 키-값 쌍의 쉼표 구분 목록을 지정해요(예: api-key=key,other-config=value).OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

Type: string Since: v1.62.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: string Since: v1.62.0 Aliases:OTEL_EXPORTER_OTLP_HEADERS 나가는 OTLP 로그 요청의 헤더로 사용할 키-값 쌍의 쉼표 구분 목록을 지정해요. 일반 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

Type: string Default: SDK-dependent, but will typically be either http/protobuf or grpc. Since: v1.62.0 로그용 OTLP 전송 프로토콜을 지정해요. OTEL_EXPORTER_OTLP_PROTOCOL보다 우선해요. 허용 값: grpc, http/protobuf, http/json``OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

Type: int Default: 10000 Since: v1.62.0 Aliases:OTEL_EXPORTER_OTLP_TIMEOUT 단일 나가는 OTLP 로그 요청의 타임아웃(밀리초)을 지정해요. 일반 OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

Type: string Since: v1.56.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: string Since: v1.56.0 Aliases:OTEL_EXPORTER_OTLP_HEADERS 메트릭용 OTLP exporter 요청에 포함할 추가 헤더를 설정해요. 설정하면 메트릭 내보내기에서 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

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

Type: string Since: v1.56.0 설명: 각 계측 종류에 사용할 집계 temporality를 지정해요. 참고: 이 기본값 delta는 Datadog의 권장 구성이며 OpenTelemetry 사양의 기본값과 다르다는 점에 유의하세요.OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

Type: int Default: 10000 Since: v1.56.0 Aliases:OTEL_EXPORTER_OTLP_TIMEOUT 단일 나가는 OTLP 메트릭 요청의 타임아웃(밀리초). OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.OTEL_EXPORTER_OTLP_PROTOCOL

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

Type: int Default: 10000 Since: v1.56.0 OTLP 내보내기 요청의 기본 타임아웃(밀리초). 신호별 타임아웃이 설정되지 않았을 때 폴백으로 사용돼요.OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

Type: string Since: v1.61.0 Aliases: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

Type: string Since: v1.61.0 OTLP 메트릭 내보내기용 커스텀 헤더를 설정하는 구성 키예요. 일반 OTLP 헤더보다 우선해요. 형식: api-key=key,other=value.OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

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

Type: int Default: 10000 Since: v1.61.0 메트릭 내보내기용 OTLP 요청 타임아웃(밀리초)을 설정하는 구성 키예요. 일반 OTLP 타임아웃 설정보다 우선해요.OTEL_LOG_LEVEL

Type: string Since: v1.57.0 로그 레벨을 설정하는 구성 키예요.OTEL_LOGS_EXPORTER

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

Type: int Default: 10000 Since: v1.56.0 메트릭 내보내기 시도 사이의 간격(밀리초). 기본 10000(10초)은 Datadog의 권장 값이며 OpenTelemetry 사양 기본값 60000ms와 다르다는 점에 유의하세요.OTEL_METRIC_EXPORT_TIMEOUT

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

Type: string 설명: 사용할 메트릭 exporter를 지정해요. 참고: 허용 값은 otlp와 none뿐이에요. none은 OTel 메트릭 발신과 APM 런타임 메트릭을 모두 비활성화해요(DD_RUNTIME_METRICS_ENABLED=false와 동일)OTEL_PROPAGATORS

Type: string Since: v1.57.0 추출과 주입 모두에 대한 트레이스 컨텍스트 전파 형식을 지정해요(쉼표 구분 목록). 우선순위가 가장 낮으며, 다른 Datadog 트레이스 컨텍스트 전파 환경 변수가 설정되면 무시돼요.OTEL_RESOURCE_ATTRIBUTES

Type: string Since: v1.57.0 해당 트레이서 태그 설정이 설정되지 않았을 때 트레이서 태그로 매핑되는 OpenTelemetry 리소스 속성을 설정해요. service, environment, version용 예약 속성은 표준 태그로 매핑되며 처음 10개의 속성만 적용돼요. 퍼센트 인코딩된 쉼표와 등호 구분자는 그대로 유지돼요.OTEL_SDK_DISABLED

Type: 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는 import 및 구성 시 자동으로 활성화되므로 이 설정은 적용되지 않아요.OTEL_SERVICE_NAME

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

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

Type: string Since: v1.57.0 OpenTelemetry 구성을 통해 트레이스 샘플러를 설정하고 해당 설정이 없는 경우 트레이서의 샘플 레이트에 매핑해요. Parent 기반 샘플러가 지원되며, 지원되지 않는 값은 무시돼요.OTEL_TRACES_SAMPLER_ARG

Type: string Since: v1.57.0 OpenTelemetry 트레이스 샘플러 인수(otel.traces.sampler.arg / OTEL_TRACES_SAMPLER_ARG): OTEL_TRACES_SAMPLER=parentbased_traceidratio일 때 사용되며, 값이 traceidratio 샘플 레이트로 처리되어 Datadog 트레이스 샘플 레이트에 매핑돼요. 기본값: 설정 안 됨.

AI & LLM Observability

(9)

AI 관측성 기능: AI Guard 콘텐츠 스캐닝, LLM Observability, 공급자별 통합 설정. DD_AI_GUARD_ENABLED

Type: boolean Default: false Since: v1.55.0 트레이서에서 AI Guard 요청 검사를 활성화해요. 비활성화하면 AI Guard 검사가 건너뛰어져요.DD_AI_GUARD_ENDPOINT

Type: string Since: v1.55.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: v1.55.0 메타 구조에 설정된 content 속성의 최대 크기DD_AI_GUARD_MAX_MESSAGES_LENGTH

Type: int Default: 16 Since: v1.55.0 메타 구조에 설정할 수 있는 대화 메시지의 최대 수DD_AI_GUARD_TIMEOUT

Type: int Default: 10000 Since: v1.55.0 AI Guard REST API 호출에 사용되는 타임아웃(밀리초)(기본 5000)DD_LLMOBS_AGENTLESS_ENABLED

Type: boolean Default: false 선택 사항 - 정수 또는 문자열 - 기본값: false Datadog Agent를 사용하지 않는 경우에만 필요하며, 이 경우 1 또는 true로 설정해야 해요.DD_LLMOBS_ENABLED

Type: boolean Default: false LLM Observability에 데이터 제출을 활성화하는 토글DD_LLMOBS_ML_APP

Type: string LLM Observability 데이터에 사용되는 기본 ML 앱 이름을 설정해요. 이 값은 LLM Observability가 활성화된 경우 필요해요.DD_LLMOBS_SAMPLE_RATE

Type: decimal Default: 1.0 Since: v1.66.0 기본 제공 LLM 통합(OpenAI, Anthropic, Bedrock 등)이 내보내는 LLM Observability 페이로드에 적용되는 샘플 레이트를 제어해요. 0.0(모두 버림)과 1.0(모두 전송) 사이의 float를 받아요. 설정하지 않으면 모든 적격 LLM 스팬이 샘플링돼요.

계측 & 플랫폼 (Instrumentation & Platform)

(4)

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

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

Type: string 텔레메트리 메타데이터: 계측 구성 ID. 설정하면 이 트레이서 설정을 생성한 구성/주입과 연관시킬 수 있도록 instrumentation_config_id라는 구성 항목으로 트레이서 텔레메트리에 전파돼요.DD_THIRD_PARTY_DETECTION_EXCLUDES

Type: array Default: [] Since: v1.56.0 DD_THIRD_PARTY_EXCLUDES의 별칭. Live Debugging / Exception Replay: 퍼스트 파티로 취급할(타사 라이브러리 필터에서 제외할) 패키지 접두사. 이 허용 목록은 기본 타사 라이브러리 목록을 재정의해요.DD_THIRD_PARTY_DETECTION_INCLUDES

Type: array Default: [] Since: v1.56.0 타사 탐지에 포함할 라이브러리의 쉼표 구분 목록. 기본값은 비어 있어요.

기타 (Miscellaneous)

(2)

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

Type: boolean Default: false Since: v1.56.0 원격 구성에서 플래그를 평가하는 실험적 피처 플래그 프로바이더를 활성화해요. 활성화하지 않으면 프로바이더는 no-op이며 기본값을 반환해요.DD_EXPERIMENTAL_FLAGGING_PROVIDER_SPAN_ENRICHMENT_ENABLED

Type: boolean Default: false Since: v1.65.0 피처 플래그 데이터로 스팬 강화를 활성화할지 여부. 활성화하고 피처 플래그가 평가되면 피처 플래그 평가와 트레이스 간 상관 관계를 위해 관련 메타데이터가 루트 APM 스팬에 첨부돼요.

참고:

두 방식으로 같은 키 유형을 설정하면 시스템 속성 구성이 우선해요.
시스템 속성은 JVM 파라미터로 사용할 수 있어요.
기본적으로 애플리케이션의 JMX 메트릭은 포트 8125의 DogStatsD를 통해 Datadog Agent로 전송돼요. Agent에 DogStatsD가 활성화되어 있는지 확인하세요.
- Agent를 컨테이너로 실행하는 경우 DD_DOGSTATSD_NON_LOCAL_TRAFFIC가 true로 설정되어 있고 Agent 컨테이너에서 포트 8125가 열려 있는지 확인하세요.
- Kubernetes에서는 DogStatsD 포트를 호스트 포트에 바인딩하고, ECS에서는 작업 정의에 적절한 플래그를 설정하세요.

예시 (Examples)

`dd.service.mapping`

시스템 속성을 사용한 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.service.mapping=postgresql:web-app-pg -jar path/to/application.jar

`dd.tags`

스팬과 JMX 메트릭에 대한 전역 env 설정:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -jar path/to/application.jar

`dd.trace.span.tags`

모든 스팬에 project:test 추가 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -jar path/to/application.jar

`dd.trace.jmx.tags`

JMX 메트릭에 custom.type:2 설정:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.span.tags=project:test -Ddd.trace.jmx.tags=custom.type:2 -jar path/to/application.jar

`dd.trace.methods`

시스템 속성을 사용한 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.trace.methods="hello.GreetingController[doSomeStuff,doSomeOtherStuff];hello.Randomizer[randomize]" -jar path/to/application.jar

`dd.trace.db.client.split-by-instance`

시스템 속성을 사용한 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.env=dev -Ddd.service=web-app -Ddd.trace.db.client.split-by-instance=TRUE -jar path/to/application.jar

DB 인스턴스 1, webappdb는 이제 db.instance 스팬 메타데이터와 동일한 서비스 이름을 갖게 돼요:

DB 인스턴스 2, secondwebappdb는 이제 db.instance 스팬 메타데이터와 동일한 서비스 이름을 갖게 돼요:

마찬가지로 서비스 맵에서도 하나의 웹 앱이 두 개의 서로 다른 Postgres 데이터베이스에 호출하는 것을 볼 수 있어요.

`dd.http.server.tag.query-string`

시스템 속성을 사용한 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.service=web-app -Ddd.env=dev -Ddd.http.server.tag.query-string=TRUE -jar path/to/application.jar

`dd.trace.enabled`

시스템 속성과 디버그 앱 모드를 사용한 예시:

java -javaagent:/path/to/dd-java-agent.jar -Ddd.trace.enabled=false -Ddd.trace.debug=true -jar path/to/application.jar

디버그 앱 로그는 Tracing is disabled, not installing instrumentations.를 보여줘요.

`dd.jmxfetch.config.dir` 및 `dd.jmxfetch.config`

구성 예시:

DD_JMXFETCH_CONFIG_DIR=<DIRECTORY_PATH> + DD_JMXFETCH_CONFIG=conf.yaml 조합
또는 직접: DD_JMXFETCH_CONFIG=<DIRECTORY_PATH>/conf.yaml

conf.yaml의 내용이 다음과 같을 때:

init_config:
instances:
    - jvm_direct: true
      port: '<PORT>'
      conf:
          - include:
                bean:
                    - java.lang:type=MemoryPool,name=Metaspace
                attribute:
                    Usage.used:
                        metric_type: gauge
                        alias: sb.usage.used

다음과 같은 결과가 생성돼요:

JMX fetch로 Java 메트릭 수집에 대해 자세히 알아보려면 Java 통합 문서를 참고하세요.

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 기사:

Java SDK 구성 (Configuring the Java SDK)

본문

시스템 속성과 환경 변수 변환하기

구성 키 (Configuration keys)

일반 설정 (General Settings)

트레이싱 코어 (Tracing Core)

트레이스 샘플링 (Trace Sampling)

트레이스 전파 (Trace Propagation)

트레이스 통합 (Trace Integrations)

일반 통합 설정 (General Integration Settings)

구성 종류 (Configuration Kinds)

DD_TRACE_<INTEGRATION>_ENABLED

DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED

DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE

DD_TRACE_<INTEGRATION>_PROPAGATION_ENABLED

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

AEROSPIKE

AGENT_V0_5

AKKA_ACTOR

Database Monitoring

트레이스 로깅 (Trace Logging)

사용 중단된 키 (Retired keys)

연속 프로파일링 (Continuous Profiling)

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

동적 계측 & 디버깅 (Dynamic Instrumentation & Debugging)

CI Visibility

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

로그 제출 & 연관 (Log Submission & Correlation)

런타임 메트릭 (Runtime Metrics)

Data Streams Monitoring

계측 텔레메트리 (Instrumentation Telemetry)

원격 구성 (Remote Configuration)

OpenTelemetry 호환성 (OpenTelemetry Compatibility)

AI & LLM Observability

계측 & 플랫폼 (Instrumentation & Platform)

기타 (Miscellaneous)

예시 (Examples)

dd.service.mapping

dd.tags

dd.trace.span.tags

dd.trace.jmx.tags

dd.trace.methods

dd.trace.db.client.split-by-instance

dd.http.server.tag.query-string

dd.trace.enabled

dd.jmxfetch.config.dir 및 dd.jmxfetch.config

더 알아보기 (Learn more)

`DD_TRACE_<INTEGRATION>_ENABLED`

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`

`DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE`

`DD_TRACE_<INTEGRATION>_PROPAGATION_ENABLED`

`dd.service.mapping`

`dd.tags`

`dd.trace.span.tags`

`dd.trace.jmx.tags`

`dd.trace.methods`

`dd.trace.db.client.split-by-instance`

`dd.http.server.tag.query-string`

`dd.trace.enabled`

`dd.jmxfetch.config.dir` 및 `dd.jmxfetch.config`