작업별 스택 이벤트 보기 - AWS CloudFormation

작업별 스택 이벤트 보기

스택에 대한 변경의 순서와 범위를 더 잘 이해하기 위해 작업별로 그룹화된 스택 이벤트를 볼 수 있습니다. 작업 기반 그룹화를 통해 관련 이벤트를 함께 추적하여 진행 상황을 모니터링하고 문제가 발생할 때 문제를 더 쉽게 해결할 수 있습니다.

각 스택 작업(생성, 업데이트, 삭제, 롤백)에는 모든 관련 이벤트를 그룹화하는 고유한 작업 ID가 할당됩니다. 이를 통해 특정 작업에 집중하고 장애의 근본 원인을 신속하게 식별할 수 있습니다.

사전 조건

DescribeEvents API를 사용하려면 DescribeEvents에 필요한 IAM 권한이 있어야 합니다.

작업별 스택 이벤트 보기(콘솔)

작업별로 그룹화된 스택 이벤트를 보는 방법
  1. AWS Management 콘솔에 로그인하여 https://console.aws.amazon.com/cloudformation에서 CloudFormation 콘솔을 엽니다.

  2. 화면 상단의 탐색 모음에서 스택을 생성한 AWS 리전을 선택합니다.

  3. 스택 페이지에서 스택 이름을 선택하세요. CloudFormation에 선택한 스택에 대한 스택 세부 정보가 표시됩니다.

  4. 이벤트 탭을 선택하여 CloudFormation에서 스택에 대해 생성한 스택 이벤트를 봅니다.

  5. 이벤트는 작업 ID별로 자동 그룹화됩니다. 각 작업은 작업 유형, 상태, 타임스탬프를 보여주는 확장 가능한 섹션으로 표시됩니다.

  6. 작업 ID를 클릭하여 해당 특정 작업과 관련된 이벤트만 보여주는 세부 보기를 여세요.

  7. 작업 세부 정보 보기에서 실패만 표시 확인란을 선택하여 근본 원인 분석을 위해 실패한 이벤트만 표시하세요.

CloudFormation은 매분 스택 이벤트를 자동으로 새로 고칩니다. 새 스택 이벤트가 발생하면 사용 가능한 새 이벤트 배지가 나타납니다. 이러한 이벤트를 목록에 로드하려면 새로 고침 아이콘을 선택합니다.

작업별로 그룹화된 스택 이벤트를 보면 각 작업의 이벤트 순서를 이해하고 문제의 원인이 되는 특정 작업을 빠르게 식별할 수 있습니다(스택을 디버깅하는 경우).

스택 작업이 실행 중인 동안 CREATE_IN_PROGRESS, UPDATE_IN_PROGRESS 또는 DELETE_IN_PROGRESS 상태로 나열됩니다. 작업이 성공적으로 완료되면 상태가 CREATE_COMPLETE, UPDATE_COMPLETE 또는 DELETE_COMPLETE로 변경됩니다.

자세한 내용은 CloudFormation 스택 생성 이벤트 이해스택 업데이트 진행 상황 모니터링(을)를 참조하세요.

작업별 스택 이벤트 보기(AWS CLI)

작업 ID 필터링과 함께 describe-events 명령을 사용하여 특정 작업에 대한 이벤트를 볼 수 있습니다.

마지막 작업 ID 가져오기

이제 describe-stacks API를 통해 사용할 수 있는 스택 설명에 최근 작업 ID와 해당 유형을 보여주는 LastOperations 정보가 포함됩니다. 이를 통해 이벤트 로그를 구문 분석하지 않고도 수행된 작업과 현재 상태를 빠르게 식별할 수 있습니다.

aws cloudformation describe-stacks --stack-name MyStack

다음은 마지막 작업이 업데이트 작업에 실패한 후 롤백된 작업임을 보여주는 응답 예제입니다.

{ "Stacks": [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/MyStack/07580010-bb79-11f0-8f6c-0289bb5c804f", "StackName": "MyStack", "Description": "A simple CloudFormation template to create an S3 bucket.", "CreationTime": "2025-11-07T01:28:13.778000+00:00", "LastUpdatedTime": "2025-11-07T01:43:39.838000+00:00", "RollbackConfiguration": {}, "StackStatus": "UPDATE_ROLLBACK_COMPLETE", "DisableRollback": false, "NotificationARNs": [], "Tags": [], "EnableTerminationProtection": false, "DriftInformation": { "StackDriftStatus": "NOT_CHECKED" }, "LastOperations": [ { "OperationType": "ROLLBACK", "OperationId": "d0f12313-7bdb-414d-a879-828a99b36f29" }, { "OperationType": "UPDATE_STACK", "OperationId": "1c211b5a-4538-4dc9-bfed-e07734371e57" } ] } ] }

작업 ID별 이벤트 필터링

다음 describe-events 명령은 특정 작업 ID에 대한 이벤트를 설명합니다.

aws cloudformation describe-events \ --operation-id 1c211b5a-4538-4dc9-bfed-e07734371e57

문제 해결을 위해 실패한 이벤트만 보려면 --filter FailedEvents=true 파라미터를 사용합니다.

aws cloudformation describe-events \ --operation-id 1c211b5a-4538-4dc9-bfed-e07734371e57 \ --filter FailedEvents=true

새로운 작업 ID 필터링 기능을 사용하면 특정 작업 및 관련 이벤트에 집중할 수 있습니다. 특히 다음과 같은 경우에 유용합니다.

  • 특정 장애 문제 해결: 실패한 작업에서 이벤트를 격리하여 무엇이 잘못되었는지 파악합니다.

  • 장기 실행 작업 모니터링: 복잡한 업데이트 또는 대규모 스택 배포의 진행 상황을 추적합니다.

  • 변경 내용 감사: 특정 업데이트 작업과 연결된 모든 이벤트를 검토합니다.

  • 근본 원인 분석: 장애 필터를 사용하여 배포 문제의 원인을 빠르게 식별합니다.

스택 상태 코드

다음 표에서는 작업 ID 필터링을 사용할 때 describe-events 명령에서 반환되는 필드를 설명합니다.

필드 설명
EventId 이벤트 식별자입니다.
OperationId 이 이벤트를 생성한 작업의 고유 식별자.
StackName 이벤트에 해당하는 스택의 이름입니다.
StackId 이벤트에 해당하는 스택의 식별자입니다.
LogicalResourceId 리소스의 논리적 식별자입니다.
PhysicalResourceId 리소스의 물리적 식별자입니다.
ResourceProperties 리소스의 속성입니다.
ResourceType 리소스의 유형입니다.
Timestamp 이벤트가 발생한 시간입니다.
ResourceStatus 리소스 상태(CREATE_COMPLETE, UPDATE_FAILED 등).
DetailedStatus 스택의 세부 상태입니다. CONFIGURATION_COMPLETE가 있는 경우 스택 리소스 구성 단계가 완료되었으며 리소스 안정화가 진행 중입니다.
ResourceStatusReason 상태에 대한 추가 정보입니다.