Agent 환경 변수

Agent v5의 경우 Docker Agent GitHub 리포지토리를 참조하세요.

개요

Agent v6의 경우 Agent 기본 구성 파일(datadog.yaml)에 있는 대부분의 구성 옵션을 환경 변수를 통해 설정할 수 있습니다. 사용 가능한 모든 datadog.yaml 설정에 대한 전체 주석이 포함된 참조는 Datadog Agent GitHub 리포지토리의 예시 구성 파일을 참조하세요.

권장 사항

Datadog에서는 태그를 할당할 때 unified service tagging을 사용하는 것을 모범 사례로 권장합니다. unified service tagging은 Datadog env, service, version의 세 가지 표준 태그를 사용하여 Datadog 텔레메트리를 연결합니다. 환경을 unified service tagging을 사용하여 구성하는 방법은 unified service tagging documentation을 참조하세요.

일반적인 사용

일반적으로 다음 규칙을 사용합니다.

옵션 이름은 DD_ 접두사를 사용하여 대문자로 표기해야 합니다. hostname -> DD_HOSTNAME
목록 값은 공백으로 구분되어야 합니다(포함 규칙은 정규식을 지원하며 쉼표로 구분된 문자열 목록으로 정의됨):
```
   container_include:
     - "image:cp-kafka"
     - "image:k8szk"
   # DD_CONTAINER_INCLUDE="image:cp-kafka image:k8szk"
```
미리 정의된 키가 있는 구성 옵션의 중첩은 밑줄로 구분해야 합니다.
```
   cluster_agent:
     cmd_port: 5005
   # DD_CLUSTER_AGENT_CMD_PORT=5005
```

사용자 정의 키가 포함된 구성 옵션의 중첩은 JSON 형식이어야 합니다.

   container_env_as_tags:
     ENVVAR_NAME: tag_name
   # DD_CONTAINER_ENV_AS_TAGS='{"ENVVAR_NAME": "tag_name"}'

속성 정의 우선순위

속성이 전역 구성 파일(datadog.yaml)과 환경 변수에 모두 정의된 경우, 환경 변수가 우선합니다.
환경 변수로 중첩된 옵션을 지정하면 구성 옵션 아래에 지정된 모든 중첩 옵션이 재정의됩니다. 이 규칙의 예외는 proxy 구성 옵션입니다. 자세한 내용은 Agent 프록시 설명서를 참조하세요.

예외

모든 datadog.yaml 옵션을 환경 변수로 사용할 수 있는 것은 아닙니다. Datadog Agent GitHub 리포지토리의 core_schema.yaml 구성 스키마를 참조하세요. 스키마에서 no-env 태그가 지정된 설정은 환경 변수를 지원하지 않습니다.
이전 Agent 버전의 경우, 구성 소스가 위치를 옮겼습니다.
Agent 버전 구성 소스
7.51~7.83 *_settings.go 7.83.x branch의 pkg/config/setup 내 파일
7.50 및 이전 버전 7.50.x branch의 config.

Agent 버전	구성 소스
7.51~7.83	`*_settings.go` 7.83.x branch의 pkg/config/setup 내 파일
7.50 및 이전 버전	7.50.x branch의 config.

core_schema.yaml에 나열되지 않은 구성요소별 환경 변수도 지원될 수 있습니다.

구성요소	구성 소스	Agent 7.51~7.83	Agent 7.50 및 이전 버전
APM Trace Agent	apm_config.yaml, Docker APM Agent 환경 변수	`apm_settings.go` 7.83.x branch의 pkg/config/setup	`apm.go` 7.50.x branch의 pkg/config
Live Process Agent	process_config.yaml	`process_settings.go` 7.83.x branch의 pkg/config/setup	`process.go` 7.50.x branch의 pkg/config
OTLP Ingest	core_schema.yaml(otlp_config)	`otlp_settings.go` 7.83.x branch pkg/config/setup	`otlp.go` 7.50.x branch pkg/config
System Probe	system-probe_schema.yaml	`system_probe_settings.go` 7.83.x branch의 pkg/config/setup	`system_probe.go` 7.50.x branch pkg/config
Private Action Runner	private_action_runner.yaml	`privateactionrunner_settings.go` 7.83.x branch pkg/config/setup	사용 불가
Multi-Region Failover	multi_region_failover.yaml	`multi_region_failover_settings.go` 7.83.x branch pkg/config/setup	사용 불가

APM Trace Agent 예시:

   apm_config:
       enabled: true
       env: dev
   # DD_APM_ENABLED=true
   # DD_APM_ENV=dev

Live Process Agent 예시:

   process_config:
       process_collection:
           enabled: true
       process_dd_url: https://process.datadoghq.com
   # DD_PROCESS_AGENT_PROCESS_COLLECTION_ENABLED=true
   # DD_PROCESS_AGENT_URL=https://process.datadoghq.com

systemd 유닛에서 환경 변수를 사용

systemd를 사용하여 서비스를 관리하는 운영 체제에서는 일반적으로 환경 변수(전역(예: /etc/environment) 또는 세션 기반(예: export VAR=value))가 서비스에 제공되지 않으며, 별도로 구성해야 합니다. 자세한 내용은 systemd Exec 매뉴얼 페이지를 참조하세요.

Datadog Agent 7.45부터 Datadog Agent 서비스(datadog-agent.service 단위)는 선택적으로 파일(<ETC_DIR>/environment)에서 환경 변수 할당을 로드할 수 있습니다.

존재하지 않으면 /etc/datadog-agent/environment를 생성합니다.
새 줄로 구분된 환경 변수 할당을 정의합니다. 예:

GODEBUG=x509ignoreCN=0,x509sha1=1
DD_HOSTNAME=myhost.local
DD_TAGS=env:dev service:foo

변경 사항을 적용하려면 서비스를 다시 시작합니다.

추가 자료

추가적인 유용한 설명서, 링크 및 기사:

Docker Agent 환경 변수설명서

APM Agent 환경 변수설명서

컨테이너 로그 수집설명서

프록시 환경 변수설명서