호스트 모니터링을 위해 Datadog 에이전트를 포함하는 Docker 컨테이너를 실행하려면 각 운영 체제에 다음 명령을 사용합니다.

Linux

다음 구성에서 <DD_SITE>를 로 바꿉니다.

docker run -d --name datadog-agent \
           --cgroupns host \
           --pid host \
           -e DD_API_KEY=<DATADOG_API_KEY> \
           -e DD_LOGS_ENABLED=true \
           -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
           -e DD_CONTAINER_EXCLUDE="name:datadog-agent" \
           -e DD_SITE=<DD_SITE>
           -v /var/run/docker.sock:/var/run/docker.sock:ro \
           -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
           -v /proc/:/host/proc/:ro \
           -v /opt/datadog-agent/run:/opt/datadog-agent/run:rw \
           -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
           gcr.io/datadoghq/agent:latest

Windows

다음 구성에서 <DD_SITE>를 로 바꿉니다.

docker run -d --name datadog-agent \
           --cgroupns host \
           --pid host \
           -e DD_API_KEY=<DATADOG_API_KEY> \
           -e DD_LOGS_ENABLED=true \
           -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
           -e DD_CONTAINER_EXCLUDE="name:datadog-agent" \
           -e DD_SITE=<DD_SITE>
           -v \\.\pipe\docker_engine:\\.\pipe\docker_engine \
           -v c:\programdata\docker\containers:c:\programdata\docker\containers:ro
           gcr.io/datadoghq/agent:latest

macOS

Docker Desktop -> Settings -> Resources -> File sharing 아래에 /opt/datadog-agent/run 경로를 추가합니다.

다음 구성에서 <DD_SITE>를 로 바꿉니다.

docker run -d --name datadog-agent \
           --cgroupns host \
           --pid host \
           -e DD_API_KEY=<DATADOG_API_KEY> \
           -e DD_LOGS_ENABLED=true \
           -e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true \
           -e DD_LOGS_CONFIG_DOCKER_CONTAINER_USE_FILE=true \
           -e DD_CONTAINER_EXCLUDE="name:datadog-agent" \
           -e DD_SITE=<DD_SITE>
           -v /var/run/docker.sock:/var/run/docker.sock:ro \
           -v /var/lib/docker/containers:/var/lib/docker/containers:ro \
           -v /opt/datadog-agent/run:/opt/datadog-agent/run:rw \
           gcr.io/datadoghq/agent:latest

최신 버전의 Datadog 에이전트를 선택할 것을 권장합니다. GCR에서 사용 가능한 에이전트 v6용 이미지의 전체 목록을 참고하세요.

로그 수집과 관련된 명령은 다음과 같습니다:

-e DD_LOGS_ENABLED=true

true로 설정하면 로그 수집을 활성화합니다. 에이전트가 설정 파일에서 로그 지시사항을 찾습니다.

-e DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL=true

모든 컨테이너에 대한 로그 수집을 활성화하는 로그 설정을 추가합니다.

-v /opt/datadog-agent/run:/opt/datadog-agent/run:rw

다시 시작하거나 네트워크 문제가 발생하는 동안 컨테이너 로그 손실을 방지하기 위해 디렉터리의 각 컨테이너에 수집된 마지막 로그 행이 호스트에 저장됩니다.

-e DD_CONTAINER_EXCLUDE="name:datadog-agent"

Datadog 에이전트가 자체 로그 및 메트릭을 수집하고 전송하지 못하도록 합니다. Datadog 에이전트 로그 또는 메트릭을 수집하려면 이 매개변수를 제거하세요. 이 매개변수 값은 정규 표현식을 지원합니다.

-v /var/run/docker.sock:/var/run/docker.sock:ro

Docker 데몬에 연결하여 컨테이너를 검색하고 Docker 소켓에서 stdout/stderr를 수집합니다.

-v /var/lib/docker/containers:/var/lib/docker/containers:ro

파일에서 컨테이너 로그를 수집합니다. Datadog 에이전트 6.27.0/7.27.0+에서 사용할 수 있습니다.

참고: Docker Compose를 사용하는 경우 DD_CONTAINER_EXCLUDE 값을 따옴표에 넣어서는 안 됩니다. docker-compose.yaml 파일 환경 변수를 아래 예시와 같이 구성하세요.

environment:
    - DD_CONTAINER_EXCLUDE=image:datadog/agent:*

1. 호스트에 최신 버전의 에이전트를 설치합니다.

2. Datadog 에이전트에서 로그 수집은 기본적으로 _사용 안 함_으로 설정되어 있습니다. 활성화하려면 datadog.yaml 설정 파일에 다음 행을 추가합니다.

   logs_enabled: true
   listeners:
       - name: docker
   config_providers:
       - name: docker
         polling: true
   logs_config:
       container_collect_all: true
   

3. Windows 10 전용: Docker 컨테이너로 작업할 수 있는 권한을 가지려면 Datadog 에이전트 사용자가 docker-users 그룹의 구성원이어야 합니다. 관리자 명령 프롬프트에서 net localgroup docker-users "ddagentuser" /ADD 를 실행하거나 Docker User Group 설정 단계를 따릅니다.

4. 에이전트 재시작을 클릭하여 Datadog의 모든 컨테이너 로그를 확인합니다.

1. 호스트에 최신 버전의 에이전트를 설치합니다.

2. 사용자 지정 로그 수집 설명서에 따라 로그 파일을 추적합니다.

   <PATH_LOG_FILE>/<LOG_FILE_NAME>.log에 저장된 <APP_NAME> 애플리케이션에서 로그를 수집하려면 에이전트 설정 디렉터리 루트에서 다음 내용을 포함하여 <APP_NAME>.d/conf.yaml파일을 생성하세요.

   logs:
     - type: file
       path: "<PATH_LOG_FILE>/<LOG_FILE_NAME>.log"
       service: "<APP_NAME>"
       source: "<SOURCE>"
   

3. 에이전트 재시작을 클릭하여 Datadog의 모든 컨테이너 로그를 확인합니다.

참고: 에이전트가 사용자 지정 로그 설정을 사용하여 컨테이너에서 생성된 로그를 수집하려면 호스트에서 접근할 수 있는 볼륨에 로그를 기록해야 합니다. 컨테이너 로그는 stdout와 stderr에 기록하여 자동으로 수집할 수 있도록 하는 것이 좋습니다.

다음 LABEL을 Dockerfile 에 추가합니다.

LABEL "com.datadoghq.ad.logs"='[<LOGS_CONFIG>]'

다음 라벨을 docker-compose.yaml 파일에 추가합니다.

labels:
    com.datadoghq.ad.logs: '["<LOGS_CONFIG>"]'

다음 라벨을 실행 명령으로 추가합니다.

-l com.datadoghq.ad.logs='[<LOGS_CONFIG>]'

다음 Docker 파일은 해당 컨테이너에서 NGINX 로그 통합을 활성화합니다(service값은 변경 가능):

LABEL "com.datadoghq.ad.logs"='[{"source": "nginx", "service": "webapp"}]'

메트릭 및 로그 NGINX 통합을 모두 사용하도록 설정하는 방법:

LABEL "com.datadoghq.ad.check_names"='["nginx"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"nginx_status_url": "http://%%host%%:%%port%%/nginx_status"}]'
LABEL "com.datadoghq.ad.logs"='[{"source": "nginx", "service": "webapp"}]'

스택 트레이스(stack trace) 같은 다중 행 로그의 경우 에이전트에는 다중 행 처리 규칙이 있어 행을 단일 로그로 집계할 수 있습니다.

로그 예제(Java 스택 트레이스):

2018-01-03T09:24:24.983Z UTC Exception in thread "main" java.lang.NullPointerException
        at com.example.myproject.Book.getTitle(Book.java:16)
        at com.example.myproject.Author.getBookTitles(Author.java:25)
        at com.example.myproject.Bootstrap.main(Bootstrap.java:14)

컨테이너에 아래와 같은 com.datadoghq.ad.logs 라벨을 사용하여 위의 로그가 올바르게 수집되었는지 확인합니다.

labels:
    com.datadoghq.ad.logs: '[{"source": "java", "service": "myapp", "log_processing_rules": [{"type": "multi_line", "name": "log_start_with_date", "pattern" : "\\d{4}-(0?[1-9]|1[012])-(0?[1-9]|[12][0-9]|3[01])"}]}]'

자세한 패턴 예제를 보려면 다중 행 처리 규칙 설명서을 참고하세요.

에이전트 v7.25.0+/6.25.0+는 컨테이너 자동 탐지 라벨을 기반으로 파일에서 로그를 직접 수집할 수 있습니다. 이러한 로그를 수집하려면 컨테이너에 아래와 같은 com.datadoghq.ad.logs 라벨을 사용하여 /logs/app/prod.log를 수집합니다.

labels:
    com.datadoghq.ad.logs: '[{"type":"file", "source": "sample_app", "service": "sample_service", "path": "/logs/app/prod.log"}]'

파일에서 수집된 로그에는 컨테이너 메타데이터 태그가 지정됩니다. 로그 수집은 컨테이너 수명 주기와 연결되며, 컨테이너가 중지되는 즉시 해당 파일에서의 로그 수집이 중지됩니다.

참고:

• 파일 경로는 에이전트와 관련이 있으므로 파일을 포함하는 디렉터리는 애플리케이션을 실행하는 컨테이너와 에이전트 컨테이너 간에 공유되어야 합니다. 예를 들어, 컨테이너가 /logs를 연결하는 경우 파일에 로깅하는 각 컨테이너가 로그 파일이 작성되는/logs/app와 같은 볼륨을 연결할 수 있습니다.

• 컨테이너에서 이런 종류의 라벨을 사용할 때 stderr/stdout 로그는 자동으로 수집되지 않습니다. stderr/stdout 및 파일에서 수집이 필요한 경우 다음과 같이 라벨을 사용하여 명시적으로 활성화해야 합니다.

labels:
    com.datadoghq.ad.logs: '[{"type":"file", "source": "java", "service": "app", "path": "/logs/app/prod.log"}, {"type": "docker", "source": "app_container", "service": "app"}]'

• 이러한 종류의 조합을 사용하는 경우 source 및 service는 기본값이 없으며 자동 탐지 라벨에 명시적으로 설정되어야 합니다.