依操作檢視堆疊事件 - AWS CloudFormation

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

依操作檢視堆疊事件

您可以檢視依操作分組的堆疊事件,以進一步了解對堆疊所做的變更順序和範圍。以操作為基礎的分組可協助您一起追蹤相關事件,讓您更輕鬆地監控進度,並在問題發生時進行疑難排解。

每個堆疊操作 (建立、更新、刪除、轉返) 都會指派一個唯一的操作 ID,將所有相關事件分組。這可讓您專注於特定操作,並快速識別失敗的根本原因。

先決條件

若要使用 DescribeEvents API,您必須擁有必要的 IAM 許可才能:DescribeEvents

依操作檢視堆疊事件 (主控台)

檢視依操作分組的堆疊事件
  1. 登入 AWS 管理主控台 ,並在 https://https://console.aws.amazon.com/cloudformation 開啟 CloudFormation 主控台。

  2. 在畫面頂端的導覽列上,選擇 AWS 區域 您在其中建立堆疊的 。

  3. 堆疊頁面上,選取堆疊名稱。CloudFormation 會顯示所選取堆疊的堆疊詳細資訊。

  4. 選擇事件索引標籤以檢視 CloudFormation 為堆疊產生的堆疊事件。

  5. 事件會依操作 ID 自動分組。每個操作都會顯示為可擴展區段,顯示操作類型、狀態和時間戳記。

  6. 按一下操作 ID 以開啟詳細檢視,僅顯示與該特定操作相關的事件。

  7. 在操作詳細資訊檢視中,選取僅顯示失敗核取方塊,僅顯示失敗的事件以進行根本原因分析。

CloudFormation 每分鐘會自動重新整理堆疊事件。新堆疊事件發生時,會顯示新事件可用徽章。選擇重新整理圖示,以將這些事件載入清單中。

透過檢視依操作分組的堆疊事件,您可以了解每個操作的事件順序,並快速識別哪些特定操作導致問題 (如果您要偵錯堆疊)。

當您的堆疊操作正在執行時,會列出狀態為 CREATE_IN_PROGRESSUPDATE_IN_PROGRESS或 的堆疊操作DELETE_IN_PROGRESS。操作成功完成後,其狀態會變更為 CREATE_COMPLETEUPDATE_COMPLETEDELETE_COMPLETE

如需詳細資訊,請參閱了解 CloudFormation 堆疊建立事件監控堆疊更新的進度

依操作檢視堆疊事件 (AWS CLI)

您可以使用 describe-events命令搭配操作 ID 篩選,以檢視特定操作的事件。

取得最後一個操作 IDs

可透過 describe-stacks API 取得的堆疊描述現在包含 LastOperations 資訊,顯示最近的操作 IDs 及其類型。這可讓您快速識別發生的操作及其目前狀態,而無需剖析事件日誌。

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_COMPLETEUPDATE_FAILED等)。
DetailedStatus 堆疊的詳細狀態。若 CONFIGURATION_COMPLETE 存在,則堆疊資源組態階段已完成,且資源穩定化作業正在進行中。
ResourceStatusReason 狀態的詳細資訊。