翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AI を使用した失敗したビルドのトラブルシューティング - プレビュー
プレビュー機能
この機能はプレビュー版であり、変更される可能性があります。
EC2 Image Builder ビルドが失敗した場合、根本原因は時間がかかり、特定が複雑になる可能性があります。 AWS DevOps エージェントを搭載した Image Builder のトラブルシューティング機能は、AI を活用した分析でこのプロセスを自動化します。複雑なビルド障害の原因をすばやく特定したり、複数の失敗したパイプラインのパターンを検出したりできます。
ビルドが失敗した場合、トラブルシューティングを使用して、ビルドログ、Amazon CloudWatch logs、ワークフローステップの実行、および関連 AWS リソースを分析できます。問題を解決するための根本原因分析と修復手順が表示されます。
単一の失敗したパイプラインビルドをトラブルシューティングしたり、複数の失敗したパイプラインを分析して、一般的なパターンと共有された根本原因を特定したりできます。
前提条件
トラブルシューティング機能を使用する前に、使用する IAM ユーザーまたはロールに次のアクセス許可があることを確認してください。
-
aidevops:ListAgentSpaces– 使用可能なエージェントスペースを検出するために必要です。 -
aidevops:CreateChat– トラブルシューティングセッションを開始するために必要です。 -
aidevops:SendChatMessage– トラブルシューティング中にメッセージを送信するために必要です。 -
aidevops:CreateAgentSpace– Image Builder でエージェントスペースを作成する場合にのみ必要です。独自のエージェントスペースを持ち込む場合は、このアクセス許可を省略できます。
IAM ポリシーの詳細については、「IAM のポリシーとアクセス許可」を参照してください。
トラブルシューティングの設定
トラブルシューティング機能には、 AWS DevOps エージェントエージェントスペースが必要です。既存のエージェントスペースを使用するか、Image Builder に作成させることができます。
-
独自のエージェントスペースを使用する – エージェントスペースがすでにある場合、Image Builder はそれをトラブルシューティングに使用します。
-
Image Builder に作成させる – エージェントスペースがない場合、Image Builder は最初の調査を開始するときに作成して設定します。このオプションには、 アクセス
aidevops:CreateAgentSpace許可が必要です。
トラブルシューティングを開始するには、 AWS マネジメントコンソール ヘッダーのトラブルシューティングアイコンを選択します。
注記
AWS DevOps エージェントの詳細については、AWS DevOps エージェントユーザーガイド」を参照してください。
失敗したビルドのトラブルシューティング
イメージビルドが失敗した場合、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 パイプラインビルドのトラブルシューティングの詳細については、「」を参照してくださいパイプラインビルドのトラブルシューティング。
