[ Datadog ] datadog.yaml 설정 가이드

Print

Datadog Agent의 주요 설정을 위한 설정 파일인 Datadog.yaml 파일에 대한 설정 가이드를 제공합니다.

사용 가능한 모든 설정 옵션은 datadog에서 제공하는 config_template.yaml 파일을 참조하세요.

※이 가이드는 Agent v6 및 v7에 대한 내용만 안내합니다.

Datadog.yaml 파일 경로

datadog.yaml 파일은 각 플랫폼별로 아래와 같은 경로에서 확인 가능 합니다.

플랫폼

명령어

AIX

/etc/datadog-agent/datadog.yaml

Linux

/etc/datadog-agent/datadog.yaml

macOS

~/.datadog-agent/datadog.yaml

Windows

%ProgramData%\Datadog\datadog.yaml

주요 설정 항목

1. Basic Configuration

- 필수 설정 필요 항목

항목

기본설정

환경변수

설명

api_key

DD_API_KEY

Datadog agent의 수집 데이터를 전송할 ORG의 api key(Organization Setting>Api Key)를 설정합니다.

site

datadoghq.com

DD_SITE

data가 수집되는 datadog site를 설정합니다.

US1 : datadoghq.com
EU : datadoghq.eu
US3 : us3.datadoghq.com
US5 : us5.datadoghq.com
AP1 : ap1.datadoghq.com
US1-FED : ddog-gov.com

- 주요 설정 항목

항목

기본설정

환경변수

설명

dd_url

DD_DD_URL
DD_URL

Proxy 등 agent에서 바로 datadog로 전송하지 않고 특정 서버를 통해 전송하는 경우 해당 url 및 ip/port를 설정합니다. dd_url 설정 참고 가이드

proxy

DD_PROXY_HTTP
DD_PROXY_HTTPS
DD_PROXY_HTTPS

인터넷에 연결하기 위해 proxy가 필요한 경우 설정합니다. proxy 설정 참고 가이드

skip_ssl_validation

flase

DD_SKIP_SSL_VALIDATION

SSL/TLS 인증서 유효성 검사를 건너뛸지 여부를 설정합니다.

hostname

DD_HOSTNAME

hostname을 지정합니다.

hostname결정 방식 참고 가이드

hostname_fqdn

flase

DD_HOSTNAME_FQDN

에이전트 호스트 이름에 대한 FQDN 사용을 활성화여부를 설정합니다.

- Tag 설정

항목

설정 참고

환경변수

설명

env

env: prod

DD_ENV

Agent가 설치된 서버의 실행 환경 Tag를 설정합니다. env Tag는 필수적으로 설정하시기 바랍니다.

tags

tags:
- service:test
- os:linux
- category:aws
- location:

DD_TAGS

metric, event, log, trace, service check등에 추가되는 tag를 설정합니다.
service, os Tag는 되도록이면 설정하시기 바랍니다.

그외 그룹화 모니터링이 필요한 경우, 그룹핑할 tag를 자유롭게 추가 가능합니다.

(참고 : Tag 설정시 tagname:tagvalue 와 같이 :전후에 space(빈칸)없이 설정합니다.)

참고 가이드 : Tag 시작 하기 가이드

2. Advanced Configuration.

- 주요 설정 항목

항목

기본설정

환경변수

설명

expvar_port

5000

DD_EXPVAR_PORT

agent 런타임 메트릭을 노출할 port를 설정합니다.
변경관련 참고 가이드

cmd_port

5001

DD_CMD_PORT

에이전트 CLI 및 GUI에서 명령을 보내고 실행중인 에이전트에서 정보를 가져오는 데 사용될 port를 설정합니다.
변경관련 참고 가이드

GUI_port

5002

DD_GUI_PORT

Windows 및 osx에서 GUI 서버를 제공하는 port를 설정합니다.
변경관련 참고 가이드

check_runners

4

DD_CHECK_RUNNERS

동시에 처리할 검사할 실행기(service check, ssh, http 등 check 성격의 검사에 대한 실행기) 개수를 설정합니다.

  • 주의 : check runner가 너무 많아지면 리소스가 높아질 수 있습니다.

enable_gohai

true

DD_ENABLE_GOHAI

Infrastructure에서 Host Info에 표시되는 시스템 정보 목록을 수집할 지 여부를 설정합니다. false 설정시 수집되지 않습니다. 참고 가이드

3. Log collection Configuration

- 주요 설정 항목

항목

기본설정

환경변수

설명

logs_enabled

false

DD_LOGS_ENABLED

log 수집 여부를 설정합니다.
로그 수집 활성화 가이드

logs_config:
container_collect_all:

false

DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL

모든 컨테이너에 대한 컨테이너 로그 수집 여부를 설정합니다. (container 환경에서만 사용합니다.) 설정 참고 가이드

logs_config:
logs_dd_url:

DD_LOGS_CONFIG_DD_URL

proxy사용시 log data를 전달할 엔드포인트와 port를 정의 합니다. TCP연결을 처리할 수 있어야 합니다.
로그를 위한 TCP Agent 프록시 참고

logs_config:
logs_no_ssl:

false

DD_LOGS_CONFIG_LOGS_NO_SSL

SSL 암호화를 비활성화 여부를 설정합니다. 로그가 로컬에서 프록시로 전달되는 경우에만 사용합니다.
로그를 위한 TCP Agent 프록시 참고

logs_config:
processing_rules:
- type: <RULE_TYPE>
name: <RULE_NAME>
pattern: <RULE_PATTERN>

DD_LOGS_CONFIG_PROCESSING_RULES

로그 수집에 대한 RULE을 설정합니다.
필터링, 스크러빙, 멀티라인 등을 설정할 수 있습니다.
datadog.yaml 파일에 설정하는 rule은 전역으로 적용됩니다.

고급 로그 수집- Global 처리 규칙 설정 참고

logs_config:
open_files_limit:

500

DD_LOGS_CONFIG_OPEN_FILES_LIMIT

동시에 수집 가능한 파일 최대 수 설정을 합니다.(agent status 확인시 Log 항목에 표시되는 log 파일의 최대수입니다.)

logs_config:
file_wildcard_selection_mode:

by_name

DD_LOGS_CONFIG_FILE_WILDCARD_SELECTION_MODE

폴더 혹은 * 로 여러개의 파일 수집을 지정할 때 총 파일 수가 open_files_limit 이상일경우 수집할 log 파일을 선택하는 기준을 설정합니다.

고급 로그수집 참고

logs_config:
max_message_size_bytes:

256000

DD_LOGS_CONFIG_MAX_MESSAGE_SIZE_BYTES

단일 로그 메세지의 최대 크기(byte)를 설정합니다.
주의사항:API 제한인 1MB를 초과해 설정 하는경우, 1MB 이상의 페이로드는 모두 삭제됩니다.

Log를 수집 및 고급 설정 등에 대해선 아래 가이드를 참고하세요

4. Trace collection Configuration

- 주요 설정 항목

항목

기본설정

환경변수

설명

apm_config:
enabled:

true

DD_APM_ENABLED

APM 수집 여부를 설정합니다.

apm_config:
apm_dd_url:

DD_APM_DD_URL

APM용 프록시를 사용할 때 엔드포인트와 포트를 정의합니다. 추적은 TCP로 전달되므로 프록시는 TCP 연결을 처리할 수 있어야 합니다.

apm_config:
max_traces_per_second:
errors_per_second:
max_events_per_second:


10
10
200

DD_APM_MAX_TPS
DD_APM_ERROR_TPS
DD_APM_MAX_EPS

샘플링에 대한 설정을 합니다.
Ingestion Mechanisms
추적 샘플링 사용사례 참고

apm_config:
max_memory:
max_cpu_percent:
connection_limit:


500000000
50
2000

DD_APM_MAX_MEMORY
DD_APM_MAX_CPU_PERCENT
DD_APM_CONNECTION_LIMIT

APM에 대한 비율을 제한합니다.

Agent 비율 제한 참고

Tracing(APM) 수집 및 설정 등에 대해선 아래 가이드를 참고하세요

5. Process collection Configuration

- 주요 설정 항목

항목

기본설정

환경변수

설명

process_config:
process_collection:
enabled:

false

DD_PROCESS_AGENT_PROCESS_COLLECTION_ENABLED

Process 수집 여부를 설정합니다.
실시간 프로세스 참고

process_config:
process_dd_url:

DD_PROCESS_AGENT_URL

프록시를 사용할 때 Process용 엔드포인트와 포트를 정의합니다.

이 답변이 유용합니까? 아니오

Send feedback
도움이 되어드리지 못해 죄송합니다. 아티클 개선을 위해 의견을 제공해 주시기 바랍니다.