Ruby SDK 구성 (Configuring the Ruby SDK)

원문 보기 위키 갱신 2026.10.05

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

출처: 문서

본문

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

아래 나열된 환경 변수 외의 추가 구성 옵션은 추가 Ruby 구성을 참고하세요.

구성 키 (Configuration keys)

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

일반 설정 (General Settings)

(12)

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

DD_AGENT_HOST

타입: string 기본값: 127.0.0.1 이 라이브러리가 트레이스 데이터를 보내는 Datadog Agent의 호스트 이름 또는 IP 주소.

DD_API_KEY

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

DD_APM_TRACING_ENABLED

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

DD_APP_KEY

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

DD_ENV

타입: string 애플리케이션의 환경이에요. 모든 스팬에 env 태그를 설정해요.

DD_EXTERNAL_ENV

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

DD_FLAGGING_EVALUATION_COUNTS_ENABLED

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

DD_HOSTNAME

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

DD_SERVICE

타입: string 기본값: ruby 별칭:OTEL_SERVICE_NAME 트레이스의 service 태그로 설정되는 애플리케이션의 기본 서비스 이름이에요.

DD_SITE

타입: string 텔레메트리나 AI Guard API 호출 같은 에이전트리스 요청을 위한 Datadog 인테이크 도메인을 선택하는 데 사용되는 Datadog 사이트.

DD_TAGS

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

DD_VERSION

타입: string 트레이스의 version 태그로 설정되는 애플리케이션 버전이에요.

트레이싱 코어 (Tracing Core)

(17)

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

DD_TRACE_128_BIT_TRACEID_GENERATION_ENABLED

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

DD_TRACE_128_BIT_TRACEID_LOGGING_ENABLED

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

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_TIMEOUT_SECONDS

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

DD_TRACE_AGENT_URL

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

DD_TRACE_ANALYTICS_ENABLED

타입: boolean 레거시 트레이스 애널리틱스 기능을 활성화해요(더 이상 사용되지 않음).

DD_TRACE_CLIENT_IP_ENABLED

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

DD_TRACE_CLIENT_IP_HEADER

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

DD_TRACE_ENABLED

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

DD_TRACE_NATIVE_SPAN_EVENTS

타입: boolean 트레이서가 항상 네이티브 스팬 이벤트 형식으로 스팬 이벤트를 보내도록 강제해요. 에이전트리스 설정에서 유용할 수 있어요.

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.23.0 활성화하면 명시적 엔드포인트를 사용할 수 있는 경우에도 항상 Resource Renaming 단순화 알고리즘의 결과로 http.endpoint 태그를 설정해요.

DD_TRACE_RESOURCE_RENAMING_ENABLED

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

DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH

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

트레이스 샘플링 (Trace Sampling)

(5)

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

DD_SPAN_SAMPLING_RULES

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

DD_SPAN_SAMPLING_RULES_FILE

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

DD_TRACE_RATE_LIMIT

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

DD_TRACE_SAMPLE_RATE

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

DD_TRACE_SAMPLING_RULES

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

예시:

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

트레이스 전파 (Trace Propagation)

(13)

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

DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED

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

DD_TRACE_BAGGAGE_TAG_KEYS

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

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 시작 버전: v2.23.0 별칭:DD_HTTP_CLIENT_ERROR_STATUSES HTTP 클라이언트 스팬에서 오류로 처리할 HTTP 상태 코드와 범위의 쉼표 구분 목록(예: 400-499,500). 설정하면 일치하는 응답이 스팬을 오류로 표시해요.

DD_TRACE_HTTP_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 net/http 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_HTTP_ERROR_STATUS_CODES

타입: string 기본값: 400-599 net/http 계측으로 생성된 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

DD_TRACE_HTTP_SERVER_ERROR_STATUSES

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

DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED

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

DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT

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

DD_TRACE_PROPAGATION_EXTRACT_FIRST

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

DD_TRACE_PROPAGATION_STYLE

타입: array 별칭:OTEL_PROPAGATORS 추출과 주입 모두에 사용할 분산 트레이싱 전파 형식.

DD_TRACE_PROPAGATION_STYLE_EXTRACT

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

DD_TRACE_PROPAGATION_STYLE_INJECT

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

트레이스 통합 (Trace Integrations)

(204)

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

일반 통합 설정 (General Integration Settings)

DD_DISABLE_DATADOG_RAILS

타입: string 별칭:DISABLE_DATADOG_RAILS Datadog Rails 통합 자동 계측을 비활성화해요.

구성 종류 (Configuration Kinds)

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

`DD_TRACE_<INTEGRATION>_ENABLED`

(54개 통합)

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

사용 가능한 통합:ACTION_CABLE, ACTION_MAILER, ACTION_PACK, ACTION_VIEW, ACTIVE_JOB, ACTIVE_MODEL_SERIALIZERS, ACTIVE_RECORD, ACTIVE_SUPPORT, AWS, CONCURRENT_RUBY, DALLI, DELAYED_JOB, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRAPE, GRAPHQL, GRPC, HANAMI, HTTP, HTTPCLIENT, HTTPRB, KAFKA, KARAFKA, LOGRAGE, MEMCACHED_COMMAND, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, QUE, QUE_TAG_ARGS, QUE_TAG_DATA, RACECAR, RACK, RAILS, RAKE, REDIS, RESQUE, REST_CLIENT, RODA, SEMANTIC_LOGGER, SEQUEL, SHORYUKEN, SIDEKIQ, SINATRA, SNEAKERS, STRIPE, SUCKER_PUNCH, TEST_MODE, TRILOGY, WATERDROP

`DD_TRACE_<INTEGRATION>_ANALYTICS_ENABLED`

(43개 통합)

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

사용 가능한 통합:ACTION_CABLE, ACTION_MAILER, ACTION_PACK, ACTION_VIEW, ACTIVE_JOB, ACTIVE_MODEL_SERIALIZERS, ACTIVE_RECORD, ACTIVE_SUPPORT, AWS, DALLI, DELAYED_JOB, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRAPE, GRAPHQL, GRPC, HTTP, HTTPCLIENT, HTTPRB, KAFKA, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, QUE, RACECAR, RACK, RAILS, RAKE, REDIS, RESQUE, REST_CLIENT, SEQUEL, SHORYUKEN, SIDEKIQ, SINATRA, SNEAKERS, STRIPE, SUCKER_PUNCH, TRILOGY

`DD_TRACE_<INTEGRATION>_ANALYTICS_SAMPLE_RATE`

(43개 통합)

이 통합의 App Analytics 샘플 비율(0.0~1.0)을 설정해요.

`DD_TRACE_<INTEGRATION>_PEER_SERVICE`

(17개 통합)

이 통합의 나가는 요청에 대한 peer.service 태그를 재정의해요.

사용 가능한 통합:AWS, DALLI, ELASTICSEARCH, ETHON, EXCON, FARADAY, GRPC, HTTPCLIENT, HTTPRB, MONGO, MYSQL2, OPENSEARCH, PG, PRESTO, REDIS, REST_CLIENT, TRILOGY

`DD_TRACE_<INTEGRATION>_SERVICE_NAME`

(17개 통합)

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

`DD_TRACE_<INTEGRATION>_DISTRIBUTED_TRACING`

(14개 통합)

이 통합의 분산 트레이스 전파를 활성화하거나 비활성화해요.

사용 가능한 통합:ETHON, EXCON, FARADAY, GRPC, HTTPCLIENT, HTTPRB, KARAFKA, QUE, RACK, RAILS, REST_CLIENT, SIDEKIQ, SINATRA, WATERDROP

`DD_TRACE_<INTEGRATION>_ERROR_STATUS_CODES`

(5개 통합)

이 통합에 대해 어떤 HTTP 상태 코드를 오류로 처리할지 정의해요.

사용 가능한 통합:EXCON, FARADAY, GRAPE, HTTPCLIENT, HTTPRB

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

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

ACTION_CABLE

(3)

DD_TRACE_ACTION_CABLE_ANALYTICS_ENABLED

타입: boolean 기본값: false Action Cable 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTION_CABLE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Action Cable 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTION_CABLE_ENABLED

타입: boolean 기본값: true Action Cable 통합에 대한 트레이싱을 활성화해요.

ACTION_MAILER

(3)

DD_TRACE_ACTION_MAILER_ANALYTICS_ENABLED

타입: boolean 기본값: false Action Mailer 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTION_MAILER_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Action Mailer 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTION_MAILER_ENABLED

타입: boolean 기본값: true Action Mailer 통합에 대한 트레이싱을 활성화해요.

ACTION_PACK

(3)

DD_TRACE_ACTION_PACK_ANALYTICS_ENABLED

타입: boolean Action Pack 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTION_PACK_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Action Pack 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTION_PACK_ENABLED

타입: boolean 기본값: true Action Pack 통합에 대한 트레이싱을 활성화해요.

ACTION_VIEW

(3)

DD_TRACE_ACTION_VIEW_ANALYTICS_ENABLED

타입: boolean 기본값: false Action View 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTION_VIEW_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Action View 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTION_VIEW_ENABLED

타입: boolean 기본값: true Action View 통합에 대한 트레이싱을 활성화해요.

ACTIVE_JOB

(3)

DD_TRACE_ACTIVE_JOB_ANALYTICS_ENABLED

타입: boolean 기본값: false Active Job 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTIVE_JOB_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Active Job 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTIVE_JOB_ENABLED

타입: boolean 기본값: true Active Job 통합에 대한 트레이싱을 활성화해요.

ACTIVE_MODEL_SERIALIZERS

(3)

DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_ENABLED

타입: boolean 기본값: false Active Model Serializers 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Active Model Serializers 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTIVE_MODEL_SERIALIZERS_ENABLED

타입: boolean 기본값: true Active Model Serializers 통합에 대한 트레이싱을 활성화해요.

ACTIVE_RECORD

(3)

DD_TRACE_ACTIVE_RECORD_ANALYTICS_ENABLED

타입: boolean 기본값: false Active Record 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTIVE_RECORD_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Active Record 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTIVE_RECORD_ENABLED

타입: boolean 기본값: true Active Record 통합에 대한 트레이싱을 활성화해요.

ACTIVE_SUPPORT

(3)

DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_ENABLED

타입: boolean 기본값: false Active Support 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ACTIVE_SUPPORT_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Active Support 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ACTIVE_SUPPORT_ENABLED

타입: boolean 기본값: true Active Support 통합에 대한 트레이싱을 활성화해요.

AWS

(5)

DD_TRACE_AWS_ANALYTICS_ENABLED

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

DD_TRACE_AWS_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 AWS 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_AWS_ENABLED

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

DD_TRACE_AWS_PEER_SERVICE

타입: string AWS 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_AWS_SERVICE_NAME

타입: string 기본값: aws AWS 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

CONCURRENT_RUBY

(1)

DD_TRACE_CONCURRENT_RUBY_ENABLED

타입: boolean 기본값: true Concurrent Ruby 통합이 트레이싱 컨텍스트를 전파하는지 제어해요.

DALLI

(5)

DD_TRACE_DALLI_ANALYTICS_ENABLED

타입: boolean 기본값: false Dalli 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_DALLI_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Dalli 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_DALLI_ENABLED

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

DD_TRACE_DALLI_PEER_SERVICE

타입: string Dalli 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_DALLI_SERVICE_NAME

타입: string 기본값: memcached Dalli 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

DELAYED_JOB

(3)

DD_TRACE_DELAYED_JOB_ANALYTICS_ENABLED

타입: boolean 기본값: false Delayed Job 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_DELAYED_JOB_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Delayed Job 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_DELAYED_JOB_ENABLED

타입: boolean 기본값: true Delayed Job 통합에 대한 트레이싱을 활성화해요.

ELASTICSEARCH

(5)

DD_TRACE_ELASTICSEARCH_ANALYTICS_ENABLED

타입: boolean 기본값: false Elasticsearch 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_ELASTICSEARCH_ANALYTICS_SAMPLE_RATE Elasticsearch 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ELASTICSEARCH_ENABLED

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

DD_TRACE_ELASTICSEARCH_PEER_SERVICE

타입: string Elasticsearch 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_ELASTICSEARCH_SERVICE_NAME

타입: string 기본값: elasticsearch Elasticsearch 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

ETHON

(6)

DD_TRACE_ETHON_ANALYTICS_ENABLED

타입: boolean 기본값: false Ethon 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_ETHON_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Ethon 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_ETHON_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 ethon 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_ETHON_ENABLED

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

DD_TRACE_ETHON_PEER_SERVICE

타입: string Ethon 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_ETHON_SERVICE_NAME

타입: string 기본값: ethon Ethon 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

EXCON

(7)

DD_TRACE_EXCON_ANALYTICS_ENABLED

타입: boolean 기본값: false Excon 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_EXCON_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Excon 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_EXCON_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 excon 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_EXCON_ENABLED

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

DD_TRACE_EXCON_ERROR_STATUS_CODES

타입: array 기본값: 400-599 Excon 통합이 생성한 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

DD_TRACE_EXCON_PEER_SERVICE

타입: string Excon 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_EXCON_SERVICE_NAME

타입: string 기본값: excon Excon 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

FARADAY

(7)

DD_TRACE_FARADAY_ANALYTICS_ENABLED

타입: boolean 기본값: false Faraday 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_FARADAY_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Faraday 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_FARADAY_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 faraday 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_FARADAY_ENABLED

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

DD_TRACE_FARADAY_ERROR_STATUS_CODES

타입: array 기본값: 400-599 Faraday 통합이 생성한 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

DD_TRACE_FARADAY_PEER_SERVICE

타입: string Faraday 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_FARADAY_SERVICE_NAME

타입: string 기본값: faraday Faraday 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

GRAPE

(4)

DD_TRACE_GRAPE_ANALYTICS_ENABLED

타입: boolean Grape 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_GRAPE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Grape 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_GRAPE_ENABLED

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

DD_TRACE_GRAPE_ERROR_STATUS_CODES

타입: array 기본값: 500-599 Grape 통합이 생성한 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

GRAPHQL

(6)

DD_TRACE_GRAPHQL_ANALYTICS_ENABLED

타입: boolean GraphQL 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_GRAPHQL_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 GraphQL 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_GRAPHQL_ENABLED

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

DD_TRACE_GRAPHQL_ERROR_EXTENSIONS

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

DD_TRACE_GRAPHQL_ERROR_TRACKING

타입: boolean 기본값: false Error Tracking에 GraphQL 오류를 표시해요.

DD_TRACE_GRAPHQL_WITH_UNIFIED_TRACER

타입: boolean 기본값: false Endpoints 목록을 지원하기 위해 UnifiedTrace 트레이서(graphql >= 2.2 권장)를 사용한 GraphQL 계측을 활성화해요.

GRPC

(6)

DD_TRACE_GRPC_ANALYTICS_ENABLED

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

DD_TRACE_GRPC_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_GRPC_ANALYTICS_SAMPLE_RATE gRPC 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_GRPC_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 grpc 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_GRPC_ENABLED

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

DD_TRACE_GRPC_PEER_SERVICE

타입: string gRPC 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_GRPC_SERVICE_NAME

타입: string 기본값: grpc gRPC 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

HANAMI

(1)

DD_TRACE_HANAMI_ENABLED

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

HTTP

(3)

DD_TRACE_HTTP_ANALYTICS_ENABLED

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

DD_TRACE_HTTP_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 net/http 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_HTTP_ENABLED

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

HTTPCLIENT

(7)

DD_TRACE_HTTPCLIENT_ANALYTICS_ENABLED

타입: boolean 기본값: false 별칭:DD_HTTPCLIENT_ANALYTICS_ENABLED httpclient 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_HTTPCLIENT_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_HTTPCLIENT_ANALYTICS_SAMPLE_RATE httpclient 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_HTTPCLIENT_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 httpclient 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_HTTPCLIENT_ENABLED

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

DD_TRACE_HTTPCLIENT_ERROR_STATUS_CODES

타입: array 기본값: 400-599 httpclient 통합이 생성한 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

DD_TRACE_HTTPCLIENT_PEER_SERVICE

타입: string httpclient 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_HTTPCLIENT_SERVICE_NAME

타입: string 기본값: httpclient httpclient 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

HTTPRB

(7)

DD_TRACE_HTTPRB_ANALYTICS_ENABLED

타입: boolean 기본값: false httprb 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_HTTPRB_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 httprb 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_HTTPRB_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 httprb 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_HTTPRB_ENABLED

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

DD_TRACE_HTTPRB_ERROR_STATUS_CODES

타입: string 기본값: 400-599 httprb 통합이 생성한 스팬에서 오류로 표시해야 하는 HTTP 상태 코드. 값은 범위(400...600) 또는 범위/정수 배열 [403, 500...600]일 수 있어요. 환경 변수로 구성하면 범위에는 대시('400-599'), 배열에 요소를 추가할 때는 쉼표('403,500-599')를 사용하세요.

DD_TRACE_HTTPRB_PEER_SERVICE

타입: string httprb 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_HTTPRB_SERVICE_NAME

타입: string 기본값: httprb httprb 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

KAFKA

(3)

DD_TRACE_KAFKA_ANALYTICS_ENABLED

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

DD_TRACE_KAFKA_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_KAFKA_ANALYTICS_SAMPLE_RATE Kafka 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_KAFKA_ENABLED

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

KARAFKA

(2)

DD_TRACE_KARAFKA_DISTRIBUTED_TRACING

타입: boolean 기본값: false 시작 버전: v2.30.0 활성화하면 karafka 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_KARAFKA_ENABLED

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

LOGRAGE

(1)

DD_TRACE_LOGRAGE_ENABLED

타입: boolean 기본값: true 로그 주입이 활성화될 때 Lograge 로그에 트레이스 상관관계 필드 주입을 활성화해요.

MEMCACHED_COMMAND

(1)

DD_TRACE_MEMCACHED_COMMAND_ENABLED

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

MONGO

(6)

DD_TRACE_MONGO_ANALYTICS_ENABLED

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

DD_TRACE_MONGO_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_MONGO_ANALYTICS_SAMPLE_RATE MongoDB 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_MONGO_ENABLED

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

DD_TRACE_MONGO_JSON_COMMAND

타입: boolean 기본값: false Datadog 앱에서 쿼리 인트로스펙션을 활성화하기 위해 MongoDB 명령을 스팬에서 JSON으로 직렬화해요.

DD_TRACE_MONGO_PEER_SERVICE

타입: string MongoDB 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_MONGO_SERVICE_NAME

타입: string 기본값: mongodb MongoDB 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

MYSQL2

(5)

DD_TRACE_MYSQL2_ANALYTICS_ENABLED

타입: boolean 기본값: false mysql2 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_MYSQL2_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 mysql2 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_MYSQL2_ENABLED

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

DD_TRACE_MYSQL2_PEER_SERVICE

타입: string mysql2 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_MYSQL2_SERVICE_NAME

타입: string 기본값: mysql2 mysql2 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

NET

(2)

DD_TRACE_NET_HTTP_PEER_SERVICE

타입: string net/http 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_NET_HTTP_SERVICE_NAME

타입: string 기본값: net/http net/http 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

OPENSEARCH

(6)

DD_TRACE_OPENSEARCH_ANALYTICS_ENABLED

타입: boolean 기본값: false 별칭:DD_OPENSEARCH_ANALYTICS_ENABLED OpenSearch 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_OPENSEARCH_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_OPENSEARCH_ANALYTICS_SAMPLE_RATE OpenSearch 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_OPENSEARCH_ENABLED

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

DD_TRACE_OPENSEARCH_PEER_SERVICE

타입: string OpenSearch 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_OPENSEARCH_RESOURCE_PATTERN

타입: string 기본값: absolute OpenSearch 스팬 리소스 이름이 전체 또는 상대 URL 경로를 사용하는지 제어해요.

DD_TRACE_OPENSEARCH_SERVICE_NAME

타입: string 기본값: opensearch OpenSearch 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

PG

(5)

DD_TRACE_PG_ANALYTICS_ENABLED

타입: boolean 기본값: false pg(Postgres) 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_PG_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 pg(Postgres) 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_PG_ENABLED

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

DD_TRACE_PG_PEER_SERVICE

타입: string pg(Postgres) 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_PG_SERVICE_NAME

타입: string 기본값: pg pg(Postgres) 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

PRESTO

(5)

DD_TRACE_PRESTO_ANALYTICS_ENABLED

타입: boolean 기본값: false Presto 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_PRESTO_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Presto 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_PRESTO_ENABLED

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

DD_TRACE_PRESTO_PEER_SERVICE

타입: string Presto 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_PRESTO_SERVICE_NAME

타입: string 기본값: presto Presto 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

QUE

(4)

DD_TRACE_QUE_ANALYTICS_ENABLED

타입: boolean 기본값: false Que 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_QUE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Que 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_QUE_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 que 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_QUE_ENABLED

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

QUE_TAG_ARGS

(1)

DD_TRACE_QUE_TAG_ARGS_ENABLED

타입: boolean 기본값: false 스팬에서 Que 작업의 args 필드 태깅을 활성화해요.

QUE_TAG_DATA

(1)

DD_TRACE_QUE_TAG_DATA_ENABLED

타입: boolean 기본값: false 스팬에서 Que 작업의 data 필드 태깅을 활성화해요.

RACECAR

(3)

DD_TRACE_RACECAR_ANALYTICS_ENABLED

타입: boolean 기본값: false Racecar 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_RACECAR_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Racecar 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RACECAR_ENABLED

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

RACK

(4)

DD_TRACE_RACK_ANALYTICS_ENABLED

타입: boolean Rack 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_RACK_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Rack 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RACK_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 rack 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_RACK_ENABLED

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

RAILS

(4)

DD_TRACE_RAILS_ANALYTICS_ENABLED

타입: boolean Rails 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_RAILS_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Rails 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RAILS_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 rails 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_RAILS_ENABLED

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

RAKE

(3)

DD_TRACE_RAKE_ANALYTICS_ENABLED

타입: boolean 기본값: false Rake 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_RAKE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Rake 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RAKE_ENABLED

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

REDIS

(6)

DD_REDIS_COMMAND_ARGS

타입: boolean 기본값: false 활성화하면 스팬 리소스 이름과 태그에 Redis 명령 인자를 포함해요. 그 외에는 명령 이름만 표시돼요.

DD_TRACE_REDIS_ANALYTICS_ENABLED

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

DD_TRACE_REDIS_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 별칭:DD_REDIS_ANALYTICS_SAMPLE_RATE Redis 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_REDIS_ENABLED

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

DD_TRACE_REDIS_PEER_SERVICE

타입: string Redis 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_REDIS_SERVICE_NAME

타입: string 기본값: redis Redis 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

RESQUE

(3)

DD_TRACE_RESQUE_ANALYTICS_ENABLED

타입: boolean 기본값: false Resque 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_RESQUE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Resque 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RESQUE_ENABLED

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

REST_CLIENT

(6)

DD_TRACE_REST_CLIENT_ANALYTICS_ENABLED

타입: boolean 기본값: false RestClient 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_REST_CLIENT_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 RestClient 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_REST_CLIENT_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 rest-client 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_REST_CLIENT_ENABLED

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

DD_TRACE_REST_CLIENT_PEER_SERVICE

타입: string RestClient 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_REST_CLIENT_SERVICE_NAME

타입: string 기본값: rest_client RestClient 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

RODA

(3)

DD_RODA_ANALYTICS_ENABLED

타입: boolean 기본값: false Roda 통합에 대한 애널리틱스를 활성화해요.

DD_RODA_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Roda 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_RODA_ENABLED

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

SEMANTIC_LOGGER

(1)

DD_TRACE_SEMANTIC_LOGGER_ENABLED

타입: boolean 기본값: true 로그 주입이 활성화될 때 Semantic Logger 로그에 트레이스 상관관계 필드 주입을 활성화해요.

SEQUEL

(3)

DD_TRACE_SEQUEL_ANALYTICS_ENABLED

타입: boolean 기본값: false Sequel 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SEQUEL_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Sequel 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SEQUEL_ENABLED

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

SHORYUKEN

(3)

DD_TRACE_SHORYUKEN_ANALYTICS_ENABLED

타입: boolean 기본값: false Shoryuken 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SHORYUKEN_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Shoryuken 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SHORYUKEN_ENABLED

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

SIDEKIQ

(4)

DD_TRACE_SIDEKIQ_ANALYTICS_ENABLED

타입: boolean 기본값: false Sidekiq 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SIDEKIQ_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Sidekiq 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SIDEKIQ_DISTRIBUTED_TRACING

타입: boolean 기본값: false 시작 버전: v2.30.0 활성화하면 sidekiq 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_SIDEKIQ_ENABLED

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

SINATRA

(4)

DD_TRACE_SINATRA_ANALYTICS_ENABLED

타입: boolean Sinatra 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SINATRA_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Sinatra 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SINATRA_DISTRIBUTED_TRACING

타입: boolean 기본값: true 시작 버전: v2.30.0 활성화하면 sinatra 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_SINATRA_ENABLED

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

SNEAKERS

(3)

DD_TRACE_SNEAKERS_ANALYTICS_ENABLED

타입: boolean 기본값: false Sneakers 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SNEAKERS_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Sneakers 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SNEAKERS_ENABLED

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

STRIPE

(3)

DD_TRACE_STRIPE_ANALYTICS_ENABLED

타입: boolean 기본값: false Stripe 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_STRIPE_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Stripe 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_STRIPE_ENABLED

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

SUCKER_PUNCH

(3)

DD_TRACE_SUCKER_PUNCH_ANALYTICS_ENABLED

타입: boolean 기본값: false Sucker Punch 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_SUCKER_PUNCH_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Sucker Punch 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_SUCKER_PUNCH_ENABLED

타입: boolean 기본값: true Sucker Punch 통합에 대한 트레이싱을 활성화해요.

TEST_MODE

(1)

DD_TRACE_TEST_MODE_ENABLED

타입: boolean 기본값: false 트레이서 테스트 모드를 활성화해 테스트 지향 트레이스 플러시와 라이터 동작을 사용해요.

TRILOGY

(5)

DD_TRACE_TRILOGY_ANALYTICS_ENABLED

타입: boolean 기본값: false Trilogy 통합에 대한 애널리틱스를 활성화해요.

DD_TRACE_TRILOGY_ANALYTICS_SAMPLE_RATE

타입: decimal 기본값: 1.0 Trilogy 통합이 생성한 애널리틱스 이벤트의 샘플링 비율.

DD_TRACE_TRILOGY_ENABLED

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

DD_TRACE_TRILOGY_PEER_SERVICE

타입: string Trilogy 통합이 생성한 스팬의 외부 서비스 이름.

DD_TRACE_TRILOGY_SERVICE_NAME

타입: string 기본값: trilogy Trilogy 통합이 생성한 스팬에 사용되는 서비스 이름. DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED로 재정의될 수 있어요.

WATERDROP

(2)

DD_TRACE_WATERDROP_DISTRIBUTED_TRACING

타입: boolean 기본값: false 시작 버전: v2.30.0 활성화하면 waterdrop 통합에 대한 분산 트레이싱이 활성화돼요.

DD_TRACE_WATERDROP_ENABLED

타입: boolean 기본값: true 시작 버전: v2.23.0 WaterDrop 통합에 대한 트레이싱을 활성화해요.

Database Monitoring

(2)

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

DD_DBM_INJECT_SQL_BASEHASH

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

DD_DBM_PROPAGATION_MODE

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

트레이스 로깅 (Trace Logging)

(2)

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

DD_TRACE_DEBUG

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

언어별 참고:

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

DD_TRACE_STARTUP_LOGS

타입: boolean 애플리케이션 시작 시 트레이싱을 평가하는 데 도움이 되도록 시작 구성과 진단을 로그에 출력해요.

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

(22)

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

DD_PROFILING_ALLOCATION_ENABLED

타입: boolean 기본값: false 별칭:DD_PROFILING_DDPROF_ALLOC_ENABLED true로 설정하면 할당 프로파일링(Preview)을 활성화해요. 기본값은 false예요.

DD_PROFILING_DIR_INTERRUPTION_WORKAROUND_ENABLED

타입: boolean 기본값: true 프로파일링 신호로 인한 Ruby Dir 중단 문제에 대한 해결책을 활성화해요.

DD_PROFILING_ENABLED

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

DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

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

DD_PROFILING_EXPERIMENTAL_HEAP_ENABLED

타입: boolean 기본값: false 힙 프로파일 수집(할당 프로파일링 필요)을 포함한 미리보기 힙 프로파일링을 활성화해요.

DD_PROFILING_EXPERIMENTAL_HEAP_SAMPLE_RATE

타입: int 기본값: 1 힙 프로파일링의 샘플링 비율.

DD_PROFILING_EXPERIMENTAL_HEAP_SIZE_ENABLED

타입: boolean 기본값: true 힙 프로파일링을 위한 힙 크기 프로파일 수집을 활성화해요(할당 프로파일링과 힙 프로파일링 필요).

DD_PROFILING_EXPERIMENTAL_USE_SYSTEM_DNS

타입: boolean 기본값: true 시작 버전: v2.30.0 내장 libdatadog 대신 DNS에 시스템 해석기를 사용해요.

DD_PROFILING_GC_ENABLED

타입: boolean 기본값: true 가비지 컬렉션 프로파일링을 활성화해 프로파일에 GC 활동을 수집해요.

DD_PROFILING_GVL_ENABLED

타입: boolean 기본값: true 별칭:DD_PROFILING_PREVIEW_GVL_ENABLED 스레드가 Global VM Lock을 기다리는 데 보내는 시간을 보고하는 GVL 프로파일링을 활성화해요.

DD_PROFILING_HEAP_CLEAN_AFTER_GC_ENABLED

타입: boolean 기본값: true 힙 프로파일링이 직렬화 시간뿐 아니라 가비지 컬렉션 후 정리를 수행하는지 제어해요(GC 프로파일링과 힙 프로파일링 필요).

DD_PROFILING_MAX_FRAMES

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

DD_PROFILING_NATIVE_FILENAMES_ENABLED

타입: boolean 기본값: true 프로파일러가 네이티브 코드의 스택 프레임에 네이티브 파일 이름을 사용하는지 제어해요.

DD_PROFILING_NO_SIGNALS_WORKAROUND_ENABLED

타입: boolean 일부 라이브러리에서 인터럽트 관련 문제를 피하기 위해 프로파일링 신호 의존도를 줄이는 해결책 모드를 활성화해요.

DD_PROFILING_OVERHEAD_TARGET_PERCENTAGE

타입: decimal 기본값: 2.0 프로파일링의 목표 오버헤드 백분율. 프로파일러는 이 목표 근처에 머물도록 샘플링을 조정해요.

DD_PROFILING_PREVIEW_OTEL_CONTEXT_ENABLED

타입: string 기본값: false 프로파일러가 OpenTelemetry에서 컨텍스트를 읽으려 시도하는지 제어해요.

DD_PROFILING_SHUTDOWN_ON_EXEC_ENABLED

타입: boolean 기본값: true 프로파일링 상태가 새 프로세스로 누출되는 것을 피하기 위해 exec 호출 전에 프로파일링을 중지해요.

DD_PROFILING_SIGHANDLER_SAMPLING_ENABLED

타입: boolean 기본값: true 프로파일러가 정확도 향상을 위해 신호 핸들러에서 직접 샘플링하는지 제어해요.

DD_PROFILING_SKIP_MYSQL2_CHECK

타입: boolean 기본값: false mysql2가 사용하는 libmysqlclient 버전의 프로파일러 호환성 검사를 비활성화해요.

DD_PROFILING_TIMELINE_ENABLED

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

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

언어별 참고:

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

DD_PROFILING_UPLOAD_PERIOD

타입: int 기본값: 60 프로파일링: 업로드 주기(초, 녹음 기간); 프로파일이 업로드되는 빈도를 제어해요.

DD_PROFILING_UPLOAD_TIMEOUT

타입: decimal 기본값: 30.0 프로파일러가 업로드 HTTP 요청 완료를 취소하기 전에 기다리는 최대 시간(초).

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

(27)

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

DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE

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

DD_API_SECURITY_ENABLED

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

DD_API_SECURITY_ENDPOINT_COLLECTION_ENABLED

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

DD_API_SECURITY_MAX_DOWNSTREAM_BODY_BYTES

타입: int 기본값: 10485760 시작 버전: v2.37.0 트레이서가 버퍼링할 다운스트림 HTTP 응답 본문의 최대 크기(바이트). 이 한도를 초과하는 본문은 읽히거나 메모리에 유지되지 않아요.

DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS

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

DD_API_SECURITY_REQUEST_SAMPLE_RATE

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

DD_APPSEC_AGENTIC_ONBOARDING

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

DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE

타입: string 기본값: identification 사용자 이벤트가 수집되는 방식을 제어하는 AppSec 자동 사용자 계측 모드를 선택해요.

DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING

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

DD_APPSEC_BODY_PARSING_SIZE_LIMIT

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

DD_APPSEC_ENABLED

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

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_HTML

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

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_JSON

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

DD_APPSEC_HTTP_BLOCKED_TEMPLATE_TEXT

타입: string 일반 텍스트가 선택된 형식일 때 차단된 요청 응답에 사용되는 일반 텍스트 템플릿 파일 경로. 설정하지 않으면 트레이서는 기본 텍스트 템플릿을 사용하거나 JSON/HTML 기본 동작으로 대체돼요.

DD_APPSEC_MAX_STACK_TRACE_DEPTH

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

DD_APPSEC_MAX_STACK_TRACE_DEPTH_TOP_PERCENT

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

DD_APPSEC_MAX_STACK_TRACES

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

DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP

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*"[^"]+")|bearer\s+[a-z0-9\._\-]+|token:[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,} 매개변수 값과 하이라이트 내부의 민감한 하위 문자열을 찾아 편집하는 데 사용되는 정규식이에요. 일치 항목은 <redacted by datadog>로 대체돼요. 이 정규식은 키 정규식을 보완해요: 키 정규식이 우선하고, 키 일치가 없으면 값 정규식이 실행돼요. 기본 패턴은 토큰, JWT, 개인 키 블록 및 기타 자격 증명 형태를 대상으로 해요. 빈 문자열은 값 정규식을 비활성화해요.

DD_APPSEC_RASP_ENABLED

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

DD_APPSEC_RULES

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

DD_APPSEC_SCA_ENABLED

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

DD_APPSEC_STACK_TRACE_ENABLED

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

DD_APPSEC_TRACE_RATE_LIMIT

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

DD_APPSEC_WAF_TIMEOUT

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

DD_ERROR_TRACKING_HANDLED_ERRORS

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

DD_ERROR_TRACKING_HANDLED_ERRORS_INCLUDE

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

Dynamic Instrumentation 및 디버깅

(7)

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

DD_DYNAMIC_INSTRUMENTATION_ENABLED

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

DD_DYNAMIC_INSTRUMENTATION_MAX_TIME_TO_SERIALIZE

타입: int 기본값: 200 시작 버전: v2.38.0 프로브 스냅샷에 대한 직렬화 실행의 최대 기간(밀리초).

DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE

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

DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS

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

DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES

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

DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS

타입: array 기본값: [] 시작 버전: v2.28.0 기본 편집 목록에서 제외할 식별자 키워드의 쉼표 구분 목록. 비밀번호 같은 일반 키워드가 사용 사례에서 민감한 것으로 취급되는 것을 방지하는 데 유용해요.

DD_SYMBOL_DATABASE_UPLOAD_ENABLED

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

CI 가시성 (CI Visibility)

(2)

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

DD_GIT_COMMIT_SHA

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

DD_GIT_REPOSITORY_URL

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

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

(1)

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

DD_CRASHTRACKING_ENABLED

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

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

(2)

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

DD_LOGS_INJECTION

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

언어별 참고:

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

DD_LOGS_OTEL_ENABLED

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

런타임 메트릭 (Runtime Metrics)

(5)

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

DD_HEALTH_METRICS_ENABLED

타입: boolean 기본값: false 헬스 메트릭 수집을 활성화해요.

DD_METRIC_AGENT_PORT

타입: int 기본값: 8125 이 라이브러리가 메트릭을 보내는 Datadog Agent StatsD 엔드포인트의 포트.

DD_RUNTIME_METRICS_ENABLED

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

DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED

타입: boolean 기본값: false 별칭:DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED 활성화하면 개별 프로세스를 구분하기 위해 런타임 메트릭에 runtime-id 태그를 추가해요.

DD_TRACE_EXPERIMENTAL_RUNTIME_ID_ENABLED

타입: boolean 기본값: false 런타임 메트릭에 runtime-id 태그 추가를 활성화해요(실험). DD_RUNTIME_METRICS_RUNTIME_ID_ENABLED의 별칭.

Data Streams Monitoring

(1)

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

DD_DATA_STREAMS_ENABLED

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

계측 텔레메트리 (Instrumentation Telemetry)

(6)

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

DD_INSTRUMENTATION_TELEMETRY_ENABLED

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

DD_TELEMETRY_AGENTLESS_URL

타입: string 에이전트리스 텔레메트리 인테이크 URL을 재정의해요.

DD_TELEMETRY_DEPENDENCY_COLLECTION_ENABLED

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

DD_TELEMETRY_LOG_COLLECTION_ENABLED

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

DD_TELEMETRY_METRICS_AGGREGATION_INTERVAL

타입: decimal 기본값: 10.0 계측 텔레메트리 메트릭이 전송되기 전에 집계되는 간격.

DD_TELEMETRY_METRICS_ENABLED

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

원격 구성 (Remote Configuration)

(2)

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

DD_REMOTE_CONFIG_BOOT_TIMEOUT_SECONDS

타입: decimal 기본값: 1.0 Remote Configuration의 시작 타임아웃. 초과하면 애플리케이션이 로컬 구성을 사용해 진행돼요.

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.23.0 OpenTelemetry 메트릭 내보내기를 활성화해요. 메트릭은 기본적으로 비활성화되어 있으며 참값으로 설정된 경우에만 활성화돼요.

OTEL_BLRP_EXPORT_TIMEOUT

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

OTEL_BLRP_MAX_EXPORT_BATCH_SIZE

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

OTEL_BLRP_MAX_QUEUE_SIZE

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

OTEL_BLRP_SCHEDULE_DELAY

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

OTEL_EXPORTER_OTLP_ENDPOINT

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

OTEL_EXPORTER_OTLP_HEADERS

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

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

타입: string 시작 버전: v2.34.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

타입: map 시작 버전: v2.34.0 별칭:OTEL_EXPORTER_OTLP_HEADERS 모든 나가는 OTLP 로그에 적용할 헤더 맵.

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

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

OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

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

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

타입: string 시작 버전: v2.23.0 별칭: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

타입: map 시작 버전: v2.23.0 나가는 OTLP 메트릭 요청의 헤더로 사용할 키-값 쌍의 쉼표 구분 목록을 지정해요(예: api-key=key,other-config=value). 일반 OTEL_EXPORTER_OTLP_HEADERS보다 우선해요.

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

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

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE

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

OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

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

OTEL_EXPORTER_OTLP_PROTOCOL

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

OTEL_EXPORTER_OTLP_TIMEOUT

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

OTEL_LOG_LEVEL

타입: boolean 기본값: false debug로 설정하면 자세한 트레이서 로그(프로덕션 또는 민감한 환경에는 권장되지 않음)를 생성하는 디버그 모드를 활성화해요. DD_TRACE_DEBUG의 별칭.

OTEL_LOGS_EXPORTER

타입: string 기본값: otlp 시작 버전: v2.34.0 OTLP 로그 내보내기를 지원하는 Datadog SDK는 otlp를 기본값으로 해야 하고, 그 외에는 모두 None/null을 기본값으로 해야 해요.

OTEL_METRIC_EXPORT_INTERVAL

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

OTEL_METRIC_EXPORT_TIMEOUT

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

OTEL_METRICS_EXPORTER

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

OTEL_PROPAGATORS

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

OTEL_RESOURCE_ATTRIBUTES

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

OTEL_SERVICE_NAME

타입: string 기본값: ruby 트레이스의 service 태그로 설정되는 애플리케이션의 기본 서비스 이름이에요. DD_SERVICE의 별칭.

OTEL_TRACES_EXPORTER

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

OTEL_TRACES_SAMPLER

타입: decimal 유지되는 트레이스의 비율을 제어하는 트레이스 샘플링 비율을 설정해요. DD_TRACE_SAMPLE_RATE의 별칭.

OTEL_TRACES_SAMPLER_ARG

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

AI 및 LLM Observability

(5)

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

DD_AI_GUARD_ENABLED

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

DD_AI_GUARD_ENDPOINT

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

DD_AI_GUARD_MAX_CONTENT_SIZE

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

DD_AI_GUARD_MAX_MESSAGES_LENGTH

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

DD_AI_GUARD_TIMEOUT

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

계측 및 플랫폼 (Instrumentation & Platform)

(1)

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

DD_INJECT_FORCE

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

기타 (Miscellaneous)

(2)

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_SPAN_ENRICHMENT_ENABLED

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