本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 Amazon 日志监控 Image Builder CloudWatch 日志
<a name="monitor-cwlogs"></a>

CloudWatch 默认情况下，日志支持处于开启状态。Image Builder 在构建过程中保留实例上的构建日志，然后在构建完成后将 CloudWatch 日志流式传输到日志。在创建最终构建映像之前，Image Builder 会从实例中删除本地日志。

**镜像构建日志**  
映像构建日志包含单个映像构建的详细日志。Image Builder 将映像构建日志写入以下 Image Builder CloudWatch 日志组并进行直播：  
**LogGroup:** `/aws/imagebuilder/ImageName`  
**LogStream (x.x.x/x):** `ImageVersion/ImageBuildVersion`

**管道执行日志**  
当图像管道运行或管道跳过定期运行时，Image Builder 会写入管道执行日志，以及有关发生这种情况的原因的详细信息。例如，当为计划管道配置依赖项更新时，以下场景将关联消息传送：  
+ Image Builder 因为没有依赖项更新而跳过管道执行时会写入日志条目。
+ 当有依赖关系更新时，Image Builder 会记录已更改的资源的 ARN。
Image Builder 将管道执行日志写入以下 Image Builder CloudWatch 日志组并进行流式传输：  
**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 日志流式传输。
+ 日志：CreateLogGroup
+ 日志：CreateLogStream
+ 日志：PutLogEvents


|  日志类型  |  自定义角色  | 
| --- | --- | 
|  镜像构建  |  执行角色  | 
|  管道执行  |  执行角色  | 
|  组件日志  |  实例配置文件角色  | 

对于高级故障排除，您可以使用 [AWS Systems Manager Run Command](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html) 运行预定义的命令和脚本。有关更多信息，请参阅 [Image Builder 问题疑难解答](troubleshooting.md)。