지원되는 datadog.yaml 구성 필드 (Supported datadog.yaml Configuration Fields)
Fleet Automation이 지원하는 Agent 설정 필드의 레퍼런스를 알려드릴게요. 각 필드의 타입, 설명, 유효 값을 이 안내 페이지에서 확인할 수 있어요.
출처: 문서
본문
app.ddog-gov.com, us2.ddog-gov.com Datadog 사이트를 사용하는 사용자를 위한 중요 참고사항
이 제품은 선택한 Datadog 사이트({% placeholder "user-datadog-site-name" /%})에서는 지원되지 않아요.
Fleet Automation은 Agent 구성하기 시 datadog.yaml 필드의 일부를 지원해요. 제공한 모든 변경은 스키마에 대해 검증되며, 여기에 나열되지 않은 필드는 스키마 검증 오류로 거부돼요.
아래에서 각 섹션을 펼치면 각 지원 필드의 타입, 설명, 유효 값을 볼 수 있어요.
최상위 필드 (Top-level fields)
38개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
check_runners |
number | 통합을 실행하기 위한 동시 체크 러너 수.유효 값: 1–1000 |
cloud_provider_metadata |
array[string] | 메타데이터를 쿼리할 클라우드 제공자 목록 (aws, gcp, azure 등). |
cmd_port |
number | Agent 내부 명령 API의 포트.유효 값: 1–65535 |
collect_ec2_tags |
boolean | AWS EC2 커스텀 태그를 호스트 태그로 수집을 활성화하는 플래그. |
collect_ec2_tags_use_imds |
boolean | 태그 수집에 API 대신 EC2 Instance Metadata Service를 사용하는 플래그. |
dd_url |
string | Agent 데이터를 보낼 Datadog intake 서버의 호스트. DNS 장애 조치(DDR) 설정을 위해 datadoghq.com 하위 도메인으로 제한됨. |
dogstatsd_non_local_traffic |
boolean | DogStatsD가 로컬이 아닌 UDP 트래픽을 수락하도록 허용하는 플래그. |
dogstatsd_origin_detection |
boolean | Unix Socket을 사용할 때 DogStatsD가 메트릭을 컨테이너 메타데이터로 태깅할 수 있음. DogStatsD를 컨테이너에서 실행 중이라면 호스트 PID 모드(예: --pid=host)가 필요함. 소켓 트래픽에서만 지원됨. |
dogstatsd_port |
number | DogStatsD 서버가 수신할 포트 번호.유효 값: 1–65535 |
dogstatsd_socket |
string | DogStatsD 통신을 위한 Unix 소켓 경로. |
dogstatsd_stats_enable |
boolean | DogStatsD 내부 통계 수집을 활성화하는 플래그. |
dogstatsd_stats_port |
number | DogStatsD 통계 go_expvar 서버의 포트.유효 값: 1–65535 |
dogstatsd_tags |
array | 모든 DogStatsD 메트릭에 적용할 태그 목록. |
ec2_metadata_timeout |
string | AWS EC2 메타데이터 엔드포인트 호출의 타임아웃. |
ecs_collect_resource_tags_ec2 |
string | EC2 런치 유형에서 ECS 리소스 태그 수집을 위한 구성. |
ecs_task_collection_enabled |
boolean | orchestrator 체크를 위해 ECS 작업 수집을 활성화하는 플래그. |
env |
string | Agent가 실행 중인 환경 이름. |
exclude_gce_tags |
array[string] | 호스트 태그에서 제외할 GCE 메타데이터 속성 목록. |
expvar_port |
number | Agent의 go_expvar 디버그 서버 포트.유효 값: 1–65535 |
extra_tags |
array | Agent가 보내는 모든 데이터에 적용할 추가 태그. |
forwarder_connection_reset_interval |
integer | forwarder가 Datadog에 대한 연결을 재설정하는 간격(초). 0은 재설정을 비활성화.유효 값: ≥ 0 |
histogram_aggregates |
array[string] | DogStatsD에 대해 계산할 히스토그램 집계 목록. |
histogram_percentiles |
array[string] | DogStatsD 히스토그램에 대해 계산할 백분위수 목록. |
hostname_fqdn |
boolean | Agent가 OS에 의존해 호스트네임을 결정할 때 짧은 호스트네임 대신 FQDN을 사용하게 하는 설정. |
infrastructure_mode |
string | Agent가 구성된 모니터링 모드. 각 모드는 서로 다른 기능을 제공함(기본은 full, 다른 가능한 값은 end_user_device, basic, cloud_cost_only).유효 값: basic, full, end_user_device, cloud_cost_only |
log_file_max_rolls |
number | 로테이션 후 보관할 이전 로그 파일 최대 수.유효 값: 0–1000 |
log_file_max_size |
string | 로테이션 전 Agent 로그 파일의 최대 크기. |
log_level |
string | Datadog Agent의 최소 로그 레벨.유효 값: off, critical, error, warn, info, debug, trace |
log_to_console |
boolean | 표준 출력으로의 로깅을 활성화하는 플래그. |
log_to_syslog |
boolean | syslog로의 로깅을 활성화하는 플래그. |
logs_enabled |
boolean | 로그 수집을 활성화하거나 비활성화하는 플래그. |
max_events_per_second |
number | 초당 샘플링할 APM 이벤트 최대 수.유효 값: 0–1000000000 |
min_tls_version |
string | Datadog intake에 연결할 때의 최소 TLS 버전. |
open_files_limit |
number | Agent가 동시에 열어둘 수 있는 최대 파일 수.유효 값: 0–1000000 |
tags |
array | Agent가 보내는 모든 데이터에 적용할 태그 목록. |
use_diskv2_check |
boolean | Go 코어 디스크 체크를 활성화하거나 비활성화하는 플래그. 비활성화하면 대신 Python 디스크 체크가 사용됨. |
use_dogstatsd |
boolean | DogStatsD 서버를 활성화하거나 비활성화하는 플래그. |
use_networkv2_check |
boolean | Go 코어 네트워크 체크를 활성화하거나 비활성화하는 플래그. 비활성화하면 대신 Python 네트워크 체크가 사용됨. |
APM (apm_config)
14개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
apm_config.apm_dd_url |
string | 트레이스를 보낼 Datadog trace intake 서버의 호스트. DNS 장애 조치(DDR) 설정을 위해 datadoghq.com 하위 도메인으로 제한됨. |
apm_config.apm_non_local_traffic |
boolean | APM Agent가 로컬이 아닌 트래픽을 수신하도록 허용하는 플래그. |
apm_config.connection_reset_interval |
integer | trace agent가 Datadog에 대한 연결을 재설정하는 간격(초). 0은 재설정을 비활성화.유효 값: ≥ 0 |
apm_config.enabled |
boolean | APM을 활성화하거나 비활성화하는 플래그. |
apm_config.env |
string | 트레이스에 태깅할 환경 태그. |
apm_config.extra_sample_rate |
number | 트레이스 수집을 위한 추가 샘플링 비율 승수.유효 값: 0–100 |
apm_config.filter_tags.reject |
array[string] | 트레이스를 거부할 태그 패턴 목록. |
apm_config.ignore_resources |
array[string] | 리소스 이름을 기준으로 트레이스를 제외할 정규식 목록. |
apm_config.max_traces_per_second |
number | 초당 샘플링할 트레이스 최대 수.유효 값: 0–1000000000 |
apm_config.obfuscation.http.remove_paths_with_digits |
boolean | 숫자를 포함하는 URL 경로 세그먼트를 난독화하는 플래그. |
apm_config.obfuscation.http.remove_query_string |
boolean | HTTP URL에서 쿼리 문자열을 제거하는 플래그. |
apm_config.obfuscation.remove_stack_traces |
boolean | 스팬 데이터에서 스택 트레이스를 제거하는 플래그. |
apm_config.receiver_port |
number | trace receiver가 수신할 포트 번호.유효 값: 1–65535 |
apm_config.receiver_socket |
string | 트레이스를 수신하는 Unix Domain Socket 경로. |
컴플라이언스 (compliance_config)
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
compliance_config.enabled |
boolean | 컴플라이언스 체크를 활성화하거나 비활성화하는 플래그. |
컨테이너 이미지 (container_image)
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
container_image.enabled |
boolean | 컨테이너 이미지 스캐닝을 활성화하거나 비활성화하는 플래그. |
data_security
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
data_security.enabled |
boolean | Data Security를 활성화하거나 비활성화하는 플래그. |
페이로드 활성화 (enable_payloads)
4개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
enable_payloads.events |
boolean | 이벤트 페이로드를 활성화하거나 비활성화하는 플래그. |
enable_payloads.series |
boolean | 시리즈 페이로드를 활성화하거나 비활성화하는 플래그. |
enable_payloads.service_checks |
boolean | 서비스 체크 페이로드를 활성화하거나 비활성화하는 플래그. |
enable_payloads.sketches |
boolean | 스케치 페이로드를 활성화하거나 비활성화하는 플래그. |
HA Agent (ha_agent)
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
ha_agent.enabled |
boolean | HA Agent를 활성화하거나 비활성화하는 플래그. |
로그 (logs_config)
19개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
logs_config.auto_multi_line_detection |
boolean | 멀티라인 로그의 자동 감지 및 집계를 활성화하는 플래그. |
logs_config.batch_max_size |
number | HTTP 배치당 최대 로그 이벤트 수.유효 값: 1–10000 |
logs_config.compression_level |
number | use_compression 활성화 시 압축 레벨(0-9).유효 값: 0–9 |
logs_config.connection_reset_interval |
integer | logs forwarder가 Datadog에 대한 연결을 재설정하는 간격(초). 0은 재설정을 비활성화.유효 값: ≥ 0 |
logs_config.container_collect_all |
boolean | 모든 컨테이너에 대한 컨테이너 로그 수집을 활성화 (컨테이너 필터링을 위해 ac_exclude 참고) |
logs_config.enable_recursive_glob |
boolean | 파일 로그 경로에 대한 옵트인 재귀 글로브(glob) (지원 **). 기본 false로 현재 동작을 유지. |
logs_config.file_wildcard_selection_mode |
string | 와일드카드 파일 일치가 열린 파일 한도를 초과할 때 우선순위 지정 전략.유효 값: by_name, by_modification_time |
logs_config.force_use_http |
boolean | 항상 HTTP(S) 프로토콜로 로그를 보내고 TCP로 절대 폴백하지 않는 플래그. |
logs_config.frame_size |
number | 로그 프레임의 최대 크기(바이트).유효 값: 1024–2097152 |
logs_config.logs_dd_url |
string | 로그를 보낼 Datadog logs intake 서버의 호스트. DNS 장애 조치(DDR) 설정을 위해 datadoghq.com 하위 도메인으로 제한됨. |
logs_config.open_files_limit |
number | 동시에 테일링할 수 있는 최대 로그 파일 수.유효 값: 0–1000000 |
logs_config.processing_rules |
array[object] | 모든 로그에 적용되는 전역 처리 규칙 목록. |
logs_config.processing_rules.name |
string | 처리 규칙에 대한 설명적 이름. |
logs_config.processing_rules.pattern |
string | 로그 내용에 대해 매칭할 정규식 패턴. |
logs_config.processing_rules.replace_placeholder |
string | 일치한 시퀀스를 대체할 플레이스홀더 텍스트. |
logs_config.processing_rules.type |
string | 적용할 처리 규칙의 유형.유효 값: exclude_at_match, include_at_match, mask_sequences, multi_line, exclude_truncated |
logs_config.use_compression |
boolean | HTTP로 로그를 보낼 때 압축을 활성화하는 플래그. |
logs_config.use_http |
boolean | 로그 전송에 HTTP 전송을 사용하는 플래그. |
logs_config.use_sourcehost_tag |
boolean | true이면 TCP/UDP 로그에 source_host 태그(IP 주소)가 추가됨. |
네트워크 디바이스 (network_devices)
26개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
network_devices.autodiscovery.configs |
array[object] | 서로 다른 서브넷에 대한 탐색 구성 목록. |
network_devices.autodiscovery.configs.authKey |
string | 인증 키의 시크릿 식별자 |
network_devices.autodiscovery.configs.authProtocol |
string | SNMP v3의 인증 프로토콜.유효 값: MD5, SHA, SHA224, SHA256, SHA384, SHA512 |
network_devices.autodiscovery.configs.community_string |
string | 커뮤니티 문자열의 시크릿 식별자 |
network_devices.autodiscovery.configs.ignored_ip_addresses |
array[string] | 탐색 중 무시할 IP 주소 목록. |
network_devices.autodiscovery.configs.loader |
string | 이 네트워크 구성에 사용할 체크 로더. |
network_devices.autodiscovery.configs.network_address |
string | SNMP 디바이스를 스캔할 CIDR 네트워크 주소. |
network_devices.autodiscovery.configs.ping.count |
number | 체크당 보낼 ping 패킷 수.유효 값: 1–10 |
network_devices.autodiscovery.configs.ping.enabled |
boolean | ICMP ping 모니터링을 활성화하는 플래그. |
network_devices.autodiscovery.configs.ping.linux.use_raw_socket |
boolean | 권한 있는 ping에 raw 소켓을 사용하는 플래그. |
network_devices.autodiscovery.configs.ping.timeout |
number | ping 요청의 타임아웃(밀리초).유효 값: 100–30000 |
network_devices.autodiscovery.configs.port |
number | SNMP 통신용 UDP 포트.유효 값: 1–65535 |
network_devices.autodiscovery.configs.privKey |
string | 프라이버시 키의 시크릿 식별자 |
network_devices.autodiscovery.configs.privProtocol |
string | SNMP v3 암호화를 위한 프라이버시 프로토콜.유효 값: DES, AES, AES192, AES192C, AES256, AES256C |
network_devices.autodiscovery.configs.snmp_version |
integer | 사용할 SNMP 프로토콜 버전.유효 값: 2, 3 |
network_devices.autodiscovery.configs.tags |
array[string] | 탐색된 디바이스에 붙일 태그 목록. |
network_devices.autodiscovery.configs.user |
string | 인증을 위한 SNMP v3 사용자 이름. |
network_devices.autodiscovery.discovery_interval |
number | 탐색 실행 사이의 간격(초).유효 값: 5–604800 |
network_devices.autodiscovery.loader |
string | 사용할 체크 로더(core 또는 python). |
network_devices.autodiscovery.use_deduplication |
boolean | 동일한 디바이스에 해당하는 IP 주소를 중복 제거. 중복 제거 로직은 sysName, sysDesc, sysObjectID, sysUptime 기반. |
network_devices.autodiscovery.use_device_id_as_hostname |
boolean | 메트릭에 대해 디바이스 ID를 호스트네임으로 사용하는 플래그. |
network_devices.autodiscovery.workers |
number | 디바이스 탐색을 위한 동시 워커 수.유효 값: 1–5000 |
network_devices.netflow.enabled |
boolean | NetFlow 데이터 수집을 활성화하는 플래그. |
network_devices.netflow.listeners |
array[object] | 서로 다른 프로토콜에 대한 흐름 리스너 목록. |
network_devices.netflow.listeners.flow_type |
string | 수신할 흐름 프로토콜의 유형.유효 값: netflow5, netflow9, ipfix, sflow5 |
network_devices.netflow.listeners.port |
number | 흐름 데이터를 수신할 UDP 포트.유효 값: 1–65535 |
네트워크 경로 (network_path)
13개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
network_path.collector.e2e_queries |
number | 정적 경로 테스트를 위한 종단 간 쿼리 수. |
network_path.collector.filters |
array[object] | 네트워크 경로 수집을 위한 포함/제외 필터 목록. 필터는 순차적으로 적용되며 이후 필터가 이전 필터보다 우선함. |
network_path.collector.filters.match_domain |
string | 매칭할 도메인 패턴. |
network_path.collector.filters.match_domain_strategy |
string | 도메인 매칭 전략. 기본은 wildcard.유효 값: wildcard, regex |
network_path.collector.filters.match_ip |
string | 매칭할 IP 주소 또는 CIDR 범위. |
network_path.collector.filters.type |
string | 필터 동작 유형.유효 값: include, exclude |
network_path.collector.max_ttl |
number | traceroute 테스트의 최대 TTL(Time To Live). |
network_path.collector.pathtest_interval |
string | 모니터링되는 연결에 대한 traceroute 실행 간격. |
network_path.collector.pathtest_ttl |
string | 연결이 보이지 않을 때 모니터링되는 지속 시간. 연결이 다시 나타나면 재설정됨. |
network_path.collector.timeout |
number | 네트워크 경로 테스트의 타임아웃(밀리초). |
network_path.collector.traceroute_queries |
number | 정적 경로 테스트를 위한 traceroute 쿼리 수. |
network_path.collector.workers |
integer | 경로를 병렬로 수집할 수 있는 워커 수. |
network_path.connections_monitoring.enabled |
boolean | 네트워크 경로 수집을 활성화하거나 비활성화하는 플래그. |
Observability Pipelines Worker (observability_pipelines_worker)
6개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
observability_pipelines_worker.logs.dual_ship |
boolean | false(기본)일 때 Observability Pipelines Worker가 기본 Datadog 로그 intake를 유일한 목적지로 대체함. true일 때 로그가 기본 Datadog intake와 Observability Pipelines Worker 모두로 전송됨. |
observability_pipelines_worker.logs.dual_ship_reliable |
boolean | dual_ship이 true일 때만 의미가 있음. false(기본)일 때 Observability Pipelines Worker 목적지는 best-effort이며 그 실패가 메인 파이프라인에 백프레셔를 적용하지 않음. true일 때 그 실패가 기본 Datadog 엔드포인트처럼 흐름 제어에 참여함. |
observability_pipelines_worker.logs.enabled |
boolean | Observability Pipelines Worker로 로그 전달을 활성화하는 플래그. |
observability_pipelines_worker.metrics.enabled |
boolean | Observability Pipelines Worker로 메트릭 전달을 활성화하는 플래그. |
observability_pipelines_worker.metrics.use_v3_api.series |
boolean | 메트릭 시리즈 페이로드에 v3 API를 사용하는 플래그. |
observability_pipelines_worker.traces.enabled |
boolean | Observability Pipelines Worker로 트레이스 전달을 활성화하는 플래그. |
Private Action Runner (private_action_runner)
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
private_action_runner.enabled |
boolean | Private Action Runner를 활성화하거나 비활성화하는 플래그. |
프로세스 모니터링 (process_config)
8개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
process_config.blacklist_patterns |
array[string] | 모니터링에서 프로세스를 제외할 정규식 패턴 목록. |
process_config.container_collection.enabled |
boolean | 컨테이너 수집을 활성화하거나 비활성화하는 플래그. |
process_config.custom_sensitive_words |
array[string] | 프로세스 인수에서 스크럽할 커스텀 민감 단어 목록. |
process_config.enabled |
boolean | 프로세스 모니터링을 활성화하거나 비활성화하는 플래그. 대신 process_collection.enabled 또는 container_collection.enabled 사용을 권장 |
process_config.expvar_port |
number | go_expvar 디버그 서버의 포트.유효 값: 1–65535 |
process_config.process_collection.enabled |
boolean | 프로세스 수집을 활성화하거나 비활성화하는 플래그. |
process_config.scrub_args |
boolean | 민감한 프로세스 인수의 스크럽을 활성화하는 플래그. |
process_config.strip_proc_arguments |
boolean | 프로세스 인수의 스크럽을 활성화하는 플래그. |
런타임 보안 (runtime_security_config)
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
runtime_security_config.enabled |
boolean | 런타임 보안을 활성화하거나 비활성화하는 플래그. |
SBOM (sbom)
3개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
sbom.container_image.enabled |
boolean | 컨테이너 취약점 관리를 활성화하거나 비활성화하는 플래그. |
sbom.enabled |
boolean | SBOM을 활성화하거나 비활성화하는 플래그. |
sbom.host.enabled |
boolean | 호스트 취약점 관리를 활성화하거나 비활성화하는 플래그. |
shared_library_check
1개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
shared_library_check.enabled |
boolean | 공유 라이브러리 체크를 활성화하거나 비활성화하는 플래그. |
Synthetics (synthetics)
3개 필드
| 필드 | 타입 | 설명 |
|---|---|---|
synthetics.collector.enabled |
boolean | Synthetics collector를 활성화하거나 비활성화하는 플래그. |
synthetics.collector.flush_interval |
string | collector가 데이터를 플러시하는 빈도 (예: '10s'). |
synthetics.collector.workers |
integer | Synthetics collector의 워커 고루틴 수.유효 값: ≥ 1 |
더 알아보기 (Learn more)
도움이 되는 추가 문서, 링크, 글: