翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon CloudWatch Logs を使用した Image Builder ログのモニタリング
<a name="monitor-cwlogs"></a>

CloudWatch Logs サポートは、デフォルトで有効になっています。Image Builder は、ビルドプロセス中にインスタンスのビルドログを保持し、ビルドが完了するとログを CloudWatch Logs にストリーミングします。最終的なビルドイメージを作成する前に、Image Builder はインスタンスからローカルログを削除します。

**イメージビルドログ**  
イメージビルドログには、個々のイメージビルドの詳細ログが含まれます。Image Builder は、次の 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


|  ログタイプ  |  カスタムロール  | 
| --- | --- | 
|  イメージビルド  |  実行ロール  | 
|  パイプラインの実行  |  実行ロール  | 
|  コンポーネントログ  |  インスタンスプロファイルロール  | 

高度なトラブルシューティングを行う場合は、「[AWS Systems Manager コマンドを実行](https://docs.aws.amazon.com/systems-manager/latest/userguide/run-command.html)」を使用して定義済みのコマンドとスクリプトを実行できます。詳細については、「[Image Builder の問題のトラブルシューティング](troubleshooting.md)」を参照してください。