참고: Docker Daemon 점검은 여전히 지원되나 Agent v5에서만 동작합니다.

개요

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

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

설정

설치

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

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

호스트 설치

1. Docker가 호스트에서 실행 중인지 확인합니다.
2. 호스트 OS용 Agent 설치 지침에 설명된 대로 Agent를 설치합니다.
3. 애플리케이션에서 Docker 통합 타일을 활성화합니다.
4. usermod -a -G docker dd-agent Docker 그룹에 Agent 사용자를 추가합니다.
5. Agent conf.d 디렉터리의 예제 파일을 복사하여 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 Agent에 API 키를 전달할 수 있습니다. 다른 변수는 다음과 같습니다.

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

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

아마존 리눅스에서 Datadog Agent 컨테이너를 실행하려면 다음과 같이 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 Agent 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 Agent 버전 5.5.0부터 Docker 이미지는 새로운 버전 관리 패턴을 따릅니다. 따라서 Datadog은 동일한 Agent 버전으로 Datadog Agent의 Docker 이미지 변경 사항을 릴리스합니다.

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

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

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

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

검증

Agent 상태 하위 명령을 실행하고 Checks 섹션에서 docker_daemon을 찾습니다.

Agent v6

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

• url, api_version, tags* 옵션 지원이 중단됩니다. 표준 Docker 환경 변수를 직접 사용하시길 권장합니다.
• 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로 변경되었습니다 . 이제 Agent의 모든 컴포넌트에서 필터를 일관적으로 적용하기 위해 임의의 태그로 필터링하지 않아도 됩니다. 태그 필터링은 image(이미지명) 및 name(컨테이너명)만 지원됩니다. 정규식 필터링은 계속 사용할 수 있습니다. 예시를 확인하려면 datadog.yaml.example를 참조하세요.
• docker_root 옵션은 두 가지 옵션(container_cgroup_root, container_proc_root)으로 나뉘었습니다.
• exclude_pause_container를 추가하여 쿠버네티스(Kubernetes)와 Openshift에서 일시 중지된 컨테이너를 제외합니다(기본값: true). 오류로 인해 제외 목록에서 삭제되는 것을 방지할 수 있습니다.

추가 변경 사항:

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

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

수집한 데이터

Metrics

이벤트

Docker 통합은 다음 이벤트를 생성합니다.

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

서비스 점검

docker.service_up

Agent가 Docker Daemon에서 컨테이너 목록을 수집할 수 없는 경우 CRITICAL을, 그렇지 않으면 OK를 반환합니다.

상태: ok, critical

docker.container_health

컨테이너가 정상 상태가 아닌 경우 CRITICAL을 반환합니다. 그렇지 않으면 OK, 상태를 알 수 없는 경우 UNKNOWN을 반환합니다.

상태: ok, critical, unknown

docker.exit

컨테이너가 0이 아닌 종료 코드로 종료된 경우 CRITICAL을, 그렇지 않으면 OK를 반환합니다.

상태: ok, critical

트러블슈팅

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

참고 자료

• Compose 및 Datadog Agent
• DogStatsD 및 Docker
• Docker 모니터링 문제(시리즈)
• Docker 리소스 메트릭 모니터링 방법
• Docker 메트릭 수집 방법
• 실제 Docker 도입에 대한 8가지 놀라운 사실
• Amazon ECS에서 Docker 모니터링하기
• Datadog을 Docker로 컨테이너화하기
• Datadog으로 Docker 모니터링하기

Further Reading

추가 유용한 문서, 링크 및 기사:

Docker Daemon 문서설명서 Docker Daemon 문서설명서 Docker 모니터링 문제블로그 Docker 리소스 메트릭 모니터링 방법블로그 Docker 메트릭 수집 방법블로그 실제 Docker 도입에 관한 8가지 놀라운 사실설명서