オペレーション別にスタックイベントを表示する

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

各スタックオペレーション (作成、更新、削除、ロールバック) には、すべての関連するイベントをグループ化する一意のオペレーション ID が割り当てられます。これにより、特定のオペレーションに焦点を当て、障害の根本原因をすばやく特定できます。

前提条件

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

オペレーション別にスタックイベントを表示する (コンソール)

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

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

スタックオペレーションの実行中に、CREATE_IN_PROGRESS、UPDATE_IN_PROGRESS、または DELETE_IN_PROGRESS のステータスで一覧表示されます。オペレーションが正常に完了すると、そのステータスは CREATE_COMPLETE、UPDATE_COMPLETE、または DELETE_COMPLETE に変わります。

詳細については、「CloudFormation スタック作成イベントを理解する」および「スタック更新の進行状況を監視する」を参照してください。

オペレーション別にスタックイベントを表示する (AWS CLI)

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

最後のオペレーション 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 コマンドによって返されるフィールドを説明しています。