環境内の運用上の問題を調査する

調査するメトリクスまたはアラームのグラフで、調査に含める時間範囲を選択します。

ページの上部に [Investigate] ボタンがある場合は、そのボタンを選択してから、[Start new investigation] を選択します。

それ以外の場合は、メトリクスの縦の省略記号メニューアイコン を選択し、[Investigate]、[Start new investigation] を選択します。

[Investigate] ペインで、[New investigation title] に調査の名前を入力し、オプションで選択したメトリクスまたはアラームに関するメモを入力します。次に、[Start investigation] を選択します。

調査が開始されます。Amazon Q Developer はテレメトリデータをスキャンして、この状況に関連する可能性のあるデータを見つけます。

調査データを大きなペインに移動するには、[Open in full page] を選択します。

調査の続行中に実行できる手順の詳細については、「オープン調査を表示して続行する」を参照してください。

調査のページをまだ開いていない場合は、次の操作を行います。

1. CloudWatch コンソール (https://console.aws.amazon.com/cloudwatch/) を開きます。

2. 左のナビゲーションペインで、[AI Operations]、[Investigations] を選択します。

3. 調査の名前を選択します。

   ヒント

   Amazon Q Developer の運用調査が ServiceNow または Jira と統合されている場合は、調査見出しから統合ツールに調査を関連付けることができます。

   たとえば、Jira 統合の場合は、調査ヘッダーで [Jira Cloud] にカーソルを合わせ、[Add existing ticket]、[Create new ticket]、[Edit integration]のいずれかを選択します。

   まだ統合が設定されていない場合は、統合を設定できます。詳細については、「運用調査を設定する」のステップ 3 を参照してください。

[Feed] セクションには、最初に調査を開始するために選択されたメトリクスやアラームなど、調査結果に追加された項目が表示されます。

右側のペインにはタブがあります。[Suggestions] タブを選択します。

[Suggestions] タブには、Amazon Q Developer が調査に関連する可能性があると判断した他のテレメトリの観測結果が表示されます。また、Amazon Q Developer が状況に対して検出した考えられる理由や根本原因である仮説が含まれる場合もあります。

観測結果と仮説はどちらも Amazon Q Developer によって自然言語で記述されます。

これには複数のオプションがあります。

• 提案ごとに、[Accept] または [Discard] を選択できます。

  [Accept] を選択すると、提案が [Feed] セクションに追加され、Amazon Q Developer はこの情報を使用してさらにスキャンと提案を送信します。

  [Discard] を選択すると、提案は [Discarded] タブに移動します。

• 観測タイプの提案ごとに、[Suggestions] タブでグラフを展開するか、CloudWatch コンソールでグラフを開いて詳細を表示できます。

• 観測結果の一部は、Amazon Q Developer が調査の一環として実行した CloudWatch Logs Insights クエリの結果である可能性があります。観測結果が CloudWatch Logs Insights クエリ結果の場合、クエリ自体は観測結果の一部として表示されます。クエリを編集して再実行できます。これを行うには、結果で縦の省略記号メニューアイコン を選択し、[Open in Logs Insights] を選択します。詳細については、「CloudWatch Logs Insights を使用したログデータの分析」を参照してください。

• この調査に適用される可能性のある AWS のサービス内のテレメトリがわかっている場合は、そのサービスのコンソールに移動して、テレメトリを調査に追加できます。例えば、調査に Lambda メトリクスを追加するには、次の操作を行います。

  1. Lambda のコンソールを開きます。

  2. [モニタリング] セクションで、メトリクスを見つけます。

  3. メトリクスの縦の省略記号コンテキストメニュー を開き、[Investigate]、[Add to investigation] を選択し、[Investigate] ペインで調査の名前を選択します。

• [Suggestions] タブで仮説を表示する場合、[Show reasoning] を選択して、Amazon Q Developer が仮説の生成に使用したデータを表示できます。

• Amazon Q Developer の運用調査をサードパーティーのチケット発行システムと統合している場合は、この調査をそのシステムのチケットにアタッチできます。これを行うには、[Feed] の上の [No ticket attached] にカーソルを合わせ、[Attach ticket] または [Create ticket] を選択します。

• [Discarded] タブを選択すると、以前に破棄された候補を表示できます。それらの 1 つを結果に追加するには、[Restore to findings] を選択します。

• 結果にメモを追加するには、[Feed] ペインで [New note] を選択します。次に、メモを入力し、[Add] を選択します。

[Feed] エリアに仮説を追加すると、[Show suggested actions] が表示される場合があります。その場合、これを選択すると、問題に関する仮説が正しいと仮定して、実行できるアクションが表示されます。考えられるアクションは次のとおりです。

調査を終了するには、[End investigation] を選択し、オプションで最終メモを追加します。次に、[保存] を選択します。

調査ステータスが[Archived]に変わります。調査ページを開き、[Restart investigation] を選択すると、アーカイブされた調査を再開できます。

調査に関連するアラーム状態遷移は、開いている限り調査に追加され続けるため、調査を無期限に開いたままにしないことをお勧めします。

提案されるランブックに関する情報を表示するには、[Review] を選択してランブックステップの実行方法に関する情報を確認します。

調査の詳細ページで、[Suggestions] を選択します。

[Suggestions] ペインで、調査中の問題のシステム分析に基づいて仮説のリストを確認します。

仮説ごとに、以下のオプションから選択できます。

[View action] を選択した後、[Suggested actions] ペインで、問題に対処するために実行できる推奨アクションのリストを確認します。提案されるアクションには、以下のうち 1 つ以上を含めることができます。

仮説を確認したら、[Learn more] を選択して特定の提案されるアクションをさらに調べ、関連ドキュメントを読むことができます。[Review details] を選択して、AWS とユーザーが所有する提案されるランブックを調べることもできます。

ランブックの [Review details] を選択するときは、次のことを行います。

1. [Runbook description] で、調査対象の問題を修正するためにランブックが実行できるアクションの概要を確認してください。[View steps] を選択してランブックのワークフローを視覚化し、個々のステップの詳細をドリルダウンします。

2. [Input parameters] には、ランブックに必要なパラメータの値を指定します。これらのパラメータはランブックによって異なります。

3. [Execution preview] で、情報を慎重に確認します。この情報は、ランブックの実行を選択した場合の範囲と影響について説明しています。

   [Execution preview] のコンテンツでは、次の情報が提供されます。

   • ランブックオペレーションが実行されるアカウントとリージョンの数。

   • 実行されるアクションのタイプと、各タイプの実行回数。

     アクションタイプには以下のものがあります。

     • Mutating: ランブックステップは、リソースの作成、変更、または削除を行うアクションを通じて、ターゲットに変更を加えます。

     • Non-Mutating: ランブックステップは、リソースに関するデータを取得しますが、データに変更を加えることはありません。このカテゴリには通常、Describe、List、Get、および同様の読み取り専用 API アクションが含まれます。

     • Undetermined: 未確定ステップは、AWS Lambda、AWS Step Functions、または AWS Systems Manager の機能である Run Command など、他のオーケストレーションサービスによって処理される実行を呼び出します。また、未確定ステップは、サードパーティー API を呼び出したり、Python や PowerShell スクリプトを実行したりする場合もあります。Systems Manager Automation は、オーケストレーションプロセスまたはサードパーティー API 実行の結果を検出できないため、それらを評価することができません。これらのステップの結果は、手動で確認して、その影響を判断する必要があります。

     サポートされているアクションとその影響タイプについては、「AWS Systems Manager ユーザーガイド」の「ランブックアクションの修復の影響タイプ」を参照してください。

4. 続行するかどうかを決定する前に、プレビュー情報を注意深く確認してください。

   この時点で、次のいずれかのアクションを選択できます。

   • 停止して、ランブックを実行しない。

   • ランブックを実行する前に入力パラメータを変更します。

   • 既に選択したオプションを使用してランブックを実行する。

ランブックを実行する場合は、[Execute] を選択します。

すでに仮説を受け入れている場合は、実行が実行されます。

仮説をまだ受け入れていない場合は、実行前にその仮説を受け入れるように求めるダイアログボックスが表示されます。