런타임 구성 (Configuration at Runtime)

원문 보기 위키 갱신 2026.10.05

런타임 구성을 사용하면 애플리케이션이나 서비스를 다시 시작하지 않고도 Datadog UI에서 Datadog SDK 구성을 수정할 수 있어요. 새 배포나 코드 변경을 기다릴 필요가 없어요. 대신 런타임 구성을 사용해 즉시 업데이트하세요.

출처: 문서

본문

런타임 구성을 통해 Datadog UI에서 Datadog SDK 구성을 수정할 수 있어요. 애플리케이션이나 서비스를 다시 시작할 필요가 없어요. 구성을 업데이트하기 위해 새 배포나 코드 변경을 기다릴 필요 없이 런타임 구성으로 바로 업데이트하세요.

런타임 구성을 사용하기 전에 Remote Configuration을 설정해야 해요. 자세한 내용은 Tracing용 Remote Configuration 설정을 참고하세요.

런타임 구성 편집의 기본 진입점은 서비스 페이지의 SDK & Agent Configurations 탭이에요.

런타임에서 서비스 구성을 변경하려면:

이 예시에서 한 인스턴스에서 test 환경에 대해 Log Injection이 비활성화되어 있는 것을 볼 수 있어요. 인스턴스는 Remote Configuration 클라이언트의 인스턴스를 의미해요. 애플리케이션 프로세스당 하나의 인스턴스가 있어야 해요.

구성 변경이 성공적으로 적용되었는지 Updates applied to X instances 텍스트를 참고해 알 수 있어요. 이 예시에서 구성은 한 인스턴스에 성공적으로 적용됐어요.

정보 Setup Guidance 탭에는 더 이상 편집 패널이 포함되지 않아요. SDK & Agent Configurations 탭으로 안내하는 배너가 표시돼요.

다음 옵션은 런타임 구성에서 지원돼요. 각 언어에 필요한 트레이서 버전이 나열되어 있어요:

옵션 (Option)	Java	Node.js	Python	.NET	Ruby	Go	C++
사용자 정의 샘플링 비율: `DD_TRACE_SAMPLE_RATE`로 라이브러리의 전역 샘플링 비율 설정.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.4.0+`	`2.33.0+`	`1.13.0+`	`1.59.0+`	`0.2.0+`
로그 주입: `DD_LOGS_INJECTION`을 활성화해 로그와 트레이스를 상호 연결하기 위해 트레이스 상관 식별자를 자동 주입.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.6.0+`	`2.33.0+`	`1.13.0+`
HTTP 헤더 태그: `DD_TRACE_HEADER_TAGS`를 사용해 HTTP 헤더 값을 트레이스의 태그로 추가.	`1.17.0+`	`4.11+` `3.32+` `2.45+`	`2.6.0+`	`2.33.0+`	`1.13.0+`	`1.59.0+`
사용자 정의 스팬 태그: `DD_TAGS`로 각 스팬에 지정된 태그 추가.	`1.31.0+`	`4.23.0+` `3.44.0+`	`2.5.0+`	`2.44.0+`	`1.59.0+`		`0.2.0+`
리소스 기반 샘플링: `DD_TRACE_SAMPLING_RULES`로 Datadog UI에서 서비스 및 리소스 이름별 샘플링 비율 설정.	`1.34.0+`	`5.16.0+`	`2.9.0+`	`2.53.2+`	`2.0.0+`	`1.64.0+`	`0.2.2+`
적응형 샘플링 (Adaptive Sampling): Datadog이 구성된 월간 수집 볼륨 예산과 일치하도록 사용자를 대신해 샘플링 비율을 제어.	`1.34.0+`	`5.16.0+`	`2.9.6+`	`2.54.0+`	`2.0.0+`	`1.68.0+`	`0.2.2+`