.NET Framework SDK 구성 (Configuring the .NET Framework SDK)

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

출처: 문서

본문

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

.NET Tracer에서 구성 설정을 지정하는 방법은 다음과 같아요.

환경 변수로 SDK를 구성하려면 계측된 애플리케이션을 실행하기 전에 변수를 설정하세요. 다양한 환경에서 환경 변수를 설정하는 방법은 프로세스 환경 변수 구성을 참고하세요.

애플리케이션 코드에서 Tracer를 구성하려면 기본 구성 소스에서 TracerSettings 인스턴스를 만드세요. Tracer.Configure()를 호출하기 전에 이 TracerSettings 인스턴스에서 속성을 설정하세요. 예:

TracerSettings 속성은 Tracer를 만들기 전에 설정해야 해요. Tracer가 생성된 후 TracerSettings 속성을 변경하면 무시돼요.

using Datadog.Trace;
using Datadog.Trace.Configuration;

// read default configuration sources (env vars, web.config, datadog.json)
var settings = TracerSettings.FromDefaultSources();

// change some settings
settings.Environment = "prod";
settings.ServiceName = "MyService";
settings.ServiceVersion = "abc123";
// In v2 of Datadog.Trace, use settings.Exporter.AgentUri
settings.AgentUri = new Uri("http://localhost:8126/");

// configure the global Tracer settings
Tracer.Configure(settings);

app.config 또는 web.config 파일로 Tracer를 구성하려면 <appSettings> 섹션을 사용하세요. 예:

<configuration>
  <appSettings>
    <add key="DD_TRACE_AGENT_URL" value="http://localhost:8126"/>
    <add key="DD_ENV" value="prod"/>
    <add key="DD_SERVICE" value="MyService"/>
    <add key="DD_VERSION" value="abc123"/>
  </appSettings>
</configuration>

JSON 파일로 Tracer를 구성하려면 계측된 애플리케이션의 디렉터리에 datadog.json을 만드세요. 루트 JSON 객체는 각 설정에 대한 키-값 쌍이 있는 객체여야 해요. 예:

{
  "DD_TRACE_AGENT_URL": "http://localhost:8126",
  "DD_ENV": "prod",
  "DD_SERVICE": "MyService",
  "DD_VERSION": "abc123",
}

구성 키 (Configuration keys)

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

일반 설정 (General Settings)

(18)

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

DD_AGENT_HOST

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

DD_API_KEY

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

DD_APM_RECEIVER_PORT

타입: int 기본값: 8126 Trace Agent에 대해 특정 포트 바인딩을 강제하는 데 사용돼요. 기본값은 8126이에요.

DD_APM_TRACING_ENABLED

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

DD_ENV

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

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE

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

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_BASE_URL

타입: string 시작 버전: v3.53.0 에이전트리스 구성 소스의 사용자 지정 기본 URL.

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_POLL_INTERVAL_SECONDS

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

DD_FEATURE_FLAGS_CONFIGURATION_SOURCE_AGENTLESS_REQUEST_TIMEOUT_SECONDS

타입: int 기본값: 5 시작 버전: v3.53.0 에이전트리스 모드에서 구성 소스의 요청 타임아웃.

DD_FEATURE_FLAGS_ENABLED

타입: boolean 기본값: true 시작 버전: v3.53.0 전역 Feature Flags 킬 스위치예요. false로 설정하면 공급자, CDN 폴링, Feature Flags RC 구독이 비활성화돼요. true로 설정하면 소스 해석을 허용하지만 트래픽을 독립적으로 시작하지는 않아요.

DD_HOSTNAME

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

DD_PROXY_HTTPS

타입: string CI Visibility용 https 요청에 대한 프록시 서버를 설정하는 구성 키예요.

DD_PROXY_NO_PROXY

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

DD_SERVICE

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

언어별 참고:

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

DD_SITE

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

DD_TAGS

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

DD_TRACE_CONFIG_FILE

타입: string 기본값: datadog.json 별칭:DD_DOTNET_TRACER_CONFIG_FILE 구성 파일 경로. 환경 변수 또는 앱.config/web.config 파일에서만 설정할 수 있어요.

DD_VERSION

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

트레이싱 코어 (Tracing Core)

(36)

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

DD_APM_RECEIVER_SOCKET

타입: string 트레이서가 트레이스를 보낼 수 있는 Unix 도메인 소켓. 기본값은 null이에요.

DD_HTTP_CLIENT_ERROR_STATUSES

타입: string 기본값: 400-499 시작 버전: v3.51.0 스팬을 오류로 표시하는 클라이언트 HTTP 상태 코드. DD_TRACE_OTEL_SEMANTICS_ENABLED가 true이면 기본값은 400-599이에요.

DD_HTTP_SERVER_ERROR_STATUSES

타입: string 기본값: 500-599 스팬을 오류로 표시하는 서버 HTTP 상태 코드.

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_ARGS

타입: string Azure App Services: 외부 trace-agent 프로세스를 시작할 때 사용하는 추가 명령줄 인자(공백/쉼표 구분). 설정하지 않으면 추가 인자가 전달되지 않아요.

DD_TRACE_AGENT_PATH

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

DD_TRACE_AGENT_PORT

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

DD_TRACE_AGENT_URL

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

DD_TRACE_ANALYTICS_ENABLED

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

DD_TRACE_BATCH_INTERVAL

타입: int 기본값: 100 직렬화 큐의 배치 간격을 밀리초 단위로 설정해요. 비활성화하려면 0으로 설정하세요.

DD_TRACE_BUFFER_SIZE

타입: int 기본값: 10485760 내부 dd-trace-dotnet 스팬 버퍼 구성이에요. 트레이스 버퍼의 크기를 바이트 단위로 설정해요.

DD_TRACE_CLIENT_IP_ENABLED

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

DD_TRACE_CLIENT_IP_HEADER

타입: string 별칭:DD_APPSEC_IPHEADER 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_EXPERIMENTAL_FEATURES_ENABLED

타입: string 실험적 기능을 활성화하는 구성 키예요.

DD_TRACE_METHODS

타입: string 지정된 메서드에 대한 자동 계측을 활성화해요. 각 항목이 Namespace.TypeName[MethodNames] 형식인 세미콜론(;) 구분 목록을 받아요. 여기서 MethodNames는 쉼표(,) 구분 메서드 이름 목록 또는 * 와일드카드예요.

제네릭 타입의 경우 꺾쇠 괄호와 타입 매개변수 이름을 백틱(`)과 제네릭 타입 매개변수 수로 바꾸세요. 예를 들어 Dictionary<TKey, TValue>는 Dictionary`2로 작성해야 해요. 제네릭 메서드의 경우 메서드 이름만 지정하세요. 예시: Namespace1.Class1[Method1,GenericMethod];Namespace1.GenericTypeWithOneTypeVariable`1[ExecuteAsync];Namespace2.Class2[*] 참고: 와일드카드 메서드 지원([*])은 생성자, 속성 getter/setter, Equals, Finalize, GetHashCode, ToString을 제외한 타입의 모든 메서드를 선택해요.

DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP

타입: string 기본값: (?:(?:\"|%22)?)(?:(?:old[-_]?|new[-_]?)?p(?:ass)?w(?:or)?d(?:1|2)?|pass(?:[-_]?phrase)?|secret|(?:api[-_]?|private[-_]?|public[-_]?|access[-_]?|secret[-_]?|app(?:lication)?[-_]?)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(?:-{5})?(?:\n|%0A)?|(?:ssh-(?:rsa|dss)|ecdsa-[a-z0-9]+-[a-z0-9]+)(?:\s|%20|%09)+(?:[a-z0-9/.+]|%2F|%5C|%2B){100,}(?:=|%3D)*(?:(?:\s|%20|%09)+[a-z0-9._-]+)?) 들어오는 HTTP 요청의 쿼리 문자열에서 민감한 데이터를 편집하기 위해 정규식을 적용해요. 기본 정규식은 비밀번호, 토큰, API 키, 개인 키, 인증 용어 등 다양한 민감 데이터 패턴을 매칭해요. 매칭된 항목은 <redacted>로 대체돼요. 빈 문자열이 전달되면 난독화가 발생하지 않아요. 결과 값은 http.url 태그에 보고돼요.

DD_TRACE_OBFUSCATION_QUERY_STRING_REGEXP_TIMEOUT

타입: decimal 기본값: 200 쿼리 문자열 난독화 정규식 실행의 타임아웃을 밀리초 단위로 설정해요. 기본값은 200ms예요.

DD_TRACE_PARTIAL_FLUSH_ENABLED

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

DD_TRACE_PARTIAL_FLUSH_MIN_SPANS

타입: int 기본값: 500 트레이스를 부분적으로 내보내기 전 스팬 수예요. 매우 큰 트레이스의 모든 스팬을 메모리에 유지하지 않도록 방지해요.

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_PIPE_NAME

타입: string Datadog Agent 명명 파이프: Datadog Agent와 통신할 때 TCP나 Unix 도메인 소켓 대신 HTTP 전송으로 사용되는 Windows 명명 파이프 이름/경로를 설정해요. 설정하면 트레이서의 HTTP 클라이언트가 NamedPipe 소켓 팩토리를 사용해요. 기본값: 미설정.

DD_TRACE_PIPE_TIMEOUT_MS

타입: int 기본값: 500 명명 파이프 통신의 타임아웃을 밀리초 단위로 설정해요. 기본값은 0이에요.

DD_TRACE_REMOVE_INTEGRATION_SERVICE_NAMES_ENABLED

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

DD_TRACE_SERVICE_MAPPING

타입: string 구성 매핑을 사용해 서비스를 이름 변경해요. [from-key]:[to-name] 형식의 키-값 쌍의 쉼표 구분 목록을 받아요.

예시: mysql:main-mysql-db, mongodb:offsite-mongodb-service

from-key 값은 통합 타입마다 다르며 애플리케이션 이름 접두사를 제외해야 해요. 예를 들어 my-application-sql-server를 main-db로 이름 변경하려면 sql-server:main-db를 사용하세요.

DD_TRACE_SPAN_ATTRIBUTE_SCHEMA

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

DD_TRACE_STATS_ADDITIONAL_TAGS

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

DD_TRACE_STATS_ADDITIONAL_TAGS_CARDINALITY_LIMIT

타입: int 기본값: 100 시작 버전: v3.49.0 클라이언트 측 통계가 활성화될 때 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'additional_tags' 필드에 대한 최대 카디널리티를 정의해요. 필드의 카디널리티를 초과하게 하는 스팬이 닫히면 필드는 대신 'tracer_blocked_value'로 대체돼요. 해당 필드의 모든 이후 새 값은 동일한 차단 값을 받아요. 이 키당 카디널리티 한도는 전체 키 카디널리티 한도에 추가로 적용돼요.

DD_TRACE_STATS_CARDINALITY_LIMIT

타입: int 기본값: 2048 시작 버전: v3.49.0 클라이언트 측 통계가 활성화될 때 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 최대 카디널리티를 정의해요. 카디널리티 임계값을 초과하게 하는 스팬이 닫히면 오버플로 버킷으로 축소돼요. 이 전체 키 카디널리티 한도는 필드별 카디널리티 한도에 추가로 적용돼요.

DD_TRACE_STATS_COMPUTATION_ENABLED

타입: boolean 기본값: false 트레이서에서 stats 페이로드 생성과 수집 측 메트릭을 위한 트레이스 통계 계산을 활성화해요.

DD_TRACE_STATS_HTTP_ENDPOINT_CARDINALITY_LIMIT

타입: int 기본값: 512 시작 버전: v3.49.0 클라이언트 측 통계가 활성화될 때 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'HTTP_endpoint' 필드에 대한 최대 카디널리티를 정의해요. 필드의 카디널리티를 초과하게 하는 스팬이 닫히면 필드는 대신 'tracer_blocked_value'로 대체돼요. 이 키당 카디널리티 한도는 전체 키 카디널리티 한도에 추가로 적용돼요.

DD_TRACE_STATS_PEER_TAGS_CARDINALITY_LIMIT

타입: int 기본값: 512 시작 버전: v3.49.0 클라이언트 측 통계가 활성화될 때 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'peer_tags' 필드에 대한 최대 카디널리티를 정의해요. 이 키당 카디널리티 한도는 전체 키 카디널리티 한도에 추가로 적용돼요.

DD_TRACE_STATS_RESOURCE_CARDINALITY_LIMIT

타입: int 기본값: 1024 시작 버전: v3.49.0 클라이언트 측 통계가 활성화될 때 단일 플러시 기간 동안 스팬에서 계산된 APM 메트릭의 'resource' 필드에 대한 최대 카디널리티를 정의해요. 이 키당 카디널리티 한도는 전체 키 카디널리티 한도에 추가로 적용돼요.

DD_TRACE_X_DATADOG_TAGS_MAX_LENGTH

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

트레이스 샘플링 (Trace Sampling)

(7)

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

DD_APM_ENABLE_RARE_SAMPLER

타입: boolean 기본값: false Datadog Agent에서 희소 트레이스 샘플링을 활성화해요. 활성화하면 Agent가 헤드 기반 샘플링에서 유지되지 않은 "희소" 트레이스를 소량(Agent당 초당 최대 5개) 유지할 수 있어요.

DD_MAX_TRACES_PER_SECOND

타입: int 기본값: 100 초당 제출할 수 있는 최대 트레이스 수.

DD_SPAN_SAMPLING_RULES

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

DD_TRACE_RATE_LIMIT

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

DD_TRACE_SAMPLE_RATE

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

DD_TRACE_SAMPLING_RULES

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

예시:

• 모든 트레이스의 20% 샘플링: [{"sample_rate": 0.2}]

• 서비스 이름이 a로 시작하고 운영 이름이 b인 트레이스의 10%, 나머지의 20% 샘플링: [{"service": "a.*", "name": "b", "sample_rate": 0.1}, {"sample_rate": 0.2}]

• 리소스 이름 HTTP GET 트레이스의 40% 샘플링: [{"resource": "HTTP GET", "sample_rate": 0.4}]

• 태그 tier=premium 트레이스의 100% 샘플링: [{"tags": {"tier": "premium"}, "sample_rate": 1}]

• 서비스 my-service와 운영 이름 http.request에 대해 50% 비율로 초당 최대 50 트레이스 샘플링: [{"service": "my-service", "name": "http.request", "sample_rate": 0.5, "max_per_second": 50}]

DD_TRACE_SAMPLING_RULES_FORMAT

타입: string 기본값: glob 사용자 지정 샘플링 규칙의 형식을 설정해요. 유효한 값은 regex 또는 glob이에요. 값이 인식되지 않으면 트레이스 샘플링 규칙이 비활성화돼요.

트레이스 전파 (Trace Propagation)

(15)

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

DD_EXPERIMENTAL_PROPAGATE_PROCESS_TAGS_ENABLED

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

DD_HTTP_SERVER_TAG_QUERY_STRING

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

DD_HTTP_SERVER_TAG_QUERY_STRING_SIZE

타입: int 기본값: 5000 난독화 전에 보고할 쿼리 문자열의 최대 크기. 기본값은 5000이에요. 값 0은 크기 제한이 없음을 의미해요.

DD_TRACE_BAGGAGE_MAX_BYTES

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

DD_TRACE_BAGGAGE_MAX_ITEMS

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

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

DD_TRACE_HTTP_CLIENT_EXCLUDED_URL_SUBSTRINGS

타입: string 트레이서가 건너뛰는 URL을 지정해요.

DD_TRACE_HTTP_SERVER_ERROR_STATUSES

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

DD_TRACE_INFERRED_PROXY_SERVICES_ENABLED

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

DD_TRACE_PROPAGATION_BEHAVIOR_EXTRACT

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

DD_TRACE_PROPAGATION_EXTRACT_FIRST

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

DD_TRACE_PROPAGATION_STYLE_EXTRACT

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

DD_TRACE_PROPAGATION_STYLE_INJECT

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

트레이스 통합 (Trace Integrations)

(23)

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

일반 통합 설정 (General Integration Settings)

DD_DIAGNOSTIC_SOURCE_ENABLED

타입: boolean 기본값: true System.Diagnostics.DiagnosticSource 사용을 활성화하여, 레거시 System.Diagnostics.DiagnosticSource 하위 시스템으로 자체 계측하는 라이브러리로부터 스팬을 받을 수 있게 해요. 기본값은 true(활성화)예요.

DD_DISABLED_INTEGRATIONS

타입: string 비활성화할 통합 목록이에요. 다른 모든 통합은 활성화된 채 유지돼요. 기본값은 비어 있음(모든 통합 활성화)이에요. 세미콜론으로 구분된 여러 값을 지원해요. 여러 개의 DD_{INTEGRATION_NAME}_ENABLED=false를 두는 대안이에요.

DD_TRACE_DISABLED_ACTIVITY_SOURCES

타입: string 비활성화할 ActivitySource 이름 목록(글로빙 지원)을 지정해요. 기본값은 비어 있음(모든 ActivitySource가 기본적으로 구독됨)이에요. ActivitySource를 비활성화하면 해당 Activity가 트레이스 컨텍스트 전파에 사용되는 경우 분산 트레이싱이 깨질 수 있어요. 쉼표로 구분된 여러 값을 지원해요. 예: "SomeGlob.*.PatternSource,Some.Specific.Source". 트레이서가 ActivitySource를 구독하지 않으면 해당 Activity의 트레이스 컨텍스트를 전파하지 않아요(더 이상 보지 않기 때문). 이는 컨텍스트 전파에 이러한 Activity에 의존하는 분산 트레이싱 흐름이 깨져 연결이 끊긴 트레이스가 발생할 수 있음을 의미해요. 분산 트레이싱에 미치는 잠재적 영향: 서비스 A -> 무시된 Activity -> 서비스 B: 서비스 A를 루트로, 서비스 B를 자식으로 하는 단일 트레이스 생성. 서비스 A -> 비활성화된 Activity -> 서비스 B: 서비스 A와 B가 각각 루트 스팬인 두 개의 별도 트레이스 생성.

DD_TRACE_DISABLED_ADONET_COMMAND_TYPES

타입: string 기본값: InterceptableDbCommand,ProfiledDbCommand 스팬을 만들지 않아야 할 ADO.NET CommandType 이름의 쉼표 구분 목록이에요. InterceptableDbCommand와 ProfiledDbCommand는 기본적으로 항상 비활성화돼요.

구성 종류 (Configuration Kinds)

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

DD_TRACE_<INTEGRATION>_ENABLED

(16개 통합)

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

사용 가능한 통합:ANNOTATIONS, AZURE_EVENTHUBS_BATCH_LINKS, AZURE_SERVICEBUS_BATCH_LINKS, BYPASS_HTTP_REQUEST_URL_CACHING, COMMANDS_COLLECTION, DELAY_WCF_INSTRUMENTATION, EXPAND_ROUTE_TEMPLATES, HEADER_TAG_NORMALIZATION_FIX, INJECT_CONTEXT_INTO_STORED_PROCEDURES, KAFKA_CREATE_CONSUMER_SCOPE, LOG_BUFFERING, METRICS, ROUTE_TEMPLATE_RESOURCE_NAMES, SINGLE_SPAN_ASPNETCORE, WCF_RESOURCE_OBFUSCATION, WCF_WEB_HTTP_RESOURCE_NAMES

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

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

ANNOTATIONS

(1)

DD_TRACE_ANNOTATIONS_ENABLED

타입: boolean 기본값: true 시작 버전: v3.47.0 네이티브 트레이서가 [Trace] 특성 계측을 적용하는지 제어해요. 기본값은 true예요.

AWS

(1)

DD_TRACE_AWS_ADD_SPAN_POINTERS

타입: boolean 기본값: true AWS 요청에 대한 스팬 포인터를 활성화하거나 비활성화해요. 기본값은 true예요.

AZURE_EVENTHUBS_BATCH_LINKS

(1)

DD_TRACE_AZURE_EVENTHUBS_BATCH_LINKS_ENABLED

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

AZURE_SERVICEBUS_BATCH_LINKS

(1)

DD_TRACE_AZURE_SERVICEBUS_BATCH_LINKS_ENABLED

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

BYPASS_HTTP_REQUEST_URL_CACHING

(1)

DD_TRACE_BYPASS_HTTP_REQUEST_URL_CACHING_ENABLED

타입: boolean 기본값: false 활성화하면 URL 캐싱 동작을 트리거하지 않도록 캐시된 HttpRequest.Url 값을 사용하지 않고 요청 URL을 구성해요. URL을 일찍 캐싱하면 애플리케이션 동작에 영향을 줄 수 있는 환경에서 문제를 방지할 수 있어요.

COMMANDS_COLLECTION

(1)

DD_TRACE_COMMANDS_COLLECTION_ENABLED

타입: boolean 기본값: false 프로세스 실행 계측을 위해 명령줄 세부 정보를 수집하는지 제어해요. 활성화하면 실행 파일과 인자가 캡처될 수 있고(필요에 따라 잘림), 비활성화하면 명령줄 세부 정보가 생략돼요.

DELAY_WCF_INSTRUMENTATION

(1)

DD_TRACE_DELAY_WCF_INSTRUMENTATION_ENABLED

타입: boolean 기본값: true WCF 서버 예외 처리가 확립된 WCF 파이프라인의 더 나중 단계까지 실행을 지연시키는 업데이트된 WCF 계측을 활성화해요.

EXPAND_ROUTE_TEMPLATES

(1)

DD_TRACE_EXPAND_ROUTE_TEMPLATES_ENABLED

타입: boolean 기본값: false ASP.NET 및 ASP.NET Core 리소스 이름의 라우트 매개변수를 실제 값으로 확장해요(ID 매개변수 제외). 매개변수 이름이 폼 값이나 슬러그를 구분하는 경우(예: GraphQL) 유용해요. 라우트 템플릿 리소스 이름이 활성화된 경우에만 적용돼요.

GRAPHQL

(1)

DD_TRACE_GRAPHQL_ERROR_EXTENSIONS

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

GRPC

(1)

DD_TRACE_GRPC_TAGS

타입: string GRPC 메타데이터 키를 태그 이름에 매핑해요. GRPC 메타데이터 값을 트레이스의 태그로 자동 적용해요.

HEADER_TAG_NORMALIZATION_FIX

(1)

DD_TRACE_HEADER_TAG_NORMALIZATION_FIX_ENABLED

타입: boolean 기본값: true 헤더 태그 정규화 수정을 활성화해요. 이전에는 사용자 구성에 지정된 경우에도 태그 이름을 정규화했지만, 그러면 안 됐어요. 기본값은 true예요.

INJECT_CONTEXT_INTO_STORED_PROCEDURES

(1)

DD_TRACE_INJECT_CONTEXT_INTO_STORED_PROCEDURES_ENABLED

타입: boolean 기본값: false 저장 프로시저에 Datadog 트레이스 컨텍스트 주입을 활성화해요. 기본값은 false(비활성화)예요. 활성화하면 다음 요구사항이 충족될 때 개별 저장 프로시저 호출에 Datadog 트레이스 컨텍스트가 주입돼요: - 데이터베이스가 Microsoft SQL Server이고 TracerSettings.DbmPropagationMode가 service 또는 full로 설정됨. - 저장 프로시저 호출에 Output, InputOutput, Return ADO.NET 명령 매개변수가 없음.

KAFKA_CREATE_CONSUMER_SCOPE

(1)

DD_TRACE_KAFKA_CREATE_CONSUMER_SCOPE_ENABLED

타입: boolean 기본값: true Kafka 소비자 스팬의 동작을 변경해요.

true(기본값)일 때 소비자 스팬은 메시지가 소비될 때 생성되고 다음 메시지를 소비하기 전에 닫혀요. 스팬 기간은 두 연속 메시지 소비 사이의 계산을 나타내요. 메시지 소비가 루프에서 수행될 때 이 설정을 사용하세요.

false일 때 소비자 스팬은 메시지가 소비될 때 생성되고 즉시 닫혀요. 메시지가 다음 메시지를 소비하기 전에 완전히 처리되지 않을 때, 또는 여러 메시지를 한 번에 소비할 때 이 설정을 사용하세요. 이 설정에서는 하위 스팬을 위해 컨텍스트를 수동으로 추출해야 해요.

LOG_BUFFERING

(1)

DD_TRACE_LOG_BUFFERING_ENABLED

타입: boolean 기본값: false 시작 버전: v3.47.0 네이티브 로더에서 로그 출력 버퍼링을 제어해요. Windows 단일 단계 계측(SSI) 아래에서만 관련돼요. SSI 내부에서는 유효 기본값이 true(버퍼링됨)이고, SSI 외부에서는 이 설정과 관계없이 버퍼링이 항상 비활성화돼요.

METRICS

(1)

DD_TRACE_METRICS_ENABLED

타입: boolean 기본값: false DogStatsD로 전송되는 내부 메트릭을 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.

ROUTE_TEMPLATE_RESOURCE_NAMES

(1)

DD_TRACE_ROUTE_TEMPLATE_RESOURCE_NAMES_ENABLED

타입: boolean 기본값: true Dotnet 웹 서버 계측. 기능 플래그: aspnet.request, aspnet-mvc.request, aspnet-webapi.request, aspnet_core.request 스팬에서 업데이트된 리소스 이름을 활성화해요. aspnet_core_mvc.request 스팬과 aspnet_core.request 스팬의 추가 기능을 활성화해요.

SINGLE_SPAN_ASPNETCORE

(1)

DD_TRACE_SINGLE_SPAN_ASPNETCORE_ENABLED

타입: boolean 기본값: false Dotnet 웹 서버 계측. aspnet_core.request 스팬만 만들어 핸들러 스팬을 만들거나 특정 라우트 값을 추적하지 않고 ASP.NET Core 통합에서 단일 스팬만 생성하도록 해요. DD_TRACE_ROUTE_TEMPLATE_RESOURCE_NAMES_ENABLED와 호환되지 않으며(그 값은 무시됨), DD_TRACE_EXPAND_ROUTE_TEMPLATES_ENABLED와는 함께 사용할 수 있어요. .NET 6+에서만 지원돼요.

WCF_RESOURCE_OBFUSCATION

(1)

DD_TRACE_WCF_RESOURCE_OBFUSCATION_ENABLED

타입: boolean 기본값: true 스팬의 resourceName에 들어가는 WCF 요청의 LocalPath를 난독화하는 기능 플래그예요. 참고: WCF 액션이 빈 문자열일 때만 적용돼요.

WCF_WEB_HTTP_RESOURCE_NAMES

(1)

DD_TRACE_WCF_WEB_HTTP_RESOURCE_NAMES_ENABLED

타입: boolean 기본값: true WCF Web HTTP 사용 시 향상된 템플릿 기반 리소스 이름을 활성화하거나 비활성화하는 구성 키예요. 지연된 WCF 계측이 활성화되어야 해요. 기본적으로 활성화돼요.

폐기된 키 (Retired keys)

(1)

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

DD_TRACE_DATA_PIPELINE_ENABLED

v3.46.0에서 제거됨. 타입: boolean 기본값: false libdatadog 데이터 파이프라인을 사용해 트레이스를 전송해요. 기본값은 false(비활성화)예요.

Database Monitoring

(2)

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

DD_DBM_INJECT_SQL_BASEHASH

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

DD_DBM_PROPAGATION_MODE

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

트레이스 로깅 (Trace Logging)

(9)

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

DD_LOG_LEVEL

타입: string Datadog 로깅 수준을 설정해요. 유효한 값은 trace, debug, info, warn, error, critical, off예요.

DD_MAX_LOGFILE_SIZE

타입: int 기본값: 10485760 Tracer 로그 파일의 대략적인 최대 크기(바이트). 기본값은 10MB예요.

DD_TRACE_DEBUG

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

언어별 참고:

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

DD_TRACE_LOG_DIRECTORY

타입: string 기본값: /var/log/datadog/dotnet .NET Tracer 로그의 디렉터리를 설정해요. 설정되면 Datadog.Trace.Configuration.ConfigurationKeys.TraceLogPath의 값을 재정의해요. 기본값은 Windows에서는 %ProgramData%\Datadog .NET Tracer\logs, Linux에서는 /var/log/datadog/dotnet/이에요.

DD_TRACE_LOG_PATH

타입: string 더 이상 사용되지 않음. DD_TRACE_LOG_DIRECTORY를 사용하되 파일 경로가 아닌 디렉터리인지 확인하세요.

DD_TRACE_LOG_SINKS

타입: string 기본값: file 내부 진단 로그를 기록할 위치를 지정해요. 현재는 file만 지원돼요. 기본값은 file이에요.

DD_TRACE_LOGFILE_RETENTION_DAYS

타입: int 기본값: 32 마지막 쓰기 시간 날짜를 기준으로 로그 파일이 삭제되는 일수를 설정해요.

DD_TRACE_LOGGING_RATE

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

DD_TRACE_STARTUP_LOGS

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

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

(11)

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

DD_PROFILING_AGENTLESS

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

DD_PROFILING_ALLOCATION_ENABLED

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

DD_PROFILING_CODEHOTSPOTS_ENABLED

타입: boolean 기본값: true 별칭:DD_PROFILING_EXPERIMENTAL_CODEHOTSPOTS_ENABLED 연속 프로파일러의 코드 핫스팟 수집을 활성화하거나 비활성화해요. 비활성화하면 핫스팟 귀속을 위해 프로파일링 데이터가 트레이싱 컨텍스트에 연결되지 않아요.

DD_PROFILING_CPU_ENABLED

타입: boolean 기본값: true 시작 버전: v3.47.0 별칭:DD_PROFILING_EXPERIMENTAL_CPU_ENABLED false로 설정하면 CPU 프로파일링을 비활성화해요. 기본값은 true예요.

DD_PROFILING_ENABLED

타입: string 기본값: false 별칭:DD_EXPERIMENTAL_PROFILING_ENABLED true로 설정하면 프로파일러를 활성화해요. 기본값은 false예요.

DD_PROFILING_ENDPOINT_COLLECTION_ENABLED

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

DD_PROFILING_EXCEPTION_ENABLED

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

DD_PROFILING_GC_ENABLED

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

DD_PROFILING_HEAP_ENABLED

타입: boolean 기본값: false 시작 버전: v3.47.0 true로 설정하면 Live Heap 프로파일링(Preview)을 활성화해요. 기본값은 false예요.

DD_PROFILING_LOCK_ENABLED

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

DD_PROFILING_UPLOAD_PERIOD

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

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

(43)

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

DD_API_SECURITY_DOWNSTREAM_BODY_ANALYSIS_SAMPLE_RATE

타입: decimal 기본값: 0.5 시작 버전: v3.42.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_ENDPOINT_COLLECTION_MESSAGE_LIMIT

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

DD_API_SECURITY_MAX_DOWNSTREAM_REQUEST_BODY_ANALYSIS

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

DD_API_SECURITY_PARSE_RESPONSE_BODY

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

DD_APPSEC_AGENTIC_ONBOARDING

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

DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE

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

DD_APPSEC_AUTOMATED_USER_EVENTS_TRACKING

타입: string 기본값: identification 더 이상 사용되지 않음. 사용자 이벤트 자동 추적 모드. 값은 disabled, safe, extended가 될 수 있어요. 이 구성은 폐기 과정에 있어요. 대신 DD_APPSEC_AUTO_USER_INSTRUMENTATION_MODE를 사용하세요. 값은 자동으로 번역돼요: disabled = disabled safe = anon extended = ident.

DD_APPSEC_BODY_PARSING_SIZE_LIMIT

타입: int 기본값: 10000000 시작 버전: v3.42.0 처리할 본문의 최대 크기(바이트). 0으로 설정하면 본문이 처리되지 않아요. (권장 값: 10000000(10MB)).

DD_APPSEC_ENABLED

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

DD_APPSEC_EXTRA_HEADERS

타입: string 트레이서가 캡처해야 하는 추가 헤더 이름(기본 허용 목록 외)의 쉼표 구분 목록이에요. 서비스에 사용자 지정 인증 또는 애플리케이션별 헤더 분석이 필요할 때 유용해요. 추가 헤더는 개인정보 보호를 고려해 구성해야 하며 일반적으로 고객 조직 내에서만 유지돼요. 트레이서는 헤더 값의 편집/난독화 설정을 준수해요.

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_IPHEADER

타입: string 클라이언트 IP 해석에 사용할 단일 HTTP 헤더를 지정해요. 설정하면 트레이서는 해당 헤더를 클라이언트 IP의 권위 있는 소스로 취급하고 기본 후보 헤더 집합을 무시해요. 이는 프록시나 CDN이 사용자 지정 클라이언트 IP 헤더를 제공할 때 모호성과 IP 스푸핑 문제를 방지하는 데 도움이 되며, 주의해서 사용하고 배포 모범 사례를 따르세요.

DD_APPSEC_MAX_STACK_TRACE_DEPTH

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

DD_APPSEC_MAX_STACK_TRACE_DEPTH_TOP_PERCENT

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

DD_APPSEC_MAX_STACK_TRACES

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

DD_APPSEC_OBFUSCATION_PARAMETER_KEY_REGEXP

타입: string 기본값: (?i)(?:p(?:ass)?w(?:or)?d|pass(?:_?phrase)?|secret|(?:api_?|private_?|public_?)key)|token|consumer_?(?:id|key|secret)|sign(?:ed|ature)|bearer|authorization AppSec 난독화기가 전체 편집을 야기해야 하는 매개변수 키를 식별하는 데 사용하는 정규식이에요. key_path 문자열이 이 정규식과 일치하면 전체 매개변수가 <redacted by datadog>로 대체돼요. 기본 키 정규식은 일반적인 비밀/키 이름(비밀번호, 토큰, authorization, 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

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

DD_EXPERIMENTAL_APPSEC_USE_UNSAFE_ENCODER

타입: boolean 기본값: false waf에 새 안전하지 않은 인코더를 사용해요.

DD_IAST_COOKIE_FILTER_PATTERN

타입: string 기본값: .* IAST에서 각 데이터베이스 쿼리에 오염시킬 행 수. 기본값은 1이에요.

DD_IAST_DB_ROWS_TO_TAINT

타입: int 기본값: 1 IAST: 주어진 ResultSet에 대해 오염 소스(SQL 테이블 데이터)로 취급할 JDBC ResultSet 행의 최대 수. 이 한도를 초과하는 행은 오염되지 않아요. 기본값: 1.

DD_IAST_DEDUPLICATION_ENABLED

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

DD_IAST_ENABLED

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

DD_IAST_MAX_CONCURRENT_REQUESTS

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

DD_IAST_MAX_RANGE_COUNT

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

DD_IAST_REDACTION_ENABLED

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

DD_IAST_REDACTION_NAME_PATTERN

타입: 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)?|(?:sur|last)name|user(?:name)?|address|e?mail) IAST에서 소스 키를 난독화하는 사용자 지정 정규식 패턴. 기본값은 TracerSettings에 있어요.

DD_IAST_REDACTION_VALUE_PATTERN

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

DD_IAST_REGEXP_TIMEOUT

타입: decimal 기본값: 200.0 IAST에서 정규식 실행의 타임아웃(밀리초). 기본값은 200ms예요.

DD_IAST_REQUEST_SAMPLING

타입: int 기본값: 30 IAST가 분석하는 요청의 비율(1~100). 기본값은 30이에요.

DD_IAST_SECURITY_CONTROLS_CONFIGURATION

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

DD_IAST_TELEMETRY_VERBOSITY

타입: string 기본값: information 전송되는 텔레메트리의 상세도를 지정해요. 기본값 'INFORMATION'.

DD_IAST_TRUNCATION_MAX_VALUE_LENGTH

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

DD_IAST_VULNERABILITIES_PER_REQUEST

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

DD_IAST_WEAK_CIPHER_ALGORITHMS

타입: string 기본값: DES,TRIPLEDES,RC2 보고할 취약 암호 알고리즘을 제어해요.

DD_IAST_WEAK_HASH_ALGORITHMS

타입: string 기본값: HMACMD5,MD5,HMACSHA1,SHA1 보고할 취약 해싱 알고리즘을 제어해요.

Dynamic Instrumentation 및 디버깅

(26)

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

DD_CODE_ORIGIN_FOR_SPANS_ENABLED

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

DD_CODE_ORIGIN_FOR_SPANS_MAX_USER_FRAMES

타입: int 기본값: 8 종료 스팬 코드 출처에서 태그할 최대 프레임 수. 기본값은 8이에요.

DD_DYNAMIC_INSTRUMENTATION_DIAGNOSTICS_INTERVAL

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

DD_DYNAMIC_INSTRUMENTATION_ENABLED

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

DD_DYNAMIC_INSTRUMENTATION_EVALUATION_TIMEOUT_MS

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

DD_DYNAMIC_INSTRUMENTATION_MAX_DEPTH_TO_SERIALIZE

타입: int 기본값: 3 프로브 스냅샷을 직렬화할 최대 객체 깊이.

DD_DYNAMIC_INSTRUMENTATION_MAX_TIME_TO_SERIALIZE

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

DD_DYNAMIC_INSTRUMENTATION_PROBE_FILE

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

DD_DYNAMIC_INSTRUMENTATION_REDACTED_EXCLUDED_IDENTIFIERS

타입: string 편집 결정에서 제외되는 식별자 집합.

DD_DYNAMIC_INSTRUMENTATION_REDACTED_IDENTIFIERS

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

DD_DYNAMIC_INSTRUMENTATION_REDACTED_TYPES

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

DD_DYNAMIC_INSTRUMENTATION_REDACTION_EXCLUDED_IDENTIFIERS

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

DD_DYNAMIC_INSTRUMENTATION_UPLOAD_BATCH_SIZE

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

DD_DYNAMIC_INSTRUMENTATION_UPLOAD_FLUSH_INTERVAL

타입: int 기본값: 0 저비율 업로드 플러시 간격(밀리초). 0(기본값)은 적응형 플러시 간격을 활성화하고, 다른 값은 고정 간격을 사용해요. DD_DYNAMIC_INSTRUMENTATION_UPLOAD_INTERVAL_SECONDS로 대체되어 폐기 예정이에요.

DD_EXCEPTION_REPLAY_AGENTLESS_ENABLED

타입: boolean 기본값: false 에이전트리스 Exception Replay 업로드를 활성화하거나 비활성화해요. 기본값은 false예요.

DD_EXCEPTION_REPLAY_AGENTLESS_URL

타입: string Exception Replay에서 에이전트리스 모드가 활성화되면 이 구성을 사용해 인테이크 URL을 강제할 수 있어요.

DD_EXCEPTION_REPLAY_CAPTURE_FULL_CALLSTACK_ENABLED

타입: boolean 기본값: false 예외 콜스택의 모든 프레임 변수 캡처를 활성화하는 구성 키예요. 기본값은 false예요.

DD_EXCEPTION_REPLAY_CAPTURE_MAX_FRAMES

타입: int 기본값: 4 값을 캡처할 콜스택의 최대 프레임 수.

DD_EXCEPTION_REPLAY_ENABLED

타입: boolean 기본값: false 별칭:DD_EXCEPTION_DEBUGGING_ENABLED Exception Replay를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.

DD_EXCEPTION_REPLAY_MAX_EXCEPTION_ANALYSIS_LIMIT

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

DD_EXCEPTION_REPLAY_RATE_LIMIT_SECONDS

타입: int 기본값: 3600 예외 추적을 비율 제한하는 데 사용되는 간격. 기본값은 1시간이에요.

DD_SYMBOL_DATABASE_BATCH_SIZE_BYTES

타입: int 기본값: 100000 업로드할 최대 심볼 크기(바이트). 기본값은 1MB예요.

DD_SYMBOL_DATABASE_COMPRESSION_ENABLED

타입: boolean 기본값: true 심볼 페이로드의 압축을 활성화하거나 비활성화해요. 기본값은 true(활성화)예요.

DD_SYMBOL_DATABASE_THIRD_PARTY_DETECTION_EXCLUDES

타입: string 심볼 데이터베이스의 타사 감지에서 제외할 라이브러리의 쉼표 구분 목록. 기본값은 비어 있음.

DD_SYMBOL_DATABASE_THIRD_PARTY_DETECTION_INCLUDES

타입: string 심볼 데이터베이스의 타사 감지에 포함할 라이브러리의 쉼표 구분 목록. 기본값은 비어 있음.

DD_SYMBOL_DATABASE_UPLOAD_ENABLED

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

CI 가시성 (CI Visibility)

(45)

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

타입: boolean 기본값: false CI Visibility의 자동 계측 공급자를 식별해요. 어떤 계측 방법(예: 단일 단계, 수동 등)이 사용되었는지 추적하는 데 사용돼요.

DD_CIVISIBILITY_CODE_COVERAGE_COLLECTORPATH

타입: string 코드 커버리지 수집기의 경로.

DD_CIVISIBILITY_CODE_COVERAGE_ENABLE_JIT_OPTIMIZATIONS

타입: boolean 기본값: true Code Coverage에서 JIT 최적화를 활성화하거나 비활성화해요.

DD_CIVISIBILITY_CODE_COVERAGE_ENABLED

타입: boolean CI Visibility에서 Code Coverage를 활성화하거나 비활성화해요.

DD_CIVISIBILITY_CODE_COVERAGE_MODE

타입: string 코드 커버리지 모드를 선택해요: LineExecution 또는 LineCallCount.

DD_CIVISIBILITY_CODE_COVERAGE_PATH

타입: string 코드 커버리지 JSON 파일의 대상 경로.

DD_CIVISIBILITY_CODE_COVERAGE_SNK_FILEPATH

타입: string Code Coverage 수정 후 어셈블리 재서명에 사용되는 SNK 파일 경로.

DD_CIVISIBILITY_DI_ENABLED

타입: boolean 기본값: false CI Visibility용 의존성 주입.

DD_CIVISIBILITY_EARLY_FLAKE_DETECTION_ENABLED

타입: boolean CI Visibility에서 조기 플래크 감지 기능을 활성화하거나 비활성화해요.

DD_CIVISIBILITY_ENABLED

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

DD_CIVISIBILITY_EXTERNAL_CODE_COVERAGE_PATH

타입: string 외부 코드 커버리지 파일 경로.

DD_CIVISIBILITY_FLAKY_RETRY_COUNT

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

DD_CIVISIBILITY_FLAKY_RETRY_ENABLED

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

DD_CIVISIBILITY_GIT_UPLOAD_ENABLED

타입: boolean CI Visibility에서 Git 메타데이터 업로드를 활성화하거나 비활성화해요. 기본값은 false(비활성화)예요.

DD_CIVISIBILITY_IMPACTED_TESTS_DETECTION_ENABLED

타입: boolean 영향받은 테스트 감지를 활성화하거나 비활성화해요.

DD_CIVISIBILITY_ITR_ENABLED

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

DD_CIVISIBILITY_KNOWN_TESTS_ENABLED

타입: boolean CI Visibility에서 알려진 테스트 기능을 활성화하거나 비활성화해요.

DD_CIVISIBILITY_LOGS_ENABLED

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

DD_CIVISIBILITY_RUM_FLUSH_WAIT_MILLIS

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

DD_CIVISIBILITY_TESTSSKIPPING_ENABLED

타입: boolean CI Visibility에서 Intelligent Test Runner 테스트 건너뛰기 기능을 활성화하거나 비활성화해요.

DD_CIVISIBILITY_TOTAL_FLAKY_RETRY_COUNT

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

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_PULL_REQUEST_BASE_BRANCH

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

DD_GIT_PULL_REQUEST_BASE_BRANCH_SHA

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

DD_GIT_REPOSITORY_URL

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

DD_GIT_TAG

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

DD_PIPELINE_EXECUTION_ID

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

DD_TEST_MANAGEMENT_ATTEMPT_TO_FIX_RETRIES

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

DD_TEST_MANAGEMENT_ENABLED

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

DD_TEST_SESSION_NAME

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

DD_TESTSESSION_COMMAND

타입: string 실행된 테스트 세션 명령을 지정해요. 테스트 세션을 시작한 명령줄을 추적하는 데 사용돼요.

DD_TESTSESSION_WORKINGDIRECTORY

타입: string 테스트 세션 작업 디렉터리를 지정해요. 테스트 세션이 실행된 작업 디렉터리를 추적하는 데 사용돼요.

DD_TRACE_GIT_METADATA_ENABLED

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

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

(1)

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

DD_CRASHTRACKING_ENABLED

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

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

(12)

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

DD_LOGS_DIRECT_SUBMISSION_AZURE_FUNCTIONS_HOST_ENABLED

타입: boolean 기본값: false Azure Functions 호스트의 Datadog 백엔드로 직접 로그 제출을 활성화해요.

DD_LOGS_DIRECT_SUBMISSION_BATCH_PERIOD_SECONDS

타입: int 기본값: 2 로그 배치 확인 사이의 대기 시간. 기본값은 2초예요.

DD_LOGS_DIRECT_SUBMISSION_HOST

타입: string 직접 로그 제출의 출처 호스트 이름을 설정해요. 직접 로그 제출에 필요해요(기본값은 머신 이름).

DD_LOGS_DIRECT_SUBMISSION_INTEGRATIONS

타입: string 활성화할 직접 로그 제출 통합 목록이에요. 선택된 통합만 직접 로그 제출에 활성화돼요. 기본값은 비어 있음(직접 로그 제출 비활성화)이에요. 세미콜론으로 구분된 여러 값을 지원해요.

DD_LOGS_DIRECT_SUBMISSION_MAX_BATCH_SIZE

타입: int 기본값: 1000 한 번에 보낼 최대 로그 수. 기본값은 1,000으로, Datadog 로그 API가 허용하는 최대치예요.

DD_LOGS_DIRECT_SUBMISSION_MAX_QUEUE_SIZE

타입: int 기본값: 100000 내부 큐에 한 번에 보관할 최대 로그 수. 기본값은 100,000이에요.

DD_LOGS_DIRECT_SUBMISSION_MINIMUM_LEVEL

타입: string 기본값: Information 인테이크로 보내기 위해 로그가 가져야 하는 최소 수준. 기본값은 Information이에요. Verbose,Debug,Information,Warning,Error,Fatal 중 하나여야 해요.

DD_LOGS_DIRECT_SUBMISSION_SOURCE

타입: string 기본값: csharp 직접 로그 제출의 출처를 설정해요. 기본값은 'csharp'이에요.

DD_LOGS_DIRECT_SUBMISSION_TAGS

타입: string 직접 제출된 모든 로그에 전역으로 적용되는 태그 목록. 쉼표로 구분된 여러 키-값 쌍을 지원하고, 키와 값은 콜론으로 구분돼요(예: Key1:Value1,Key2:Value2). 제공되지 않으면 전역 태그가 대신 사용돼요.

DD_LOGS_DIRECT_SUBMISSION_URL

타입: string 기본값: https://http-intake.logs.datadoghq.com:443 로그를 보낼 URL. 기본값은 ConfigurationKeys.Site에 설정된 도메인을 사용하므로 https://http-intake.logs.datadoghq.com:443를 기본값으로 해요.

DD_LOGS_INJECTION

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

언어별 참고:

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

DD_LOGS_OTEL_ENABLED

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

런타임 메트릭 (Runtime Metrics)

(8)

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

DD_DOGSTATSD_ARGS

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

DD_DOGSTATSD_PATH

타입: string Azure App Services: 외부 프로세스로 실행할 DogStatsD 실행 파일 경로. 설정하면 트레이서가 dogstatsd 프로세스를 시작·감독하고(DD_DOGSTATSD_ARGS 전달), 선택적으로 DD_DOGSTATSD_PIPE_NAME을 사용해 헬스 체크해요.

DD_DOGSTATSD_PIPE_NAME

타입: string DogStatsD가 바인딩하는 명명 파이프. 기본값은 null이에요.

DD_DOGSTATSD_PORT

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

DD_DOGSTATSD_SOCKET

타입: string DogStatsD가 바인딩하는 Unix 도메인 소켓. 기본값은 null이에요.

DD_DOGSTATSD_URL

타입: string 기본값: udp://127.0.0.1:8125 DogstatsD 메트릭을 위해 Datadog Agent에 연결하는 데 사용할 URL.

DD_RUNTIME_METRICS_DIAGNOSTICS_METRICS_API_ENABLED

타입: boolean 기본값: false .NET 6부터 사용 가능해요. .NET SDK가 EventListener 기반 수집기 대신 System.Diagnostics.Metrics API를 사용해 런타임 메트릭을 수집하는지 제어해요.

기본 동작: .NET 8+에서는 true, .NET 6/7에서는 DD_RUNTIME_METRICS_ENABLED가 명시적으로 설정되지 않은 경우에만 true, 그 외에는 false.

DD_RUNTIME_METRICS_ENABLED

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

Data Streams Monitoring

(3)

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

DD_DATA_STREAMS_ENABLED

타입: boolean 기본값: true 데이터 스트림 모니터링 지원을 활성화해요.

DD_DATA_STREAMS_LEGACY_HEADERS

타입: boolean 기본값: false Data Streams Monitoring에서 레거시 바이너리 헤더를 활성화해요. DSM이 기본 상태이면 기본적으로 false, 그 외에는 true예요.

DD_DATA_STREAMS_TRANSACTION_EXTRACTORS

타입: array 시작 버전: v3.42.0 트랜잭션 추적을 위한 Data Streams 추출기 구성을 허용해요.

계측 텔레메트리 (Instrumentation Telemetry)

(6)

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

DD_INSTRUMENTATION_TELEMETRY_AGENTLESS_ENABLED

타입: boolean 기본값: false 활성화되고 API 키가 설정되면 텔레메트리를 인테이크로 직접 전송해요. Agent를 사용할 수 없으면 텔레메트리는 인테이크로 직접 전송돼요. API 키가 있으면 기본적으로 활성화돼요.

DD_INSTRUMENTATION_TELEMETRY_COMPRESSION_METHOD

타입: string 기본값: gzip 텔레메트리 압축을 허용하는 구성 키예요.

DD_INSTRUMENTATION_TELEMETRY_ENABLED

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

(32)

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

DD_METRICS_OTEL_ENABLED

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

DD_METRICS_OTEL_METER_NAMES

타입: string 실험적 OpenTelemetry Metrics API 지원을 위해 메트릭 exporter에 추가할 미터 목록.

DD_TRACE_OTEL_ENABLED

타입: boolean 기본값: false 별칭:DD_TRACE_ACTIVITY_LISTENER_ENABLED true이면 사용자 지정 계측에 대한 OpenTelemetry 기반 트레이싱이 활성화돼요.

OTEL_EXPORTER_OTLP_ENDPOINT

타입: string 기본값: http://localhost:4317/ OTLP 엔드포인트 URL을 설정하는 구성 키예요(메트릭별 엔드포인트의 대체값). ExporterOtlpMetricsEndpoint가 설정되지 않았을 때 사용돼요. UDS의 경우 unix:///path/to/socket.sock, Windows 명명 파이프의 경우 \\.\pipename\ 같은 값을 기대해요. 기본값: gRPC: http://localhost:4317, HTTP: http://localhost:4318.

OTEL_EXPORTER_OTLP_HEADERS

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

OTEL_EXPORTER_OTLP_LOGS_ENDPOINT

타입: string 기본값: http://localhost:4317/ 선택적으로 지정된 포트 번호가 있는 로그 데이터 전용 엔드포인트 URL. OTLP/HTTP 사용 시 일반적으로 v1/logs로 끝나요.

OTEL_EXPORTER_OTLP_LOGS_HEADERS

타입: map 별칭:OTEL_EXPORTER_OTLP_HEADERS 모든 나가는 OTLP 로그에 적용할 헤더 맵.

OTEL_EXPORTER_OTLP_LOGS_PROTOCOL

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

OTEL_EXPORTER_OTLP_LOGS_TIMEOUT

타입: int 기본값: 10000 별칭:OTEL_EXPORTER_OTLP_TIMEOUT 모든 나가는 로그의 타임아웃 값(밀리초).

OTEL_EXPORTER_OTLP_METRICS_ENDPOINT

타입: string 기본값: http://localhost:4317/ 메트릭용 OTLP 엔드포인트 URL을 설정하는 구성 키예요. ExporterOtlpEndpoint보다 우선해요. 이 값은 OTLP/HTTP 사용 시 일반적으로 v1/metrics로 끝나요. UDS의 경우 unix:///path/to/socket.sock, Windows 명명 파이프의 경우 \\.\pipename\ 같은 값을 기대해요. 기본값: gRPC: http://localhost:4317, HTTP: http://localhost:4318/v1/metrics.

OTEL_EXPORTER_OTLP_METRICS_HEADERS

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

OTEL_EXPORTER_OTLP_METRICS_PROTOCOL

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

OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE

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

OTEL_EXPORTER_OTLP_METRICS_TIMEOUT

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

OTEL_EXPORTER_OTLP_PROTOCOL

타입: string 기본값: grpc OTEL_EXPORTER_OTLP_METRICS_PROTOCOL이 설정되지 않았을 때 메트릭의 대체 OTLP 프로토콜로 사용돼요. 파싱된 값: grpc, http/protobuf, http/json(대소문자 무시). 참고: http/json은 현재 메트릭에 지원되지 않으며 메트릭 내보내기를 비활성화하고, grpc/http/protobuf는 해당 Cargo 기능(metrics-grpc/metrics-http)이 필요해요.

OTEL_EXPORTER_OTLP_TIMEOUT

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

OTEL_EXPORTER_OTLP_TRACES_ENDPOINT

타입: string 시작 버전: v3.41.0 트레이스용 OTLP 엔드포인트 URL을 설정하는 구성 키예요. ExporterOtlpEndpoint보다 우선해요. 이 값은 OTLP/HTTP 사용 시 일반적으로 v1/traces로 끝나요. UDS의 경우 unix:///path/to/socket.sock, Windows 명명 파이프의 경우 \\.\pipename\ 같은 값을 기대해요. 기본값: gRPC: http://localhost:4317, HTTP: http://localhost:4318/v1/metrics.

OTEL_EXPORTER_OTLP_TRACES_HEADERS

타입: map 시작 버전: v3.41.0 별칭:OTEL_EXPORTER_OTLP_HEADERS OTLP 트레이스 내보내기용 사용자 지정 헤더를 설정하는 구성 키예요. 일반 OTLP 헤더보다 우선해요. 형식: api-key=key,other=value.

OTEL_EXPORTER_OTLP_TRACES_PROTOCOL

타입: string 기본값: http/json 시작 버전: v3.41.0 별칭:OTEL_EXPORTER_OTLP_PROTOCOL 트레이스 내보내기용 OTLP 프로토콜을 설정하는 구성 키예요. 일반 OTLP 프로토콜 설정보다 우선해요. 유효한 값: http/json. 기본: http/json.

OTEL_EXPORTER_OTLP_TRACES_TIMEOUT

타입: int 기본값: 10000 시작 버전: v3.41.0 별칭:OTEL_EXPORTER_OTLP_TIMEOUT OTLP 트레이스 내보내기의 요청 타임아웃을 밀리초 단위로 설정하는 구성 키예요. 일반 OTLP 타임아웃 설정보다 우선해요. 기본값은 10000ms예요.

OTEL_LOG_LEVEL

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

OTEL_LOGS_EXPORTER

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

OTEL_METRIC_EXPORT_INTERVAL

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

OTEL_METRIC_EXPORT_TIMEOUT

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

OTEL_METRICS_EXPORTER

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

OTEL_PROPAGATORS

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

OTEL_RESOURCE_ATTRIBUTES

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

OTEL_SDK_DISABLED

타입: boolean OpenTelemetry API를 비활성화해요.

OTEL_SERVICE_NAME

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

OTEL_TRACES_EXPORTER

타입: string 시작 버전: v3.41.0 트레이스용 exporter를 설정하는 구성 키예요. 'otlp'와 'none' 값만 인식해요. 'otlp' 값은 OTLP를 사용한 실험적 트레이스 내보내기를 활성화해요. 'none' 값은 트레이스 내보내기를 완전히 비활성화하며, 이는 false로 설정하는 것과 동등해요.

OTEL_TRACES_SAMPLER

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

OTEL_TRACES_SAMPLER_ARG

타입: decimal 트레이스 샘플러의 추가 인자를 설정하는 구성 키예요. false로 설정됨.

계측 및 플랫폼 (Instrumentation & Platform)

(6)

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

DD_AAS_ENABLE_CUSTOM_METRICS

타입: boolean 기본값: false Azure App Services에서 로더가 dogstatsd를 시작하도록 강제하는 데 사용돼요(자동 계측이 비활성화된 경우).

DD_AAS_ENABLE_CUSTOM_TRACING

타입: boolean 기본값: false Azure App Services에서 로더가 트레이스 에이전트를 시작하도록 강제하는 데 사용돼요(자동 계측이 비활성화된 경우).

DD_DOTNET_TRACER_HOME

타입: string dotnet Datadog 트레이서의 홈 디렉터리를 가리켜요. Windows에서는 설치 경로(예: C:\Program Files\Datadog.NET Tracer)로 설정되는 경우가 많아요. Linux/Docker에서는 일반적으로 /opt/datadog로 설정돼요.

DD_INJECT_FORCE

타입: string 지원되지 않는 런타임을 계측할 수 있게 하는 SSI 변수예요. 텔레메트리의 상관관계 목적으로 사용돼요.

DD_THIRD_PARTY_DETECTION_EXCLUDES

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

DD_THIRD_PARTY_DETECTION_INCLUDES

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

기타 (Miscellaneous)

(3)

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_ENABLED

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_INITIALIZATION_TIMEOUT_MS

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

DD_EXPERIMENTAL_FLAGGING_PROVIDER_SPAN_ENRICHMENT_ENABLED

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

더 알아보기 (Learn more)

• .NET 애플리케이션 로그를 트레이스에 연결 (Connect .NET application logs to traces)
• 런타임 메트릭 (Runtime metrics)
• 트레이스 컨텍스트 전파 (Propagating trace context)
• Microsoft Azure App Service 확장 (Microsoft Azure App Service extension)
• 서비스·리소스·트레이스 탐색 (Explore your services, resources, and traces)
• Datadog APM과 분산 트레이싱으로 .NET 모니터링 (.NET monitoring with Datadog APM and distributed tracing)
• 컨테이너화된 ASP.NET Core 애플리케이션 모니터링 (Monitor containerized ASP.NET Core applications)
• AWS Fargate에서 컨테이너화된 ASP.NET Core 애플리케이션 모니터링Monitor (Monitor containerized ASP.NET Core applications on AWS Fargate)
• 사용자 지정 계측 예시 (Examples of custom instrumentation)
• 소스 코드 (Source code)
• OpenTelemetry 환경 변수 구성 (OpenTelemetry Environment Variable Configurations)