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

# 使用 Amazon CloudWatch Logs 監控映像建置器日誌
<a name="monitor-cwlogs"></a>

CloudWatch Logs 支援預設為開啟。Image Builder 會在建置程序期間保留執行個體上的建置日誌，然後在建置完成時將日誌串流至 CloudWatch Logs。在建立最終建置映像之前，映像建置器會從執行個體中移除本機日誌。

**映像建置日誌**  
映像建置日誌包含個別映像建置的詳細日誌。Image Builder 會將映像建置日誌寫入下列映像建置器 CloudWatch Logs 群組和串流：  
**LogGroup：** `/aws/imagebuilder/ImageName`  
**LogStream (x.x.x/x)：** `ImageVersion/ImageBuildVersion`

**管道執行日誌**  
Image Builder 會在映像管道執行或管道略過定期排程執行時寫入管道執行日誌，以及發生原因的詳細資訊。例如，設定排程管道的相依性更新時，下列案例會有相關聯的訊息：  
+ Image Builder 在略過管道執行時寫入日誌項目，因為沒有相依性更新。
+ 發生相依性更新時，Image Builder 會記錄已變更之資源的 ARN。
Image Builder 會將管道執行日誌寫入下列 Image Builder CloudWatch Logs 群組和串流：  
**LogGroup：** `/aws/imagebuilder/pipeline/pipeline-name`  
**LogStream：**`2025/09/01`（管道執行日期，格式為 YYYY/MM/DD)  
每個管道日誌都會附加到當天的串流。

**自訂日誌群組**  
如果您已為映像或管道記錄指定自訂日誌群組，Image Builder 會將日誌寫入您在管道中指定的 LogGroup，或者如果您手動執行建置，則會在其中一個建立映像命令中寫入日誌。如需 Image Builder 中運作方式的詳細資訊，請參閱 [設定管道記錄](schedule-pipeline.md#configure-pipeline-logging)。

 

**選擇退出**  
您可以透過移除與適用於您的使用案例的自訂角色相關聯的下列許可，選擇退出 CloudWatch Logs 串流。
+ logs:CreateLogGroup
+ logs:CreateLogStream
+ logs:PutLogEvents


|  日誌類型  |  自訂角色  | 
| --- | --- | 
|  映像建置  |  執行角色  | 
|  管道執行  |  執行角色  | 
|  元件日誌  |  執行個體設定檔角色  | 

對於進階故障診斷，您可以使用 Run Command [AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html)執行預先定義的命令和指令碼。如需詳細資訊，請參閱[疑難排解映像建置器問題](troubleshooting.md)。