翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AI を使用した失敗したビルドのトラブルシューティング - プレビュー
**プレビュー機能**
この機能はプレビュー版であり、変更される可能性があります。
EC2 Image Builder ビルドが失敗した場合、根本原因は時間がかかり、特定が複雑になる可能性があります。 AWS DevOps エージェントを搭載した Image Builder のトラブルシューティング機能は、AI を活用した分析でこのプロセスを自動化します。複雑なビルド障害の原因をすばやく特定したり、複数の失敗したパイプラインのパターンを検出したりできます。
ビルドが失敗した場合、トラブルシューティングを使用して、ビルドログ、Amazon CloudWatch logs、ワークフローステップの実行、および関連 AWS リソースを分析できます。問題を解決するための根本原因分析と修復手順が表示されます。
単一の失敗したパイプラインビルドをトラブルシューティングしたり、複数の失敗したパイプラインを分析して、一般的なパターンと共有された根本原因を特定したりできます。
**Topics**
+ [前提条件](#devops-agent-troubleshooting-prereqs)
+ [トラブルシューティングの設定](#devops-agent-troubleshooting-setup)
+ [失敗したビルドのトラブルシューティング](#devops-agent-troubleshooting-single)
+ [複数の失敗したパイプラインのトラブルシューティング](#devops-agent-troubleshooting-aggregate)
+ [トラブルシューティングが調査する内容](#devops-agent-troubleshooting-checks)
+ [考慮事項](#devops-agent-troubleshooting-considerations)
## 前提条件
トラブルシューティング機能を使用する前に、使用する IAM ユーザーまたはロールに次のアクセス許可があることを確認してください。
+ `aidevops:ListAgentSpaces` – 使用可能なエージェントスペースを検出するために必要です。
+ `aidevops:CreateChat` – トラブルシューティングセッションを開始するために必要です。
+ `aidevops:SendChatMessage` – トラブルシューティング中にメッセージを送信するために必要です。
+ `aidevops:CreateAgentSpace` – Image Builder でエージェントスペースを作成する場合にのみ必要です。独自のエージェントスペースを持ち込む場合は、このアクセス許可を省略できます。
IAM ポリシーの詳細については、[「IAM のポリシーとアクセス許可](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)」を参照してください。
## トラブルシューティングの設定
トラブルシューティング機能には、 AWS DevOps エージェントエージェントスペースが必要です。既存のエージェントスペースを使用するか、Image Builder に作成させることができます。
+ **独自のエージェントスペースを使用する** – エージェントスペースがすでにある場合、Image Builder はそれをトラブルシューティングに使用します。
+ **Image Builder に作成させる** – エージェントスペースがない場合、Image Builder は最初の調査を開始するときに作成して設定します。このオプションには、 アクセス`aidevops:CreateAgentSpace`許可が必要です。
トラブルシューティングを開始するには、 AWS マネジメントコンソール ヘッダーの**トラブルシューティング**アイコンを選択します。
**注記**
AWS DevOps エージェントの詳細については、[AWS DevOps エージェントユーザーガイド](https://docs.aws.amazon.com/devopsagent/latest/userguide/)」を参照してください。
## 失敗したビルドのトラブルシューティング
イメージビルドが失敗した場合、Image Builder の複数のエントリポイントから AI を活用した調査を開始できます AWS マネジメントコンソール。
### トラブルシューティング調査を開始する
次のいずれかの方法を使用して、失敗したビルドのトラブルシューティングを開始します。
+ **パイプラインテーブル** – **イメージパイプライン**リストで失敗したパイプラインステータスの横にある**トラブルシューティング**アイコンを選択します。
+ **出力イメージテーブル** – 出力イメージリストで、失敗したイメージビルドの横にある**トラブルシューティング**アイコンを選択します。
+ **トラブルシューティングドロワー** – AWS マネジメントコンソール ヘッダーで、**トラブルシューティング**アイコンを選択し、調査するパイプラインを選択します。
### 調査中
トラブルシューティングを開始すると、トラブルシューティングは障害を調査します。ログとリソースが分析されると、ドロワーでリアルタイムの進行状況を追跡できます。通常、調査は数分で完了します。分析の実行中は、他の AWS マネジメントコンソール 領域で作業を続けることができます。調査が完了すると、次の情報が表示されます。
+ ビルドが失敗した理由を識別する根本原因分析
+ 問題を解決するための修復手順
+ 問題を解決するためのコマンドまたは設定の変更
結果を確認したら、レスポンスの品質に関するフィードバックを提供できます。同じ失敗したビルドに対して分析を再実行するには、**もう一度トラブルシューティング**を選択します。
## 複数の失敗したパイプラインのトラブルシューティング
複数の失敗したパイプラインがある場合は、それらを一緒に分析して、一般的なパターンと共有された根本原因を特定できます。
### 集計調査を開始する
次のいずれかの方法を使用して、複数のパイプラインのトラブルシューティングを行います。
+ **イメージパイプライン**テーブルで、複数の失敗したパイプラインを選択し、**選択したトラブルシューティング**を選択します。
+ トラブルシューティングドロワーを開き、**すべてトラブルシューティング**を選択して、失敗したすべてのパイプラインを分析します。
### 分析結果を集約する
根本原因別に整理されたグループ化された分析を受け取ります。グループごとに、以下が得られます。
+ 共有された根本原因の説明
+ その根本原因の影響を受けるパイプライン
+ グループの修復手順
集計分析の後、ドリルダウンプロンプトを選択して、特定のパイプラインをより詳細に調査できます。
## トラブルシューティングが調査する内容
失敗したビルドのトラブルシューティングを行うと、分析は次の領域をカバーします。
+ **ビルドログと Amazon CloudWatch logs** – エラー、ゼロ以外の終了コード、タイムアウト、スタックトレースをチェックします。
+ **ワークフローステップの実行** – 失敗したステップを識別し、その詳細を調べます。
+ **ネットワークとアクセス許可** – IAM インスタンスプロファイルのアクセス許可、セキュリティグループ、サブネットルーティング、NAT ゲートウェイ、インターネットゲートウェイ、VPC エンドポイントを確認します。
+ **コンポーネントとレシピの設定** – スクリプトエラー、依存関係の欠落、URLs破損、および基本 AMI の有効性をチェックします。
+ **ネットワーク接続** — AWS Systems Manager (Systems Manager) エージェントの到達可能性、DNS 解決、プロキシ設定をチェックします。
+ **ビルド履歴** – 最近のビルドを確認して、永続的な障害を断続的な問題と区別します。
## 考慮事項
トラブルシューティング機能を使用する場合は、次の点に注意してください。
+ トラブルシューティングは読み取り専用分析を実行します。リソースは変更されません。
+ トラブルシューティングは、Image Builder のビルド障害と、IAM、VPC、Systems Manager Agent などの関連インフラストラクチャを対象としています。
**注記**
AI はこれらのレスポンスを生成します。リソースを変更する前に、分析と推奨事項を確認してください。
Image Builder パイプラインビルドのトラブルシューティングの詳細については、「」を参照してください[パイプラインビルドのトラブルシューティング](troubleshooting.md#troubleshooting-pipelines)。