작업별 스택 이벤트 보기
스택에 대한 변경의 순서와 범위를 더 잘 이해하기 위해 작업별로 그룹화된 스택 이벤트를 볼 수 있습니다. 작업 기반 그룹화를 통해 관련 이벤트를 함께 추적하여 진행 상황을 모니터링하고 문제가 발생할 때 문제를 더 쉽게 해결할 수 있습니다.
각 스택 작업(생성, 업데이트, 삭제, 롤백)에는 모든 관련 이벤트를 그룹화하는 고유한 작업 ID가 할당됩니다. 이를 통해 특정 작업에 집중하고 장애의 근본 원인을 신속하게 식별할 수 있습니다.
사전 조건
DescribeEvents API를 사용하려면 DescribeEvents에 필요한 IAM 권한이 있어야 합니다.
작업별 스택 이벤트 보기(콘솔)
작업별로 그룹화된 스택 이벤트를 보는 방법
AWS Management 콘솔에 로그인하여 https://console.aws.amazon.com/cloudformation
에서 CloudFormation 콘솔을 엽니다. -
화면 상단의 탐색 모음에서 스택을 생성한 AWS 리전을 선택합니다.
-
스택 페이지에서 스택 이름을 선택하세요. CloudFormation에 선택한 스택에 대한 스택 세부 정보가 표시됩니다.
-
이벤트 탭을 선택하여 CloudFormation에서 스택에 대해 생성한 스택 이벤트를 봅니다.
-
이벤트는 작업 ID별로 자동 그룹화됩니다. 각 작업은 작업 유형, 상태, 타임스탬프를 보여주는 확장 가능한 섹션으로 표시됩니다.
-
작업 ID를 클릭하여 해당 특정 작업과 관련된 이벤트만 보여주는 세부 보기를 여세요.
-
작업 세부 정보 보기에서 실패만 표시 확인란을 선택하여 근본 원인 분석을 위해 실패한 이벤트만 표시하세요.
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-nameMyStack
다음은 마지막 작업이 업데이트 작업에 실패한 후 롤백된 작업임을 보여주는 응답 예제입니다.
{ "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-id1c211b5a-4538-4dc9-bfed-e07734371e57
문제 해결을 위해 실패한 이벤트만 보려면 --filter
FailedEvents=true 파라미터를 사용합니다.
aws cloudformation describe-events \ --operation-id1c211b5a-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 |
상태에 대한 추가 정보입니다. |