# オペレーション別にスタックイベントを表示する
<a name="view-stack-events-by-operation"></a>

オペレーション別にグループ化されたスタックイベントを表示して、スタックに加えられた変更のシーケンスと範囲をより良く理解できます。オペレーションベースのグループ化は、関連するイベントをまとめて追跡するのに役立つため、進行状況のモニタリングや問題発生時のトラブルシューティングが容易になります。

各スタックオペレーション (作成、更新、削除、ロールバック) には、すべての関連するイベントをグループ化する一意のオペレーション 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)

## 前提条件
<a name="view-stack-events-by-operation-prerequisites"></a>

`DescribeEvents` API を使用するには、`DescribeEvents` に必要な IAM アクセス許可が必要です。

## オペレーション別にスタックイベントを表示する (コンソール)
<a name="view-stack-events-by-operation-console"></a>

**オペレーション別にグループ化されたスタックイベントを表示するには**

1. AWS マネジメントコンソール にサインインし、CloudFormation コンソール ([https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/)) を開きます。

1. 画面の上部のナビゲーションバーで、スタックを作成した AWS リージョンを選択します。

1. [**スタック**] ページで、スタック名を選択します。CloudFormation は選択したスタックのスタック詳細を表示します。

1. **[イベント]** タブを選択して、スタックのために CloudFormation が生成したスタックイベントを表示します。

1. イベントはオペレーション ID によって自動的にグループ化されます。各オペレーションは、オペレーションタイプ、ステータス、およびタイムスタンプを示す展開可能なセクションとして表示されます。

1. **オペレーション ID** をクリックして、その特定のオペレーションに関連するイベントのみを示す詳細なビューを開きます。

1. オペレーションの詳細ビューで、**[障害のみを表示]** チェックボックスを選択して、根本原因分析のために失敗したイベントのみを表示します。

CloudFormation は、スタックイベントを 1 分ごとに自動的に更新します。新しいスタックイベントが発生すると、**使用可能な新しいイベント**バッジが表示されます。更新アイコンを選択して、これらのイベントをリストにロードします。

オペレーションごとにグループ化されたスタックイベントを表示することで、各オペレーションのイベントのシーケンスを理解し、どの特定のオペレーションが問題を引き起こしたかをすばやく特定できます (スタックをデバッグしている場合)。

スタックオペレーションの実行中に、`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)
<a name="view-stack-events-by-operation-cli"></a>

コマンド `describe-events` をオペレーション ID フィルタリングとともに使用して、特定のオペレーションのイベントを表示できます。

### 最後のオペレーション ID を取得する
<a name="get-last-operation-ids"></a>

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 でイベントをフィルタリングする
<a name="filter-events-by-operation-id"></a>

次の `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 フィルタリング機能を使用すると、特定のオペレーションとその関連するイベントに焦点を当てることができます。これは特に以下の場合に便利です。
+ **特定の障害のトラブルシューティング:** 失敗したオペレーションからイベントを分離して、何が問題だったのかを理解します。
+ **実行時間が長いオペレーションのモニタリング:** 複雑な更新や大規模なスタックデプロイの進行状況を追跡します。
+ **変更の監査:** 特定の更新オペレーションに関連付けられているすべてのイベントを確認します。
+ **根本原因の分析:** 障害フィルターを使用して、デプロイの問題の原因をすばやく特定します。

## スタックステータスコード
<a name="stack-status-codes"></a>

次の表は、オペレーション ID フィルタリングを使用しているときに `describe-events` コマンドによって返されるフィールドを説明しています。


| フィールド | 説明 | 
| --- | --- | 
| EventId | イベントの識別子 | 
| OperationId | このイベントを生成したオペレーションの一意の ID。 | 
| StackName | イベントに対応するスタックの名前 | 
| StackId | イベントに対応するスタックの識別子 | 
| LogicalResourceId | リソースの論理識別子 | 
| PhysicalResourceId | リソースの物理識別子 | 
| ResourceProperties | リソースのプロパティ | 
| ResourceType | リソースのタイプ。 | 
| Timestamp | イベントが発生した時刻 | 
| ResourceStatus | リソースのステータス (CREATE\_COMPLETE、UPDATE\_FAILED など)。 | 
| DetailedStatus | スタックの詳細ステータス。CONFIGURATION\_COMPLETE が存在する場合、スタックリソースの設定フェーズは完了済みで、リソースの安定化が進行中です。 | 
| ResourceStatusReason | ステータスの詳細 |