Amazon ECS 이벤트(CloudWatch/EventBridge)

Amazon ECS 이벤트(CloudWatch/EventBridge)

Amazon ECS는 리소스 상태 변화를 Amazon EventBridge(CloudWatch Events)로 전송해요. 이 페이지에서는 ECS가 게시하는 이벤트 유형과 이벤트 형식을 알아보세요.

출처: 문서

본문

Amazon ECS는 태스크, 서비스, 컨테이너 인스턴스, 배포의 상태 변화에 대한 이벤트를 생성해요. 이러한 이벤트는 EventBridge 규칙에서 캡처해 Lambda, SNS, Amazon SQS 등 다양한 대상으로 전달할 수 있어요.

이벤트 유형

Amazon ECS가 게시하는 주요 이벤트 유형은 다음과 같아요:

• ECS Task State Change – 태스크 상태가 변경될 때 생성돼요. 태스크가 시작, 중지, 종료될 때 발생해요.
• ECS Container Instance State Change – 컨테이너 인스턴스의 상태가 변경될 때 생성돼요.
• ECS Service Action – 서비스에서 특정 작업(예: 배포가 원하는 수에 도달하지 못함)이 발생할 때 생성돼요.
• ECS Deployment State Change – 서비스 배포 상태가 변경될 때 생성돼요.

이벤트 형식

EventBridge 이벤트는 다음 형식으로 전달돼요:

{
  "version": "0",
  "id": "...",
  "detail-type": "ECS Task State Change",
  "source": "aws.ecs",
  "account": "...",
  "time": "...",
  "region": "...",
  "resources": ["arn:aws:ecs:..."],
  "detail": {
    "clusterArn": "...",
    "taskArn": "...",
    "lastStatus": "STOPPED",
    "desiredStatus": "RUNNING",
    "group": "service:my-service"
  }
}

이벤트의 detail 필드에는 리소스의 상태와 세부 정보가 포함돼요. 규칙에서 detail-type과 source를 기준으로 이벤트를 필터링할 수 있어요.

이벤트 사용

이벤트 스트림을 사용하면 ECS 리소스 변화에 실시간으로 대응하는 자동화를 구축할 수 있어요. 예를 들어 태스크 중지 이벤트를 받아 알림을 보내거나, 컨테이너 인스턴스 상태 변화에 따라 후속 작업을 수행할 수 있어요.

더 알아보기 (Learn more)

• 이벤트 스트림
• EventBridge