Agent 구성 파일
Datadog Agent 구성 파일이 어디에 있는지, 어떤 구조로 되어 있는지, 그리고 체크와 통합을 어떻게 구성하는지 정리해 드릴게요. 운영 체제별 구성 파일 위치와 conf.d 디렉터리의 체크 구성 파일, JMX 구성 파일까지 차근차근 살펴볼게요.
출처: 문서
본문
메인 구성 파일
Agent 구성 파일의 위치는 운영 체제에 따라 달라져요.
| 플랫폼 | 명령 | 예제 구성 |
|---|---|---|
| AIX | /etc/datadog-agent/datadog.yaml |
datadog.yaml.example |
| Linux | /etc/datadog-agent/datadog.yaml |
datadog-agent_linux.yaml.example |
| macOS | /opt/datadog-agent/etc/datadog.yaml |
datadog-agent_darwin.yaml.example |
| Windows | %ProgramData%\Datadog\datadog.yaml |
datadog-agent_windows.yaml.example |
Agent 구성 디렉터리
Agent 체크와 통합의 구성 파일은 conf.d 디렉터리에 저장돼요. 이 디렉터리의 위치는 운영 체제에 따라 달라져요.
| 플랫폼 | 명령 |
|---|---|
| AIX | /etc/datadog-agent/conf.d/ |
| Linux | /etc/datadog-agent/conf.d/ |
| CentOS | /etc/datadog-agent/conf.d/ |
| Debian | /etc/datadog-agent/conf.d/ |
| Fedora | /etc/datadog-agent/conf.d/ |
| macOS | /opt/datadog-agent/etc/conf.d/ |
| RedHat | /etc/datadog-agent/conf.d/ |
| Source | /etc/datadog-agent/conf.d/ |
| Suse | /etc/datadog-agent/conf.d/ |
| Ubuntu | /etc/datadog-agent/conf.d/ |
| Windows | %ProgramData%\Datadog\conf.d |
참고: 이 디렉터리에 있는 길이가 0인 파일은 Agent가 무시해요. 이는 빈 템플릿 출력을 건너뛰는 것을 지원하지 않는 프로비저닝 시스템을 위한 설계예요.
체크 구성 파일
각 Agent 체크 구성 파일의 예시는 해당 <CHECK_NAME>.d/ 폴더의 conf.yaml.example 파일에서 찾을 수 있어요. 이 파일 이름을 conf.yaml로 바꾸면 연결된 체크가 활성화돼요. 참고: Agent는 /etc/datadog-agent/conf.d/<CHECK_NAME>.d/ 폴더에 포함된 유효한 YAML 파일을 로드해요. 덕분에 복잡한 구성을 여러 파일로 나눌 수 있어요. 예를 들어 http_check 구성은 다음과 같을 수 있어요.
/etc/datadog-agent/conf.d/http_check.d/
├── backend.yaml
└── frontend.yaml
특수한 경우로, .default 접미사가 붙은 YAML 파일이 있어요. 이 파일들은 Agent가 기본적으로 로드하며, 항상 활성화되는 핵심 체크 집합(CPU, memory, uptime 등)을 정의하는 데 도움을 줘요. 해당 체크에 다른 구성이 있으면 무시되므로 안전하게 무시해도 돼요. 기본 체크 하나를 비활성화하고 싶다면 해당 파일을 제거하세요. 이 체크들을 구성하려면 conf.yaml.example을 베이스로 사용해야 해요.
Autodiscovery 템플릿 파일은 auto_conf.yaml 파일로 구성 폴더에 저장돼요. 예를 들어 Redis 체크의 경우 redisdb.d/의 구성은 다음과 같아요.
/etc/datadog-agent/conf.d/redisdb.d/
├── auto_conf.yaml
└── conf.yaml.example
로그 수집의 경우, Agent는 같은 로그 소스를 가리키는 여러 YAML 파일을 허용하지 않아요. 이는 중복 로그가 Datadog로 전송되는 것을 방지하기 위해서예요. 같은 로그 소스를 가리키는 YAML 파일이 둘 이상이라면 Agent는 파일을 알파벳 순서로 고려해 첫 번째 파일을 사용해요.
JMX 구성 파일
JMX Agent 체크에는 구성 폴더에 추가로 metrics.yaml 파일이 있어요. 이 파일은 Datadog Agent가 기본적으로 수집하는 모든 빈(bean) 목록이에요. 덕분에 Docker labels 또는 k8s annotations를 통해 체크를 구성할 때 모든 빈을 수동으로 나열할 필요가 없어요.