Amazon ECS

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

컨테이너화된 Datadog 에이전트를 ECS 클러스터에 배포하려 하시나요? Amazon ECS 에이전트 설명서를 참조하세요.

개요

EC2 기반 Amazon ECS는 EC2 인스턴스에서 실행되는 도커(Docker) 컨테이너를 위해 확장성이 뛰어난 고성능 컨테이너 관리 서비스를 제공합니다.

Amazon ECS Datadog 통합을 사용하여 클라우드와치(CloudWatch)에서 자동으로 ECS 메트릭을 수집합니다. ECS API에서 ECS 이벤트, 태그, 그리고 컨테이너 인스턴스, 작업 및 서비스 의 상태를 쿼리하여 메트릭을 확장합니다.

설정

설치

아직 설정 하지 않았다면 먼저 Amazon Web Services 통합을 설정하세요.

메트릭 수집

  1. AWS 통합 역할 위임 설정 지침을 따르세요.
  2. Datadog IAM 정책에 대한 다음 권한이 Amazon ECS 메트릭을 수집하도록 설정되어 있는지 확인하세요. ECS 정책에 대한 자세한 내용은 AWS 문서에서 Amazon Elastic Container Service의 작업, 리소스, 조건 키를 참조하세요.
AWS 권한설명
ecs:ListClusters기존 클러스터 목록을 반환합니다.
ecs:ListContainerInstances특정 클러스터의 컨테이너 인스턴스 목록을 반환합니다.
ecs:ListServices특정 클러스터에서 실행하는 서비스를 나열합니다.
ecs:DescribeContainerInstancesAmazon ECS 컨테이너 인스턴스를 설명합니다.
  1. AWS 통합 페이지에서 Metric Collection 탭에 ECS가 활성화되어 있는지 확인하세요.

    Amazon ECS 구성

메트릭 수집이 활성화되면 ECS 메트릭에 대한 자세한 정보를 제공하는 즉시 사용 가능 대시보드를 이 통합에 사용할 수 있습니다. 자세한 정보는 Datadog를 사용해 ECS 모니터링을 참조하세요.

수집한 데이터

Metrics

aws.ecs.cpureservation
(gauge)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 백분율.
percent로 표시
aws.ecs.cpureservation.maximum
(gauge)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 최대 백분율.
percent로 표시
aws.ecs.cpureservation.minimum
(gauge)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 최소 백분율.
percent로 표시
aws.ecs.cpureservation.samplecount
(count)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 샘플 수.
aws.ecs.cpuutilization
(gauge)
ClusterName 및 ServiceName으로 필터링된 클러스터 또는 서비스에서 사용되는 CPU 유닛의 백분율.
percent로 표시
aws.ecs.cpuutilization.maximum
(gauge)
클러스터 또는 서비스에서 사용한 CPU 유닛의 최대 백분율.
percent로 표시
aws.ecs.cpuutilization.minimum
(gauge)
클러스터 또는 서비스에서 사용한 CPU 유닛의 최소 백분율.
percent로 표시
aws.ecs.cpuutilization.samplecount
(count)
클러스터 또는 서비스에서 사용된 CPU 유닛의 샘플 수.
aws.ecs.memory_reservation
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 백분율.
percent로 표시
aws.ecs.memory_reservation.maximum
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 최대 백분율.
percent로 표시
aws.ecs.memory_reservation.minimum
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 최소 백분율.
percent로 표시
aws.ecs.memory_utilization
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 백분율.
percent로 표시
aws.ecs.memory_utilization.maximum
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 최대 백분율.
percent로 표시
aws.ecs.memory_utilization.minimum
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 최소 백분율.
percent로 표시
aws.ecs.cluster.cpureservation
(gauge)
클러스터에서 작업을 실행하여 예약된 CPU 유닛의 백분율.
percent로 표시.
aws.ecs.cluster.cpureservation.maximum
(gauge)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 최대 백분율.
percent로 표시
aws.ecs.cluster.cpureservation.minimum
(gauge)
클러스터에서 실행 중인 작업이 예약한 CPU 유닛의 최소 백분율.
percent로 표시
aws.ecs.cluster.cpuutilization
(gauge)
ClusterName으로 필터링된 클러스터 또는 서비스에서 사용되는 CPU 유닛의 백분율.
percent로 표시
aws.ecs.cluster.cpuutilization.maximum
(gauge)
클러스터 또는 서비스에서 사용한 CPU 유닛의 최대 백분율.
percent로 표시
aws.ecs.cluster.cpuutilization.minimum
(gauge)
클러스터 또는 서비스에서 사용한 CPU 유닛의 최소 백분율.
percent로 표시
aws.ecs.cluster.memory_reservation
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 백분율.
percent로 표시
aws.ecs.cluster.memory_reservation.maximum
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 최대 백분율.
percent로 표시
aws.ecs.cluster.memory_reservation.minimum
(gauge)
클러스터에서 실행 중인 작업이 예약한 메모리의 최소 백분율.
percent로 표시
aws.ecs.cluster.memory_utilization
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 백분율.
percent로 표시
aws.ecs.cluster.memory_utilization.maximum
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 최대 백분율.
percent로 표시
aws.ecs.cluster.memory_utilization.minimum
(gauge)
클러스터 또는 서비스에서 사용되는 메모리의 최소 백분율.
percent로 표시
aws.ecs.pending_tasks_count
(gauge)
컨테이너 인스턴스에서 PENDING 상태인 작업의 수.
task로 표시
aws.ecs.registered_cpu
(gauge)
컨테이너 인스턴스에 등록된 CPU 유닛 수.
aws.ecs.registered_memory
(gauge)
컨테이너 인스턴스에 등록된 메모리 유닛 수
aws.ecs.remaining_cpu
(gauge)
컨테이너 인스턴스의 남은 CPU 유닛 수
aws.ecs.remaining_memory
(gauge)
컨테이너 인스턴스의 남은 메모리 유닛 수
aws.ecs.running_tasks_count
(gauge)
컨테이너 인스턴스에서 RUNNING 상태인 작업의 수.
task로 표시
aws.ecs.service.cpuutilization
(gauge)
서비스에서 사용되는 CPU 유닛의 평균 백분율.
percent로 표시
aws.ecs.service.cpuutilization.maximum
(gauge)
서비스에서 사용되는 CPU 유닛의 최대 백분율.
percent로 표시
aws.ecs.service.cpuutilization.minimum
(gauge)
서비스에서 사용되는 CPU 유닛의 최소 백분율.
percent로 표시
aws.ecs.service.desired
(gauge)
클러스터에서 목표 상태인 작업의 수
aws.ecs.service.memory_utilization
(gauge)
서비스에서 사용되는 메모리의 평균 백분율.
percent로 표시
aws.ecs.service.memory_utilization.maximum
(gauge)
서비스에서 사용되는 메모리의 최대 백분율.
percent로 표시
aws.ecs.service.memory_utilization.minimum
(gauge)
서비스에서 사용되는 메모리의 최소 백분율.
percent로 표시
aws.ecs.service.pending
(gauge)
클러스터에서 대기(pending) 상태인 작업의 수.
task로 표시
aws.ecs.service.running
(gauge)
클러스터에서 실행 상태인 작업의 수.
task로 표시
aws.ecs.services
(gauge)
클러스터당 실행 중인 서비스 수
ecs.containerinsights.container_instance_count
(count)
클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스의 수.
instance로 표시
ecs.containerinsights.container_instance_count.maximum
(count)
클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스의 최대 수.
instance로 표시
ecs.containerinsights.container_instance_count.minimum
(count)
클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스의 최소 수.
instance로 표시
ecs.containerinsights.container_instance_count.samplecount
(count)
클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스의 샘플 수.
instance로 표시
ecs.containerinsights.container_instance_count.sum
(count)
클러스터에 등록된 Amazon ECS 에이전트를 실행하는 EC2 인스턴스 수의 합.
instance로 표시
ecs.containerinsights.cpu_reserved
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 CPU 유닛 수.
ecs.containerinsights.cpu_reserved.maximum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 최대 CPU 유닛 수.
ecs.containerinsights.cpu_reserved.minimum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 최소 CPU 유닛 수.
ecs.containerinsights.cpu_reserved.samplecount
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 CPU 유닛의 샘플 수.
ecs.containerinsights.cpu_reserved.sum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 CPU 유닛 수의 합.
ecs.containerinsights.cpu_utilized
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용한 CPU 유닛 수.
percent로 표시
ecs.containerinsights.cpu_utilized.maximum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용한 최대 CPU 유닛 수.
percent로 표시
ecs.containerinsights.cpu_utilized.minimum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용한 최소 CPU 유닛 수.
percent로 표시
ecs.containerinsights.cpu_utilized.samplecount
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용한 CPU 유닛 의 샘플 수.
percent로 표시
ecs.containerinsights.cpu_utilized.sum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용한 CPU 유닛 수의 합.
percent로 표시
ecs.containerinsights.deployment_count
(count)
Amazon ECS 서비스의 배포 수.
ecs.containerinsights.deployment_count.maximum
(count)
Amazon ECS 서비스의 최대 배포 수.
ecs.containerinsights.deployment_count.minimum
(count)
Amazon ECS 서비스의 최소 배포 수.
ecs.containerinsights.deployment_count.samplecount
(count)
Amazon ECS 서비스 배포의 샘플 수.
ecs.containerinsights.deployment_count.sum
(count)
Amazon ECS 서비스 배포 수의 합계.
ecs.containerinsights.desired_task_count
(count)
Amazon ECS 서비스의 목표 작업 수.
task로 표시
ecs.containerinsights.desired_task_count.maximum
(count)
Amazon ECS 서비스의 목표 최대 작업 수.
task로 표시
ecs.containerinsights.desired_task_count.minimum
(count)
Amazon ECS 서비스의 목표 최소 작업 수.
task로 표시
ecs.containerinsights.desired_task_count.samplecount
(count)
Amazon ECS 서비스의 목표 작업 샘플 수.
task로 표시
ecs.containerinsights.desired_task_count.sum
(count)
Amazon ECS 서비스의 목표 작업 수의 합.
task로 표시
ecs.containerinsights.memory_reserved
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 메모리.
megabyte로 표시
ecs.containerinsights.memory_reserved.maximum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 최대 메모리.
megabyte로 표시
ecs.containerinsights.memory_reserved.minimum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 최소 메모리.
megabyte로 표시
ecs.containerinsights.memory_reserved.samplecount
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 메모리의 샘플 수.
megabyte로 표시
ecs.containerinsights.memory_reserved.sum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 예약한 메모리의 합.
megabyte로 표시
ecs.containerinsights.memory_utilized
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용 중인 메모리.
megabyte로 표시
ecs.containerinsights.memory_utilized.maximum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용 중인 최대 메모리.
megabyte로 표시
ecs.containerinsights.memory_utilized.minimum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용 중인 최소 메모리.
megabyte로 표시
ecs.containerinsights.memory_utilized.samplecount
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용 중인 메모리의 샘플 수.
megabyte로 표시
ecs.containerinsights.memory_utilized.sum
(gauge)
선택한 차원의 지정된 리소스에서 작업이 사용 중인 메모리의 합.
megabyte로 표시
ecs.containerinsights.pending_task_count
(count)
현재 PENDING 상태인 작업의 수.
task로 표시
ecs.containerinsights.pending_task_count.maximum
(count)
현재 PENDING 상태인 작업의 최대 수.
task로 표시
ecs.containerinsights.pending_task_count.minimum
(count)
현재 PENDING 상태인 작업의 최소 수.
task로 표시
ecs.containerinsights.pending_task_count.samplecount
(count)
현재 PENDING 상태인 작업의 샘플 수.
task로 표시
ecs.containerinsights.pending_task_count.sum
(count)
현재 PENDING 상태인 작업의 합계.
task로 표시
ecs.containerinsights.running_task_count
(count)
현재 RUNNING 상태인 작업의 수.
task로 표시
ecs.containerinsights.running_task_count.maximum
(count)
현재 RUNNING 상태인 작업의 최대 수.
task로 표시
ecs.containerinsights.running_task_count.minimum
(count)
현재 RUNNING 상태인 작업의 최소 수.
task로 표시
ecs.containerinsights.running_task_count.samplecount
(count)
현재 RUNNING 상태인 작업의 샘플 수.
task로 표시
ecs.containerinsights.running_task_count.sum
(count)
현재 RUNNING 상태인 작업의 합계.
task로 표시
ecs.containerinsights.service_count
(count)
클러스터의 서비스 수.
service로 표시
ecs.containerinsights.service_count.maximum
(count)
클러스터의 최대 서비스 수.
service로 표시
ecs.containerinsights.service_count.minimum
(count)
클러스터의 최소 서비스 수.
service로 표시
ecs.containerinsights.service_count.samplecount
(count)
클러스터 서비스의 샘플 수.
service로 표시
ecs.containerinsights.service_count.sum
(count)
클러스터 서비스 수의 합계.
service로 표시
ecs.containerinsights.storage_read_bytes
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 읽은 바이트 수.
byte로 표시
ecs.containerinsights.storage_read_bytes.maximum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 읽은 최대 바이트 수.
byte로 표시
ecs.containerinsights.storage_read_bytes.minimum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 읽은 최소 바이트 수.
byte로 표시
ecs.containerinsights.storage_read_bytes.samplecount
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 읽은 바이트의 샘플 수.
byte로 표시
ecs.containerinsights.storage_read_bytes.sum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 읽은 바이트 수의 합계.
byte로 표시
ecs.containerinsights.storage_write_bytes
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 기록된 바이트 수.
byte로 표시
ecs.containerinsights.storage_write_bytes.maximum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 기록된 최대 바이트 수.
byte로 표시
ecs.containerinsights.storage_write_bytes.minimum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 기록된 최소 바이트 수.
byte로 표시
ecs.containerinsights.storage_write_bytes.samplecount
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 기록된 바이트의 샘플 수.
byte로 표시
ecs.containerinsights.storage_write_bytes.sum
(gauge)
선택한 차원에 대해 지정된 리소스의 스토리지에서 기록된 바이트 수의 합계.
byte로 표시
ecs.containerinsights.task_count
(count)
서비스에서 실행 중인 작업 수.
task로 표시
ecs.containerinsights.task_count.maximum
(count)
서비스에서 실행 중인 최대 작업 수.
task로 표시
ecs.containerinsights.task_count.minimum
(count)
서비스에서 실행 중인 최소 작업 수.
task로 표시
ecs.containerinsights.task_count.samplecount
(count)
서비스에서 실행 중인 작업의 샘플 수.
task로 표시
ecs.containerinsights.task_count.sum
(count)
서비스에서 실행 중인 작업 수의 합계.
task로 표시
ecs.containerinsights.task_set_count
(count)
서비스의 작업 세트 수.
task로 표시
ecs.containerinsights.task_set_count.maximum
(count)
서비스 작업 세트의 최대 수.
task로 표시
ecs.containerinsights.task_set_count.minimum
(count)
서비스 작업 세트의 최소 수.
task로 표시
ecs.containerinsights.task_set_count.samplecount
(count)
서비스의 작업 세트 샘플 수.
task로 표시
ecs.containerinsights.task_set_count.sum
(count)
서비스의 작업 세트 수의 합.
task로 표시

AWS에서 검색된 각 메트릭에는 AWS 콘솔에 나타나는 것과 동일한 태그가 할당됩니다, 호스트 이름, 보안 그룹 등을 포함하되 이에 국한되지 않습니다.

참고: ecs.containerinsights.* 접두어의 메트릭은 AWS 통합 페이지 Metric Collection 탭의 Collect custom metrics를 활성화해 수집할 수 있습니다.

이벤트

노이즈를 줄이기 위해 Amazon ECS 통합은 자동으로 drain, error, fail, insufficient memory, pending, reboot, terminate 단어를 포함하는 이벤트만 포함하도록 설정되어 있습니다. 샘플 이벤트를 아래에서 확인해주세요.

Amazon ECS 이벤트

포함 목록을 제거하고 Datadog Amazon ECS 통합에서 모든 이벤트를 수신하려면 Datadog 지원에 문의해 주세요.

서비스 점검

aws.ecs.agent_connected

ECS Agent 연결 여부.

상태: ok, critical

트러블슈팅

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