Go SDK 구성 (Configuring the Go SDK)

원문 보기 위키 갱신 2026.10.05

코드로 SDK를 설정하고, Agent가 APM 데이터를 수집하도록 구성하고, Go 통합을 활성화한 뒤, SDK를 시작하고 라이브러리를 원하는 대로 구성할 수 있어요. 참고: 이 문서는 Datadog이 모든 사용자에게 권장하는 Go 트레이서 v2를 기준으로 해요. v1을 사용 중이라면 v2로 업그레이드하려면 마이그레이션 가이드를 참고하세요.

출처: 문서

본문

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

서비스의 env, service, version을 설정하려면 DD_ENV, DD_SERVICE, DD_VERSION 사용을 권장해요.

이 환경 변수를 구성하는 방법에 대한 권장 사항은 Unified Service Tagging 문서를 읽어보세요. 이 변수들은 Go 트레이서 버전 1.24.0+에서 사용할 수 있어요.

env, service, version을 SDK의 API를 통해 제공할 수도 있어요:

package main

import (
    "github.com/DataDog/dd-trace-go/v2/ddtrace/tracer"
)

func main() {
    tracer.Start(
        tracer.WithEnv("prod"),
        tracer.WithService("test-go"),
        tracer.WithServiceVersion("abc123"),
    )

    // When the tracer is stopped, it will flush everything it has to the Datadog Agent before quitting.
    // Make sure this line stays in your main function.
    defer tracer.Stop()

    // If you expect your application to be shut down by SIGTERM (for example, a container in Kubernetes),
    // you might want to listen for that signal and explicitly stop the SDK to ensure no data is lost
    sigChan := make(chan os.Signal, 1)
    signal.Notify(sigChan, syscall.SIGTERM)
    go func() {
        <-sigChan
        tracer.Stop()
    }()
}

Go 트레이서는 구성용 추가 환경 변수와 함수를 지원해요. 모든 옵션은 구성 문서(또는 구성 문서 v1)에서 확인하세요.

APM 환경 이름 구성 (Configure APM environment name)

APM 환경 이름은 Agent에서, 또는 SDK의 WithEnv 시작 옵션으로 구성할 수 있어요.

구성 키 (Configuration keys)

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

일반 설정 (General Settings)

(11)

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

DD_AGENT_HOST

타입: string 기본값: localhost 별칭:DD_TRACE_AGENT_HOSTNAME 트레이스를 위해 Datadog Agent에 연결할 때 사용하는 호스트 이름이에요. 호스트 이름은 IPv4, IPv6, 또는 도메인 이름일 수 있어요. DD_TRACE_AGENT_URL이 지정되면 DD_AGENT_HOST 값은 무시돼요.

DD_API_KEY

타입: string 시작 버전: v2.6.0 별칭:DD-API-KEY 에이전트리스 방식(로컬 Agent를 거치지 않고 데이터를 직접 전송)으로 실행할 때 나가는 요청을 인증하는 데 사용하는 API 키를 설정해요. 이 키는 에이전트리스 CI 테스트 보고와 LLM Observability 에이전트리스 방식에 필요해요.

DD_APM_TRACING_ENABLED

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

DD_ENV

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

DD_EXTERNAL_ENV

타입: string 내보낸 텔레메트리에 부착되어 출처와 환경 귀속(attribution)에 사용되는 외부 환경 식별자를 설정해요.

DD_HOSTNAME

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

DD_SERVICE

타입: string 시작 버전: v2.6.0 텔레메트리와 생성된 스팬에 사용되는 서비스 이름을 설정해요. 설정하지 않으면 서비스 이름은 기본적으로 프로세스 이름이 돼요.

DD_SERVICE_MAPPING

타입: map 시작 버전: v2.6.0 트레이스에서 서비스 이름을 바꿀 수 있도록 서비스 이름 매핑을 정의해요. 예: postgres:postgresql,defaultdb:postgresql. 버전 0.47+에서 사용 가능해요.

DD_SITE

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

DD_TAGS

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

DD_VERSION

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

언어별 참고:

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

트레이싱 코어 (Tracing Core)

(26)

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

DD_TRACE__ANALYTICS_ENABLED

타입: boolean 기본값: false 기본(접두사 없는) 애널리틱스 토글을 사용하는 통합에 대해 애널리틱스 샘플 비율을 1.0으로 설정해 트레이스 애널리틱스를 활성화해요.

DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED

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

DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED

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

DD_TRACE_ABANDONED_SPAN_TIMEOUT

타입: string 기본값: 10m 디버깅을 위해 완료되지 않은 스팬이 버려진 것으로 간주되는 기간을 설정해요. 기본값은 10분이에요.

DD_TRACE_AGENT_PORT

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

DD_TRACE_AGENT_PROTOCOL_VERSION

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

DD_TRACE_AGENT_URL

타입: string 기본값: http://localhost:8126 시작 버전: v2.6.0 트레이서를 Datadog Agent에 연결하는 URL이에요. 유효한 URL 스킴은 http://와 unix://(UNIX 도메인 소켓)이에요. 설정하면 이 값이 DD_AGENT_HOST와 DD_TRACE_AGENT_PORT보다 우선해요.

DD_TRACE_ANALYTICS_ENABLED

타입: boolean 기본값: false 시작 버전: v2.6.0 각 통합의 구성된 애널리틱스 샘플 비율을 사용해 스팬에 analytics.sample_rate 메트릭을 설정함으로써 모든 통합에 대해 레거시 Trace Analytics 기능을 활성화해요. 새 Datadog 배포에서는 App Analytics로 대체돼요.

DD_TRACE_CLIENT_IP_ENABLED

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

DD_TRACE_CLIENT_IP_HEADER

타입: 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_ENABLED

타입: boolean 기본값: true 별칭:DD_TRACING_ENABLED 프레임워크 및 라이브러리 계측을 활성화해요. false로 설정하면 애플리케이션 코드가 트레이스를 생성하지 않아요. DD_APM_TRACING_ENABLED도 참고하세요.

DD_TRACE_FEATURES

타입: array 트레이서 기능 플래그의 쉼표 또는 공백 구분 목록이에요. "discovery" 같은 선택적 또는 실험적 동작을 활성화하는 데 사용해요.

DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP

타입: string 기본값: (?i)(?:p(?:ass)?w(?:or)?d|pass(?:_?phrase)?|secret|(?:api_?|private_?|public_?|access_?|secret_?)key(?:_?id)?|token|consumer_?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?)(?:(?:\\s|%20)*(?:=|%3D)[^&]+|(?:\"|%22)(?:\\s|%20)*(?::|%3A)(?:\\s|%20)*(?:\"|%22)(?:%2[^2]|%[^2]|[^\"%])+(?:\"|%22))|bearer(?:\\s|%20)+[a-z0-9\\._\\-]|token(?::|%3A)[a-z0-9]{13}|gh[opsu]_[0-9a-zA-Z]{36}|ey[I-L](?:[\\w=-]|%3D)+\\.ey[I-L](?:[\\w=-]|%3D)+(?:\\.(?:[\\w.+\\/=-]|%3D|%2F|%2B)+)?|[\\-]{5}BEGIN(?:[a-z\\s]|%20)+PRIVATE(?:\\s|%20)KEY[\\-]{5}[^\\-]+[\\-]{5}END(?:[a-z\\s]|%20)+PRIVATE(?:\\s|%20)KEY|ssh-rsa(?:\\s|%20)*(?:[a-z0-9\\/\\.+]|%2F|%5C|%2B){100,} 시작 버전: v2.6.0 들어오는 HTTP 요청의 쿼리 문자열에서 민감한 데이터를 편집하기 위해 정규식을 적용해요. 기본 정규식은 비밀번호, 토큰, API 키, 개인 키, 인증 용어 등 다양한 민감 데이터 패턴을 매칭해요. 매칭된 항목은 <redacted>로 대체돼요. 빈 문자열이 전달되면 난독화가 발생하지 않아요. 결과 값은 http.url 태그에 보고돼요.

DD_TRACE_PARTIAL_FLUSH_ENABLED

타입: boolean 기본값: false 큰 트레이스를 Agent에 증분 플러시하여 Agent의 거부 가능성을 줄여요. 오래 지속되는 트레이스나 스팬이 많은 트레이스가 있을 때만 사용하세요.

DD_TRACE_PARTIAL_FLUSH_MIN_SPANS

타입: int 기본값: 1000 시작 버전: v2.6.0 부분 플러시가 트리거되기 전 트레이스에 누적되어야 하는 완료된 스팬의 최소 수예요. 잘못된 값은 무시돼요.

DD_TRACE_PEER_SERVICE_DEFAULTS_ENABLED

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

DD_TRACE_PEER_SERVICE_MAPPING

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

DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED

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

DD_TRACE_REPORT_HOSTNAME

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

DD_TRACE_RESOURCE_RENAMING_ALWAYS_SIMPLIFIED_ENDPOINT

타입: boolean 기본값: false 시작 버전: v2.4.0 명시적 엔드포인트를 사용할 수 있을 때에도 http.endpoint 태그를 Resource Renaming 단순화 알고리즘의 결과로 항상 설정해요.

DD_TRACE_RESOURCE_RENAMING_ENABLED

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

DD_TRACE_RETRY_INTERVAL

타입: string 기본값: 1ms 시작 버전: v2.6.0 Agent에 페이로드 제출을 재시도하는 간격을 설정해요.

DD_TRACE_SOURCE_HOSTNAME

타입: string 트레이싱 데이터와 함께 보고되는 호스트명을 설정해요. 설정하면 호스트명 보고가 활성화되고 자동 감지 대신 이 값이 사용돼요.

DD_TRACE_SPAN_ATTRIBUTE_SCHEMA

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

DD_TRACE_STATS_COMPUTATION_ENABLED

타입: boolean 기본값: true 시작 버전: v2.6.0 별칭:DD_TRACE_TRACER_METRICS_ENABLED 클라이언트 측 트레이스 통계 계산이 활성화되는지 제어해요. 활성화하면 트레이서가 수집을 위해 스팬 통계를 사전 집계해요.

DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH

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

폐기된 키 (Retired keys)

(1)

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

DD_TRACE_V1_PAYLOAD_FORMAT_ENABLED

v2.7.0에서 제거됨. 타입: boolean 기본값: false 활성화되고 Agent가 지원하면 레거시 형식 대신 v1 페이로드 형식으로 트레이스를 전송해요.

트레이스 샘플링 (Trace Sampling)

(6)

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

DD_SPAN_SAMPLING_RULES

타입: array 기본값: [] 나머지 트레이스가 버려질 때 개별 스팬을 유지하기 위한 스팬 샘플링 규칙이에요. 객체의 JSON 배열이에요. 규칙은 구성된 순서대로 적용되어 스팬의 샘플 비율을 결정해요. sample_rate 값은 0.0~1.0(포함) 사이여야 해요. 자세한 내용은 수집 메커니즘을 참고하세요. 예: 서비스 my-service와 운영 이름 http.request에 대해 스팬 샘플 비율을 50%, 최대 초당 50 트레이스로 설정: [{"service": "my-service", "name": "http.request", "sample_rate":0.5, "max_per_second": 50}].

DD_SPAN_SAMPLING_RULES_FILE

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

DD_TRACE_RATE_LIMIT

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

DD_TRACE_SAMPLE_RATE

타입: decimal 기본값: 1 시작 버전: v2.6.0 Agent와 백엔드 사이의 수집 샘플 비율(0.0~1.0)을 제어해요.

DD_TRACE_SAMPLING_RULES

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

예시:

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

DD_TRACE_SAMPLING_RULES_FILE

타입: string 트레이스 샘플링 규칙의 JSON 배열이 포함된 파일 경로예요. DD_TRACE_SAMPLING_RULES가 설정되지 않았을 때 사용돼요.

트레이스 전파 (Trace Propagation)

(12)

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

DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED

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

DD_TRACE_HEADER_TAGS

타입: array 스팬 태그로 자동 적용할 HTTP 헤더의 쉼표 구분 목록이에요. 각 항목은 헤더 이름만 사용하거나(들어오는 요청의 경우 http.request.headers.<header> 아래, 나가는 응답의 경우 http.response.headers.<header> 아래에 보고됨), 태그 키를 제어하기 위해 <header>:<custom_tag_name> 형식일 수 있어요.

DD_TRACE_HTTP_CLIENT_ERROR_STATUSES

타입: string 기본값: 400-499 별칭:DD_HTTP_CLIENT_ERROR_STATUSES HTTP 클라이언트 스팬에서 오류로 처리할 HTTP 상태 코드와 범위의 쉼표 구분 목록이에요(예: 400-499,500). 설정하면 일치하는 응답이 스팬을 오류로 표시해요.

DD_TRACE_HTTP_CLIENT_TAG_QUERY_STRING

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

DD_TRACE_HTTP_SERVER_ERROR_STATUSES

타입: string 기본값: 500-599 시작 버전: v2.6.0 HTTP 서버 스팬에서 오류로 처리할 HTTP 상태 코드 또는 범위의 쉼표 구분 목록이에요(예: 500-599,404). 설정하지 않으면 기본적으로 5xx 응답이 오류로 처리돼요.

DD_TRACE_HTTP_URL_QUERY_STRING_DISABLED

타입: boolean 기본값: false 들어오는 HTTP 요청의 http.url 태그에 URL 쿼리 문자열을 포함하지 않도록 비활성화해요. 비활성화하면 경로만 보고돼요.

DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED

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

DD_TRACE_PROPAGATION_EXTRACT_FIRST

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

DD_TRACE_PROPAGATION_STYLE

타입: array 기본값: datadog,tracecontext,baggage 시작 버전: v2.6.0 별칭:OTEL_PROPAGATORS 분산 트레이싱 전파 데이터를 주입·추출하려 시도할 헤더 형식의 쉼표 구분 목록이에요. 완전하고 유효한 헤더가 있는 첫 번째 형식이 계속할 트레이스를 정의하는 데 사용돼요. 더 구체적인 DD_TRACE_PROPAGATION_STYLE_INJECT와 DD_TRACE_PROPAGATION_STYLE_EXTRACT 구성이 있으면 우선해요.

DD_TRACE_PROPAGATION_STYLE_EXTRACT

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

DD_TRACE_PROPAGATION_STYLE_INJECT

타입: array 기본값: datadog, tracecontext, baggage 시작 버전: v2.6.0 별칭:DD_TRACE_PROPAGATION_STYLE 서비스 간 분산 트레이스를 전파하기 위해 포함할 헤더 형식의 쉼표 구분 목록이에요.

DD_TRACE_SQL_COMMENT_INJECTION_MODE

타입: string 데이터베이스 모니터링 상관관계에 사용되는 SQL 주석 주입을 제어해요. 지원 값은 disabled, service, full이에요.

트레이스 통합 (Trace Integrations)

(36)

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

구성 종류 (Configuration Kinds)

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

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`

(32개 통합)

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

사용 가능한 통합:AWS, BUNTDB, CHI, CONSUL, ELASTIC, FIBER, GIN, GOCQL, GOOGLE_API, GOPG, GQLGEN, GRAPHQL, GRPC, HTTP, HTTPROUTER, KAFKA, LEVELDB, MCP, MEMCACHE, MGO, MONGO, MUX, NEGRONI, REDIGO, REDIS, RESTFUL, SARAMA, SQL, TWIRP, VALKEY, VAULT, ZEROLOG

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

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

AWS

(1)

DD_TRACE_AWS_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 AWS SDK 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

BUNTDB

(1)

DD_TRACE_BUNTDB_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 BuntDB 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

CHI

(1)

DD_TRACE_CHI_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 chi 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

CONSUL

(1)

DD_TRACE_CONSUL_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Consul 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

ELASTIC

(1)

DD_TRACE_ELASTIC_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Elasticsearch 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

FIBER

(1)

DD_TRACE_FIBER_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Fiber 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

GIN

(1)

DD_TRACE_GIN_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Gin 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

GOCQL

(2)

DD_TRACE_GOCQL_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 gocql 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

DD_TRACE_GOCQL_COMPAT

타입: string gocql 통합에 대한 호환성 버전을 설정해요. 유효한 semver 값(예: v1.65.0)으로 설정하면 이전 버전에서 특정 클러스터 태그가 보고되는 방식을 조정해요.

GOOGLE_API

(1)

DD_TRACE_GOOGLE_API_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Google API 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

GOPG

(1)

DD_TRACE_GOPG_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 go-pg 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

GQLGEN

(1)

DD_TRACE_GQLGEN_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 gqlgen 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

GRAPHQL

(2)

DD_TRACE_GRAPHQL_ANALYTICS_ENABLED

타입: boolean 기본값: false 시작 버전: v2.6.0 애널리틱스 샘플 비율을 1.0으로 설정해 GraphQL 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

DD_TRACE_GRAPHQL_ERROR_EXTENSIONS

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

GRPC

(1)

DD_TRACE_GRPC_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 gRPC 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

HTTP

(1)

DD_TRACE_HTTP_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 net/http 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

HTTPROUTER

(1)

DD_TRACE_HTTPROUTER_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 httprouter 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

KAFKA

(1)

DD_TRACE_KAFKA_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Kafka 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

LEVELDB

(1)

DD_TRACE_LEVELDB_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 LevelDB 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

MCP

(1)

DD_TRACE_MCP_ANALYTICS_ENABLED

타입: boolean 기본값: false 시작 버전: v2.5.0 이 설정은 현재 MCP 통합에서 사용되지 않으며 효과가 없어요.

MEMCACHE

(1)

DD_TRACE_MEMCACHE_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Memcache 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

MGO

(1)

DD_TRACE_MGO_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 mgo 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

MONGO

(1)

DD_TRACE_MONGO_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 MongoDB 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

MUX

(1)

DD_TRACE_MUX_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 gorilla/mux 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

NEGRONI

(1)

DD_TRACE_NEGRONI_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Negroni 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

REDIGO

(1)

DD_TRACE_REDIGO_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Redigo 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

REDIS

(2)

DD_TRACE_REDIS_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Redis 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

DD_TRACE_REDIS_RAW_COMMAND

타입: boolean 기본값: false Redis 클라이언트 스팬이 원시 명령을 담은 태그를 포함하는지 제어해요. 이는 민감한 데이터를 노출할 수 있으므로 기본적으로 비활성화되어 있어요.

RESTFUL

(1)

DD_TRACE_RESTFUL_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 go-restful 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

SARAMA

(1)

DD_TRACE_SARAMA_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Sarama 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

SQL

(1)

DD_TRACE_SQL_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 database/sql 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

TWIRP

(1)

DD_TRACE_TWIRP_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Twirp 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

VALKEY

(2)

DD_TRACE_VALKEY_ANALYTICS_ENABLED

타입: boolean 기본값: false 시작 버전: v2.6.0 별칭:DD_VALKEY_ANALYTICS_ENABLED 이 설정은 현재 valkey-go 통합에서 사용되지 않으며 효과가 없어요.

DD_TRACE_VALKEY_RAW_COMMAND

타입: boolean 기본값: false Valkey 클라이언트 스팬이 원시 명령을 담은 태그를 포함하는지 제어해요. 이는 민감한 데이터를 노출할 수 있으므로 기본적으로 비활성화되어 있어요.

VAULT

(1)

DD_TRACE_VAULT_ANALYTICS_ENABLED

타입: boolean 기본값: false 애널리틱스 샘플 비율을 1.0으로 설정해 Vault 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

ZEROLOG

(1)

DD_TRACE_ZEROLOG_ANALYTICS_ENABLED

타입: boolean 기본값: false 시작 버전: v2.7.0 애널리틱스 샘플 비율을 1.0으로 설정해 zerolog 통합이 생성하는 스팬에 대한 트레이스 애널리틱스를 활성화해요.

Database Monitoring

(1)

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

DD_DBM_PROPAGATION_MODE

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

트레이스 로깅 (Trace Logging)

(7)

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

DD_LOGGING_RATE

타입: int 기본값: 60 집계된 내부 오류가 로그에 플러시되는 주기(초)를 설정해요. 오류를 즉시 로깅하려면 0으로 설정하세요.

DD_TRACE_DEBUG

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

언어별 참고:

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

DD_TRACE_DEBUG_ABANDONED_SPANS

타입: boolean 기본값: false Datadog Go 트레이서는 잠재적으로 버려진 스팬에 대한 로깅도 지원해요. Go에서 이 디버그 모드를 활성화하려면 환경 변수 DD_TRACE_DEBUG_ABANDONED_SPANS=true를 설정하세요. 스팬이 버려진 것으로 간주되는 기간(기본값=10분)을 변경하려면 환경 변수 DD_TRACE_ABANDONED_SPAN_TIMEOUT를 원하는 시간으로 설정하세요. 버려진 스팬 로그는 Info 수준에 나타나요.

DD_TRACE_DEBUG_SEELOG_WORKAROUND

타입: boolean 기본값: true seelog 관련 goroutine 누수에 대한 해결책(workaround)이 적용되는지 제어해요. 해결책을 비활성화하려면 false로 설정하세요.

DD_TRACE_DEBUG_STACK

타입: boolean 기본값: true 시작 버전: v2.6.0 오류로 끝나는 스팬에 대해 스택 트레이스가 캡처되는지 제어해요.

DD_TRACE_LOG_DIRECTORY

타입: string 트레이서 로그가 기록되는 디렉터리를 설정해요. 디렉터리가 존재해야 하며, 그렇지 않으면 로그가 stderr에 남아요.

DD_TRACE_STARTUP_LOGS

타입: boolean 기본값: true 시작 버전: v2.6.0 트레이서가 초기화될 때 시작 구성과 진단 로그 줄의 생성을 활성화해요.

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

(16)

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

DD_PROFILING_AGENTLESS

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

DD_PROFILING_CODE_HOTSPOTS_COLLECTION_ENABLED

타입: boolean 기본값: true 스팬이 Datadog UI에서 프로파일을 특정 트레이스 코드 핫스팟에 연결하는 데 사용되는 pprof 레이블(스팬 ID와 로컬 루트 스팬 ID)을 추가하는지 제어해요.

DD_PROFILING_DEBUG_COMPRESSION_SETTINGS

타입: string 기본값: zstd 프로파일 업로드 준비 시 사용되는 압축 알고리즘과 수준이에요. 허용 값은 legacy, gzip, zstd-<level>(예: zstd-3)이에요.

DD_PROFILING_DELTA

타입: boolean 기본값: true 델타 프로파일이 활성화되는지 제어해요. 활성화하면 프로파일 값이 절대값이 아닌 이전 프로파일 이후의 변화량으로 보고돼요.

DD_PROFILING_ENABLED

타입: string 기본값: true 시작 버전: v2.6.0 CPU, 힙, goroutine 및 기타 런타임 프로파일을 수집해 Datadog에 업로드하는 연속 프로파일러를 활성화해요.

DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

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

DD_PROFILING_ENDPOINT_COUNT_ENABLED

타입: boolean 기본값: false 프로파일러가 실행되는 동안 엔드포인트 적중 횟수를 계산하고 업로드된 프로파일에 그 횟수를 포함시켜요.

DD_PROFILING_EXECUTION_TRACE_ENABLED

타입: boolean 기본값: true 런타임 실행 트레이스가 수집·업로드되는지 제어해요. amd64와 arm64에서 기본적으로 활성화돼요.

DD_PROFILING_EXECUTION_TRACE_LIMIT_BYTES

타입: int 기본값: 5242880 수집된 실행 트레이스의 대략적인 최대 크기(바이트)를 설정해요. 기본값은 5MB예요.

DD_PROFILING_EXECUTION_TRACE_PERIOD

타입: string 기본값: 15m 실행 트레이스 수집 사이의 시간을 설정해요. 기본값은 15분이에요.

DD_PROFILING_FLUSH_ON_EXIT

타입: boolean 기본값: false 프로세스가 종료될 때 프로파일러가 버퍼링된 프로파일 업로드 완료를 시도하는지 제어해요. 비활성화하면 종료 시 보류 중인 업로드가 취소돼요.

DD_PROFILING_OUTPUT_DIR

타입: string 디버깅을 위해 수집된 프로파일의 복사본을 지정된 디렉터리에 기록해요. 정리가 수행되지 않으므로 디렉터리는 시간이 지나면서 커질 수 있어요.

DD_PROFILING_UPLOAD_TIMEOUT

타입: string 기본값: 10s 시작 버전: v2.6.0 프로파일 업로드 HTTP 요청의 타임아웃을 설정해요. 기본값은 10초이며 0보다 커야 해요.

DD_PROFILING_URL

타입: string 기본값: https://intake.profile.datadoghq.com/v1/input 시작 버전: v2.6.0 에이전트리스 업로드에 사용되는 프로파일링 인테이크 URL을 재정의해요. 주로 테스트나 디버깅을 위한 것이에요.

DD_PROFILING_WAIT_PROFILE

타입: boolean 기본값: false 설정하면 실험적 goroutine 대기 프로파일을 활성화해요. 1분 이상 차단된 goroutine에 대한 스택 트레이스와 대기 시간을 수집해요.

DD_PROFILING_WAIT_PROFILE_MAX_GOROUTINES

타입: int 기본값: 1000 goroutine 대기 프로파일을 수집할 때 허용되는 최대 goroutine 수를 설정해요. 프로세스가 이 한도를 초과하면 대기 프로파일은 건너뛰어져요.

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

(16)

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

DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE

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

DD_API_SECURITY_DOWNSTREAM_REQUEST_BODY_ANALYSIS_SAMPLE_RATE

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

DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED

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

DD_API_SECURITY_ENDPOINT_COLLECTION_MESSAGE_LIMIT

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

DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS

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

DD_APPSEC_BODY_PARSING_SIZE_LIMIT

타입: int 기본값: 10485760 시작 버전: v2.6.0 프록시/외부 처리 통합 뒤에서 실행할 때 보안 기능을 위해 버퍼링·분석할 HTTP 요청·응답 본문의 최대 바이트 수를 설정해요. 0 이하의 값은 본문 분석을 비활성화하고, 한도를 초과하는 본문은 잘려요.

DD_APPSEC_ENABLED

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

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML

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

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_JSON

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

DD_APPSEC_MAX_STACK_TRACE_DEPTH

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

DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP

DD_APPSEC_OBFUSCATION_PARAMETER_VALUE_REGEXP

타입: string 기본값: (?i)(?:p(?:ass)?w(?:or)?d|pass(?:[_-]?phrase)?|secret(?:[_-]?key)?|(?:(?:api|private|public|access)[_-]?)key(?:[_-]?id)?|(?:(?:auth|access|id|refresh)[_-]?)?token|consumer[_-]?(?:id|key|secret)|sign(?:ed|ature)?|auth(?:entication|orization)?|jsessionid|phpsessid|asp\\.net(?:[_-]|-)sessionid|sid|jwt)(?:\s*=([^;&]+)|\"\s*:\s*(\"[^\"]+\"|\d+))|bearer\s+([a-z0-9\._\-]+)|token\s*:\s*([a-z0-9]{13})|gh[opsu]_([0-9a-zA-Z]{36})|ey[I-L][\w=-]+\.(ey[I-L][\w=-]+(?:\.[\w.+\/-=]+)?)|[\-]{5}BEGIN[a-z\s]+PRIVATE\sKEY[\-]{5}([^\-]+)[\-]{5}END[a-z\s]+PRIVATE\sKEY|ssh-rsa\s*([a-z0-9\/\.+]{100,}) 시작 버전: v2.6.0 매개변수 값과 하이라이트 내부에서 민감한 부분 문자열을 찾아 편집하는 정규식이에요. 일치 항목은 <redacted by datadog>로 대체돼요. 키 정규식 이후에 실행되며, 키 정규식이 우선해요. 기본 패턴은 토큰, JWT, 개인 키 블록 및 기타 자격 증명 형태를 대상으로 해요. 값 기반 편집을 비활성화하려면 빈 문자열로 설정하세요.

DD_APPSEC_RULES

타입: string 시작 버전: v2.6.0 트레이서와 함께 제공되는 기본 AppSec 규칙을 재정의하는 JSON 규칙 파일 경로.

DD_APPSEC_SCA_ENABLED

타입: boolean 기본값: false 시작 버전: v2.6.0 트레이서의 런타임 SCA(Software Composition Analysis)를 활성화해 런타임 의존성/SBOM 데이터를 보고하고 런타임 취약점 감지를 지원해요. SCA에는 SCA 문서에 설명된 청구 영향과 언어 호환성 제약이 있을 수 있어요.

DD_APPSEC_STACK_TRACE_ENABLED

타입: boolean 기본값: true 시작 버전: v2.6.0 별칭:DD_APPSEC_STACK_TRACE_ENABLE AppSec 보안 이벤트에 첨부된 스택 트레이스 생성을 활성화해요. 이벤트 페이로드에서 스택 트레이스를 생략하려면 비활성화하세요.

DD_APPSEC_WAF_TIMEOUT

타입: string 기본값: 2ms 시작 버전: v2.6.0 단일 WAF 평가의 최대 동기 실행 시간으로, Go duration으로 표현돼요(예: 2ms, 500us). 이 예산을 초과하는 요청은 WAF 검사를 건너뛰어요. WAF 타임아웃이 자주 보이면 값을 올리고, 요청 경로 오버헤드를 제한하려면 낮추세요.

폐기된 키 (Retired keys)

(1)

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

DD_APPSEC_STACK_TRACE_ENABLE

v2.6.0에서 제거됨. AppSec 보안 이벤트에 첨부된 스택 트레이스 생성을 활성화해요. 이벤트 페이로드에서 스택 트레이스를 생략하려면 비활성화하세요.

Dynamic Instrumentation 및 디버깅

(1)

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

DD_DYNAMIC_INSTRUMENTATION_ENABLED

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

CI 가시성 (CI Visibility)

(30)

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

DD_ACTION_EXECUTION_ID

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

DD_CIVISIBILITY_AGENTLESS_ENABLED

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

DD_CIVISIBILITY_AGENTLESS_URL

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

DD_CIVISIBILITY_AUTO_INSTRUMENTATION_PROVIDER

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

DD_CIVISIBILITY_ENABLED

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

DD_CIVISIBILITY_FLAKY_RETRY_COUNT

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

DD_CIVISIBILITY_FLAKY_RETRY_ENABLED

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

DD_CIVISIBILITY_IMPACTED_TESTS_DETECTION_ENABLED

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

DD_CIVISIBILITY_LOGS_ENABLED

타입: boolean 기본값: false CI 테스트 로그를 Datadog Logs 인테이크로 직접 제출하는 것을 활성화해요.

DD_CIVISIBILITY_SUBTEST_FEATURES_ENABLED

타입: boolean 기본값: true 시작 버전: v2.5.0 하위 테스트별 CI 테스트 관리 및 재시도 기능의 킬 스위치예요. 원격 설정으로 활성화되어 있어도 하위 테스트 기능을 비활성화하려면 false로 설정하세요.

DD_CIVISIBILITY_TOTAL_FLAKY_RETRY_COUNT

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

DD_CIVISIBILITY_USE_NOOP_TRACER

타입: boolean 기본값: false 시작 버전: v2.5.0 CI 테스트 보고 모드에서 설정하면 트레이서를 no-op 구현으로 대체해 테스트 동작의 변화를 최소화해요.

DD_CUSTOM_TRACE_ID

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

DD_GIT_BRANCH

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

DD_GIT_COMMIT_AUTHOR_DATE

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

DD_GIT_COMMIT_AUTHOR_EMAIL

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

DD_GIT_COMMIT_AUTHOR_NAME

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

DD_GIT_COMMIT_COMMITTER_DATE

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

DD_GIT_COMMIT_COMMITTER_EMAIL

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

DD_GIT_COMMIT_COMMITTER_NAME

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

DD_GIT_COMMIT_MESSAGE

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

DD_GIT_COMMIT_SHA

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

DD_GIT_REPOSITORY_URL

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

DD_GIT_TAG

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

DD_PIPELINE_EXECUTION_ID

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

DD_TEST_MANAGEMENT_ATTEMPT_TO_FIX_RETRIES

타입: int 기본값: -1 시작 버전: v2.6.0 테스트 관리 attempt-to-fix 기능의 최대 재시도 횟수를 재정의해요. 설정하면 원격 설정이 제공하는 값을 대체해요.

DD_TEST_MANAGEMENT_ENABLED

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

DD_TEST_OPTIMIZATION_ENV_DATA_FILE

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

DD_TEST_SESSION_NAME

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

DD_TRACE_GIT_METADATA_ENABLED

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

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

(1)

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

DD_LOGS_OTEL_ENABLED

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

런타임 메트릭 (Runtime Metrics)

(4)

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

DD_DOGSTATSD_HOST

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

DD_DOGSTATSD_PORT

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

DD_RUNTIME_METRICS_ENABLED

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

DD_RUNTIME_METRICS_V2_ENABLED

타입: boolean 기본값: true 런타임 메트릭 v2가 내보내지는지 제어해요. 기본값은 true예요.

Data Streams Monitoring

(1)

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

DD_DATA_STREAMS_ENABLED

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

계측 텔레메트리 (Instrumentation Telemetry)

(5)

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

DD_INSTRUMENTATION_TELEMETRY_ENABLED

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

DD_TELEMETRY_DEBUG

타입: boolean 기본값: false 계측 텔레메트리의 디버그 모드를 활성화해요. 설정하면 다른 구성과 관계없이 텔레메트리 디버그 모드를 강제로 켜요.

DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED

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

DD_TELEMETRY_LOG_COLLECTION_ENABLED

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

DD_TELEMETRY_METRICS_ENABLED

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

원격 구성 (Remote Configuration)

(1)

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

DD_REMOTE_CONFIGURATION_ENABLED

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

OpenTelemetry 호환성 (OpenTelemetry Compatibility)

(29)

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

DD_METRICS_OTEL_ENABLED

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

OTEL_BLRP_EXPORT_TIMEOUT

타입: int 기본값: 30000 시작 버전: v2.7.0 단일 OTLP 로그 내보내기 요청이 취소되기 전까지 허용되는 최대 시간(밀리초).

OTEL_BLRP_MAX_EXPORT_BATCH_SIZE

타입: int 기본값: 512 시작 버전: v2.7.0 단일 OTLP 페이로드의 최대 레코드 수. 최대 큐 크기보다 작거나 같아야 해요.

OTEL_BLRP_MAX_QUEUE_SIZE

타입: int 기본값: 2048 시작 버전: v2.7.0 메모리에 보관되는 최대 로그 레코드 수. 이 한도에 도달하면 새 레코드는 버려져요.

OTEL_BLRP_SCHEDULE_DELAY

타입: int 기본값: 1000 시작 버전: v2.7.0 두 연속 OTLP 로그 내보내기 작업 사이의 간격(밀리초).

OTEL_EXPORTER_OTLP_ENDPOINT

타입: string 기본값: http://localhost:4318 시작 버전: v2.6.0 OpenTelemetry 메트릭 내보내기가 사용하는 OTLP exporter 엔드포인트를 설정해요. 설정하면 Agent 구성에서 파생된 기본 엔드포인트를 재정의해요.

OTEL_EXPORTER_OTLP_HEADERS

타입: map 시작 버전: v2.6.0 OTLP 내보내기용 사용자 지정 헤더를 설정하는 구성 키예요(메트릭별 헤더의 대체값). 메트릭별 OTLP 헤더가 설정되지 않았을 때 사용돼요. 형식: api-key=key,other=value.

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

타입: string 시작 버전: v2.7.0 별칭:OTEL_EXPORTER_OTLP_ENDPOINT OTLP 로그를 보내는 URL이에요. OTEL_EXPORTER_OTLP_ENDPOINT보다 우선해요. gRPC의 기본값은 http://localhost:4317, HTTP의 기본값은 http://localhost:4318/v1/logs이에요.

OTEL_EXPORTER_OTLP_LOGS_HEADERS

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

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

타입: string 기본값: http/json 시작 버전: v2.7.0 로그 데이터에 사용할 OTLP 전송 프로토콜을 지정해요.

OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

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

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

타입: string 기본값: http://localhost:4318 시작 버전: v2.6.0 OTLP 메트릭을 보내는 URL이에요. OTEL_EXPORTER_OTLP_ENDPOINT보다 우선해요. gRPC의 기본값은 http://localhost:4317, HTTP의 기본값은 http://localhost:4318/v1/metrics이에요. HTTP 프로토콜의 경우 일반 OTEL_EXPORTER_OTLP_ENDPOINT를 대체값으로 사용하면 SDK가 자동으로 /v1/metrics를 추가해요.

OTEL_EXPORTER_OTLP_METRICS_HEADERS

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

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

타입: string 기본값: http/protobuf 시작 버전: v2.6.0 별칭:OTEL_EXPORTER_OTLP_PROTOCOL OpenTelemetry OTLP 메트릭 내보내기에 사용되는 프로토콜을 선택해요. http/protobuf만 지원돼요.

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE

타입: string 기본값: delta 시작 버전: v2.5.0 메트릭 집계 temporality를 제어해요. 허용 값: delta 또는 cumulative(대소문자 무시); 빈 값이나 잘못된 값은 delta로 처리돼요.

OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

타입: int 기본값: 10000 시작 버전: v2.6.0 별칭:OTEL_EXPORTER_OTLP_TIMEOUT 단일 나가는 OTLP 메트릭 요청의 타임아웃(밀리초). OTEL_EXPORTER_OTLP_TIMEOUT보다 우선해요.

OTEL_EXPORTER_OTLP_PROTOCOL

타입: string 기본값: http/protobuf 시작 버전: v2.5.0 재정의되지 않는 한 모든 신호에 사용할 전송 프로토콜을 지정해요. 허용 값: grpc, http/protobuf, http/json.

OTEL_EXPORTER_OTLP_TIMEOUT

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

OTEL_LOG_LEVEL

타입: string 시작 버전: v2.6.0 OTEL_LOG_LEVEL은 DD_TRACE_DEBUG에 매핑되며 트레이서의 디버그 모드를 활성화해요. 유효한 값으로 "debug"만 허용해요.

OTEL_LOGS_EXPORTER

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

OTEL_METRIC_EXPORT_INTERVAL

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

OTEL_METRIC_EXPORT_TIMEOUT

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

OTEL_METRICS_EXPORTER

타입: string 시작 버전: v2.6.0 OTEL_METRICS_EXPORTER는 exporter를 선택하는 데 사용되지 않아요. none에 대해서만 효과적으로 인정되어 메트릭을 강제로 꺼요. 설정하지 않으면 그 자체로 메트릭을 활성화하지 않으며, 실제로 메트릭을 생성하려면 DD_METRICS_OTEL_ENABLED를 true로 설정해야 해요.

OTEL_PROPAGATORS

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

OTEL_RESOURCE_ATTRIBUTES

타입: string 시작 버전: v2.6.0 해당 트레이서 태그 설정이 설정되지 않았을 때 트레이서 태그에 매핑되는 OpenTelemetry 리소스 속성을 설정해요. 서비스, 환경, 버전용 예약 속성은 표준 태그에 매핑되고, 처음 10개 속성만 적용돼요. 퍼센트 인코딩된 쉼표와 등호 구분자는 그대로 리터럴로 유지돼요.

OTEL_SERVICE_NAME

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

OTEL_TRACES_EXPORTER

타입: string 시작 버전: v2.6.0 exporter 선택에 사용되지 않아요. 유효한 값은 none뿐이며, 이는 트레이싱을 비활성화해요(DD_TRACE_ENABLED=false와 동일). 다른 값은 모두 무시돼요. DD_TRACE_ENABLED가 설정되면 우선해요.

OTEL_TRACES_SAMPLER

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

OTEL_TRACES_SAMPLER_ARG

타입: decimal 기본값: 1.0 traceidratio 샘플러를 사용할 때 OTEL_TRACES_SAMPLER의 인자를 설정해요(예: OTEL_TRACES_SAMPLER_ARG=0.25). OpenTelemetry 구성을 매핑할 때 트레이서 샘플 비율을 도출하는 데 사용돼요.

AI 및 LLM Observability

(2)

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

DD_LLMOBS_AGENTLESS_ENABLED

타입: boolean 시작 버전: v2.6.0 LLM Observability가 데이터를 인테이크로 직접 전송하는지(에이전트리스 방식) 아니면 에이전트/프록시를 통해 전송하는지 제어해요. 설정하지 않으면 Agent 지원에 따라 방식이 자동으로 선택되고, false로 설정하려면 LLM Observability를 지원하는 Agent가 필요해요.

DD_LLMOBS_ML_APP

타입: string 시작 버전: v2.6.0 LLM Observability 데이터에 사용되는 기본 ML 앱 이름을 설정해요. LLM Observability가 활성화되면 이 값이 필요해요.

계측 및 플랫폼 (Instrumentation & Platform)

(12)

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

DD_HAPROXY_SPOA_HEALTHCHECK_PORT

타입: int 기본값: 3080 시작 버전: v2.4.0 HAProxy SPOA 통합이 헬스 체크 HTTP 서버를 노출하는 포트예요.

DD_HAPROXY_SPOA_HOST

타입: string 기본값: 0.0.0.0 시작 버전: v2.4.0 HAProxy SPOA 통합 서버가 수신 대기하는 호스트 주소.

DD_HAPROXY_SPOA_PORT

타입: int 기본값: 3000 시작 버전: v2.4.0 HAProxy SPOA 통합 서버가 수신 대기하는 포트.

DD_REQUEST_MIRROR_HEALTHCHECK_ADDR

타입: string 기본값: :8081 request-mirror 통합이 헬스 체크 HTTP 서버를 노출하는 주소(host:port).

DD_REQUEST_MIRROR_LISTEN_ADDR

타입: string 기본값: :8080 request-mirror 통합의 HTTP 서버가 수신 대기하는 주소(host:port).

DD_SERVICE_EXTENSION_HEALTHCHECK_PORT

타입: int 기본값: 80 service-extension 헬스 체크 HTTP 서버가 수신 대기하는 포트.

DD_SERVICE_EXTENSION_HOST

타입: string 기본값: 0.0.0.0 service-extension 서버가 수신 대기하는 IP 주소.

DD_SERVICE_EXTENSION_OBSERVABILITY_MODE

타입: boolean 기본값: false service extension의 관측 모드를 활성화해요. 활성화하면 차단 액션이 비활성화돼요.

DD_SERVICE_EXTENSION_PORT

타입: int 기본값: 443 service-extension gRPC 서버가 수신 대기하는 포트.

DD_SERVICE_EXTENSION_TLS

타입: boolean 기본값: true 시작 버전: v2.4.0 service-extension gRPC 서버에서 TLS가 활성화되는지 제어해요.

DD_SERVICE_EXTENSION_TLS_CERT_FILE

타입: string 기본값: localhost.crt 시작 버전: v2.4.0 service-extension gRPC 서버가 사용하는 TLS 인증서 파일 경로.

DD_SERVICE_EXTENSION_TLS_KEY_FILE

타입: string 기본값: localhost.key 시작 버전: v2.4.0 service-extension gRPC 서버가 사용하는 TLS 개인 키 파일 경로.

기타 (Miscellaneous)

(1)

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED

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

Go SDK 구성 (Configuring the Go SDK)

본문

APM 환경 이름 구성 (Configure APM environment name)

구성 키 (Configuration keys)

일반 설정 (General Settings)

트레이싱 코어 (Tracing Core)

폐기된 키 (Retired keys)

트레이스 샘플링 (Trace Sampling)

트레이스 전파 (Trace Propagation)

트레이스 통합 (Trace Integrations)

구성 종류 (Configuration Kinds)

DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED

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

AWS

BUNTDB

CHI

CONSUL

ELASTIC

FIBER

GIN

GOCQL

GOOGLE_API

GOPG

GQLGEN

GRAPHQL

GRPC

HTTP

HTTPROUTER

KAFKA

LEVELDB

MCP

MEMCACHE

MGO

MONGO

MUX

NEGRONI

REDIGO

REDIS

RESTFUL

SARAMA

SQL

TWIRP

VALKEY

VAULT

ZEROLOG

Database Monitoring

트레이스 로깅 (Trace Logging)

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

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

폐기된 키 (Retired keys)

Dynamic Instrumentation 및 디버깅

CI 가시성 (CI Visibility)

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

런타임 메트릭 (Runtime Metrics)

Data Streams Monitoring

계측 텔레메트리 (Instrumentation Telemetry)

원격 구성 (Remote Configuration)

OpenTelemetry 호환성 (OpenTelemetry Compatibility)

AI 및 LLM Observability

계측 및 플랫폼 (Instrumentation & Platform)

기타 (Miscellaneous)

더 알아보기 (Learn more)

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`