참고: 도커(Docker) Daemon 점검은 여전히 지원되나 에이전트 v5에서만 동작합니다.

개요

다음과 같이 본 에이전트 점검을 설정하여 Docker_daemon 서비스에서 메트릭을 실시간으로 가져옵니다.

• Docker_daemon 상태를 시각화 및 모니터링합니다.
• Docker_daemon 오류 및 이벤트에 대한 알림을 받습니다.

설정

설치

모든 컨테이너에서 도커(Docker) 메트릭을 수집하려면 모든 호스트에서 Datadog 에이전트 하나를 실행합니다. 각 호스트에서 에이전트를 직접 실행하거나 docker-dd-agent 컨테이너(권장) 내에서 실행하는 두 가지 방법이 있습니다.

두 옵션 모두 도커(Docker) 점검을 완료하려면 호스트의 cgroup 메모리 관리가 활성화되어 있어야 합니다. 활성화하는 방법을 확인하려면 docker-dd-agent 리포지토리를 참조하세요.

호스트 설치

1. 도커(Docker)가 호스트에서 실행 중인지 확인합니다.
2. 호스트 OS용 에이전트 설치 지침에 설명된 대로 에이전트를 설치합니다.
3. [애플리케이션에서 도커(Docker) 통합 타일]을 활성화합니다5.
4. usermod -a -G docker dd-agent 도커(Docker) 그룹에 에이전트 사용자를 추가합니다.
5. [에이전트 conf.d 디렉토리의 예제 파일6을 복사하여 docker_daemon.yaml 파일을 생성합니다. 호스트에 도커(Docker)를 표준 설치한 경우 통합을 실행하기 위해 이를 변경하지 않아도 됩니다.
6. 추가 통합을 활성화하려면 docker ps으로 해당 애플리케이션에서 사용하는 포트를 식별하세요.

컨테이너 설치

1. 도커(Docker)가 호스트에서 실행 중인지 확인합니다.

2. 도커(Docker) 컨테이너 설치 지침에 따라 다음을 실행합니다.

    docker run -d --name dd-agent \
      -v /var/run/docker.sock:/var/run/docker.sock:ro \
      -v /proc/:/host/proc/:ro \
      -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
      -e API_KEY={YOUR_DD_API_KEY} \
      datadog/docker-dd-agent:latest
   

위의 명령에서는 도커(Docker) 의 -e 환경 변수 플래그로 Datadog 에이전트에 API 키를 전달할 수 있습니다. 다른 변수는 다음과 같습니다.

참고: 에이전트 재시작을 되도록 줄이려면 --restart=unless-stopped를 추가합니다.

아마존 리눅스에서 에이전트 컨테이너 실행하기

아마존 리눅스에서 Datadog 에이전트 컨테이너를 실행하려면 다음과 같이 cgroup 볼륨 마운트 위치로 변경합니다.

docker run -d --name dd-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /cgroup/:/host/sys/fs/cgroup:ro \
  -e API_KEY={YOUR API KEY} \
  datadog/docker-dd-agent:latest

컨테이너 기반 Alpine Linux

표준 도커(Docker) 이미지는 데비안(Debian) Linux에 기반하나, Datadog 에이전트 v5.7부터는 Alpine Linux 기반 이미지를 제공합니다. Alpine Linux 이미지는 기존 데비안(Debian) 기반 이미지보다 크기가 상당히 작습니다. 또한 Alpine의 보안 지향적 디자인을 계승합니다.

Alpine Linux 이미지를 사용하려면 -alpine을 버전 태그에 추가합니다. 예시:

docker run -d --name dd-agent \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -v /proc/:/host/proc/:ro \
  -v /sys/fs/cgroup/:/host/sys/fs/cgroup:ro \
  -e API_KEY={YOUR API KEY} \
  datadog/docker-dd-agent:latest-alpine

이미지 버전 관리

Datadog 에이전트 버전 5.5.0부터 도커(Docker) 이미지는 새로운 버전 관리 패턴을 따릅니다. 따라서 Datadog은 동일한 에이전트 버전으로 Datadog 에이전트의 도커(Docker) 이미지 변경 사항을 릴리스합니다.

도커(Docker) 이미지 버전은 다음과 같은 패턴을 갖습니다. X.Y.Z에서 X는 도커(Docker) 이미지의 메이저 버전, Y는 마이너 버전, Z는 에이전트 버전을 나타냅니다.

예를 들어 Datadog 에이전트 5.5.0을 번들로 제공하는 도커(Docker) 이미지의 첫 번째 버전은 10.0.550입니다.

컨테이너 사용자 지정 및 추가 정보

Datadog 에이전트, Alpine Linux 기반 이미지, 버전 관리 등을 사용하여 커스텀 도커(Docker) 컨테이너를 빌드하는 방법에 대한 자세한 내용을 확인하려면 Github의 docker-dd-agent 프로젝트를 참조하세요.

검증

에이전트 상태 하위 명령을 실행하고 점검 섹션에서 docker_daemon를 찾으세요.

에이전트 v6

최신 도커(Docker) 점검은 docker로 명명되며 새로운 내부 아키텍처를 활용하기 위해 Go로 작성되었습니다. 에이전트 v6.0이후로는 docker_daemon 점검은 에이전트 v5에서 계속 사용 가능하고 유지되더라도 로드되지 않습니다. 다음과 같은 지원 중단 항목을 제외한 모든 기능은 6.0 이상 버전에서 포트됩니다.

• url, api_version, tags* 옵션 지원이 중단됩니다. 표준 도커 환경 변수를 직접 사용하시길 권장합니다.
• ecs_tags, performance_tags, container_tags 옵션 지원이 중단됩니다. 기본적으로 관련 태그는 전부 자동으로 수집합니다.
• docker.container.count 메트릭을 활성화하는 collect_container_count 옵션은 지원되지 않습니다. docker.containers.running 및 .stopped를 사용하세요.

일부 옵션은 docker_daemon.yaml에서 주요 datadog.yaml로 이동했습니다.

• collect_labels_as_tags의 이름이 docker_labels_as_tags로 바뀌었으며 카디널리티(cardinality)가 높은 태그를 지원합니다. 자세한 정보를 확인하려면 datadog.yaml.example를 참조하세요.
• exclude 및 include 리스트의 이름이 ac_include 및 ac_exclude로 변경되었습니다 . 이제 에이전트의 모든 컴포넌트에서 필터를 일관적으로 적용하기 위해 임의의 태그로 필터링하지 않아도 됩니다. 태그 필터링은 image(이미지명) 및 name(컨테이너명)만 지원됩니다. 정규식 필터링은 계속 사용할 수 있습니다. 예시를 확인하려면 datadog.yaml.example를 참조하세요.
• docker_root 옵션은 두 가지 옵션(container_cgroup_root, container_proc_root)으로 나뉘었습니다.
• exclude_pause_container를 추가하여 쿠버네티스(Kubernetes)와 Openshift에서 일시 중지된 컨테이너를 제외합니다(기본값: true). 오류로 인해 제외 목록에서 삭제되는 것을 방지할 수 있습니다.

추가 변경 사항:

• TAGS 환경 변수의 이름이 DD_TAGS로 변경되었습니다.
• 도커(Docker) 허브 리포지토리가 datadog/docker-dd-agent에서 datadog/agent로 변경되었습니다.

import 명령은 기존 docker_daemon.yaml을 신규 docker.yaml으로 변환합니다. 또한 필요한 설정을 docker_daemon.yaml에서 datadog.yaml로 이동합니다.

수집한 데이터

메트릭

이벤트

도커(Docker) 통합은 다음 이벤트를 생성합니다.

• Delete Image
• Die
• 오류
• Fail
• Kill
• Out of memory (oom)
• Pause
• Restart container
• Restart Daemon
• 업데이트

서비스 점검

docker.service_up
Returns CRITICAL if the Agent is unable to collect the list of containers from the Docker daemon. Returns OK otherwise.
Statuses: ok, critical

docker.container_health
Returns CRITICAL if a container is unhealthy. Returns OK otherwise or UNKNOWN if the health is unknown.
Statuses: ok, critical, unknown

docker.exit
Returns CRITICAL if a container exited with a non-zero exit code. Returns OK otherwise.
Statuses: ok, critical

참고: docker.exit를 사용하려면 도커(Docker) YAML file 파일에 collect_exit_codes: true를 추가하고 에이전트를 다시 시작합니다.

트러블슈팅

도움이 필요하신가요? Datadog 고객 지원팀에 문의해주세요.

참고 자료

• 구성 및 Datadog 에이전트
• DogStatsD 및 도커(Docker)
• 도커(Docker) 모니터링 문제 (시리즈)
• 도커(Docker) 리소스 메트릭 모니터링 방법
• 도커(Docker) 메트릭 수집 방법
• 실제 도커(Docker) 도입에 대한 8가지 놀라운 사실
• AWS ECS에서 도커(Docker) 모니터링하기
• Datadog 도커화
• Datadog으로 도커(Docker) 모니터링하기