# 작업별 스택 이벤트 보기
스택에 대한 변경의 순서와 범위를 더 잘 이해하기 위해 작업별로 그룹화된 스택 이벤트를 볼 수 있습니다. 작업 기반 그룹화를 통해 관련 이벤트를 함께 추적하여 진행 상황을 모니터링하고 문제가 발생할 때 문제를 더 쉽게 해결할 수 있습니다.
각 스택 작업(생성, 업데이트, 삭제, 롤백)에는 모든 관련 이벤트를 그룹화하는 고유한 작업 ID가 할당됩니다. 이를 통해 특정 작업에 집중하고 장애의 근본 원인을 신속하게 식별할 수 있습니다.
**Topics**
+ [사전 조건](#view-stack-events-by-operation-prerequisites)
+ [작업별 스택 이벤트 보기(콘솔)](#view-stack-events-by-operation-console)
+ [작업별 스택 이벤트 보기(AWS CLI)](#view-stack-events-by-operation-cli)
+ [스택 상태 코드](#stack-status-codes)
## 사전 조건
`DescribeEvents` API를 사용하려면 `DescribeEvents`에 필요한 IAM 권한이 있어야 합니다.
## 작업별 스택 이벤트 보기(콘솔)
**작업별로 그룹화된 스택 이벤트를 보는 방법**
1. AWS Management Console에 로그인하여 [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)에서 CloudFormation 콘솔을 엽니다.
1. 화면 상단의 탐색 모음에서 스택을 생성한 AWS 리전을 선택합니다.
1. **스택** 페이지에서 스택 이름을 선택하세요. CloudFormation에 선택한 스택에 대한 스택 세부 정보가 표시됩니다.
1. **이벤트** 탭을 선택하여 CloudFormation에서 스택에 대해 생성한 스택 이벤트를 봅니다.
1. 이벤트는 작업 ID별로 자동 그룹화됩니다. 각 작업은 작업 유형, 상태, 타임스탬프를 보여주는 확장 가능한 섹션으로 표시됩니다.
1. **작업 ID**를 클릭하여 해당 특정 작업과 관련된 이벤트만 보여주는 세부 보기를 여세요.
1. 작업 세부 정보 보기에서 **실패만 표시** 확인란을 선택하여 근본 원인 분석을 위해 실패한 이벤트만 표시하세요.
CloudFormation은 매분 스택 이벤트를 자동으로 새로 고칩니다. 새 스택 이벤트가 발생하면 **사용 가능한 새 이벤트** 배지가 나타납니다. 이러한 이벤트를 목록에 로드하려면 새로 고침 아이콘을 선택합니다.
작업별로 그룹화된 스택 이벤트를 보면 각 작업의 이벤트 순서를 이해하고 문제의 원인이 되는 특정 작업을 빠르게 식별할 수 있습니다(스택을 디버깅하는 경우).
스택 작업이 실행 중인 동안 `CREATE_IN_PROGRESS`, `UPDATE_IN_PROGRESS` 또는 `DELETE_IN_PROGRESS` 상태로 나열됩니다. 작업이 성공적으로 완료되면 상태가 `CREATE_COMPLETE`, `UPDATE_COMPLETE` 또는 `DELETE_COMPLETE`로 변경됩니다.
자세한 내용은 [CloudFormation 스택 생성 이벤트 이해](stack-resource-configuration-complete.md) 및 [스택 업데이트 진행 상황 모니터링](using-cfn-updating-stacks-monitor-stack.md)(을)를 참조하세요.
## 작업별 스택 이벤트 보기(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 | 상태에 대한 추가 정보입니다. |