問題を調査する

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご覧ください。

[Investigate] ダッシュボードでは、すべての API トラフィックの指標と属性のピボット テーブルを表示し、指標間で関連するアクティビティを比較して、問題を迅速に調査、診断できます。このダッシュボードでは、過去 30 日間のデータにアクセスできます。

Edge UI で [Analyze] > [API Monitoring] > [Investigate] を選択し、[Investivate] ダッシュボードを開きます。ダッシュボードには主に 2 つの領域があります。

  • ステータス コード: API プロキシとターゲット サービスのステータス コード指標を調査できます。
  • レイテンシ: API プロキシとターゲット サービスのレイテンシの問題を調査できます。

また、[Investigate] ダッシュボードでは、特定のアラートに起因する問題を調査できます。アラートが発生したら、[Alert History] ページでアラートの名前をクリックして、調査ダッシュボードにアラートを開きます。

Investigate ダッシュボードを使用した問題の診断

たとえば、5xx エラー率が指定のしきい値を超えたことを示すアラートを受け取ることができます。この問題を調査するには、[調査] ダッシュボードで次のタスクを行います。

  1. 障害コードと時間のマトリックスを表示して、直近 1 時間で発生した障害コードの状況を確認します。
  2. 障害コードと HTTP ステータス マトリックスに切り替えます。ここで、前のステップで特定した直近 1 時間に数が増加した障害コードに関連する特定の HTTP ステータス コードを特定します。
  3. 障害コードとプロキシ マトリックスに切り替えます。ここで、前のステップで特定した障害コードをトリガーしている API プロキシを特定します。
  4. 障害コードの量が多い API プロキシに関連付けられたマトリックス内のボックスをクリックすると、詳細とアクセスログが表示されます。
  5. アラートを設定し、カスタム レポートを作成して、問題の診断をさらに支援します。

  6. さらに、トレースやその他のツールを使用して API プロキシをトラブルシューティングし、問題の解決を特定します。

ステータス コード ダッシュボードの使用

ステータス コード ダッシュボードを使用すると、組織内の API プロキシとターゲット サービスのステータス コードの指標を調査できます。過去 30 日間のステータス コードの指標は、1 時間または 4 時間のステータスでいつでも確認できます。

ステータス コード ダッシュボードを詳しく見る

[ステータス コード] ダッシュボードを表示するには、Edge UI で [Analyze] > [API Monitoring] > [Investigate] を選択します。[ステータス コード] ダッシュボードは、デフォルトで次のように表示されます。

ステータス コード ページ

図でハイライト表示されているように、[Investigate] ダッシュボードでは次のことができます。

  • マトリックスの X 軸と Y 軸を設定することで、各マトリックスを構成できます。これにより、指標間で関連するアクティビティを比較して、詳しい分析を行うことができます。
  • ブロックの色付けに基づいて、相対量が最も多い指標をすばやく特定できます。ブロックの色が濃くなるほど、相対的な量が多くなります。
  • マトリックス内のブロックをクリックすると、指標の詳細を表示できます。
  • 以下の項目に基づいてデータをフィルタリングできます。
    • 環境
    • 地域
    • プロキシ
    • ステータス コード（すべてのトラフィック、すべてのエラー、2xx、4xx、5xx を含む）
    • 過去 30 日間の日付と時刻
    • 1 時間または 4 時間

このダッシュボードを使用すると、次のタスクをすばやく実行できます。

  • 指標の詳細パネルでログにアクセスできます。
  • その他のメニュー をクリックし、[View in Recent] または [View in Timeline] をクリックすることで、[Recent] ダッシュボードまたは [Timeline] ダッシュボードで現在のコンテキストを表示できます。
  • をクリックすることで、カスタム レポートを作成し、分割項目を追加できます。
  • アラートを作成し、アラート条件を追加して通知を設定し、アラートに基づいてカスタム レポートを生成します。

ステータス コード マトリックスの構成

[ステータス コード] ダッシュボードを選択すると、デフォルトで次のマトリックスが表示されます。

  • 障害コードと時間の比較
  • 障害コードと HTTP ステータス
  • フォールト ソースと API プロキシの比較

各マトリックスを構成することで、次の指標のうちの 2 つを比較できます。x 軸と y 軸のプルダウン リストから次の値を選択します。

マトリックスの構成

ステータス コード指標の詳細の表示

特定の指標の詳細を表示するには、マトリックス内の対象ブロックをクリックします。

ブロックの選択

以下のような疑わしい原因に関する詳細が右ペインに表示されます。

  • 環境
  • 組織
  • 地域
  • 障害ソース（プロキシ、ターゲット、または Apigee インフラストラクチャ）

詳細には次の情報が含まれる場合もあります。

  • 障害ポリシー - ポリシータイプ（内部名）、ユーザー定義のポリシー名など、ランタイム エラーをトリガーしたポリシーに関する情報。API プロキシフローにポリシーをアタッチするときに名前を定義します。
  • プロキシ名
  • HTTP ステータス コード
  • 障害コード

カーディナリティが特定の指標より大きい場合、詳細パネルには、デベロッパー アプリ別の分布、フォールト ポリシー別の分布、フォールト コード別の分布、HTTP ステータス別の分布など、エラーの分布の詳細が表示される場合があります。次に例を示します。

分布数の分類

障害ソースがターゲットの場合、詳細パネルにはターゲットごとのエラー率が表示されます。次に例を示します。

ターゲット別のエラー率

レイテンシ ダッシュボードの使用

[レイテンシ] ダッシュボードには、組織の API プロキシとターゲット サービスのレイテンシ情報が表示されます。過去 30 日間のレイテンシ指標を 1 時間の枠でいつでも調査できます。

[レイテンシ] ダッシュボードを詳しく確認する

[レイテンシ] ダッシュボードを表示するには、Edge UI で [Analyze] > [API Monitoring] > [Investigate] を選択します。デフォルトでは、[ステータス コード] ダッシュボードが表示されます。フィルタエリアで [レイテンシ] を選択し、次に示す [レイテンシ] ダッシュボードを表示します。

[レイテンシ] ページ

[レイテンシ] ダッシュボードを選択すると、デフォルトでは次のマトリックスが表示されます。

  • プロキシと時間（ミリ秒単位の最大レイテンシ）
  • プロキシと合計レイテンシ（ミリ秒単位の最大レイテンシ）
  • プロキシ レイテンシとすべてのターゲット レイテンシ（ミリ秒単位の最大レイテンシ）

ターゲットのレイテンシを表示するには、[プロキシ] プルダウン ボックスで [ターゲット] を選択します。

デフォルトでは、[レイテンシ] ダッシュボードには、直近 1 時間に P99 の合計レイテンシが最も高かった 10 個のプロキシに関する情報が表示されます。 あるいは [Top 10] プルダウン ボックスを使用して、特定のプロキシまたはコレクションを選択します。

[レイテンシ] ダッシュボードでは、[ステータス コード] ダッシュボードのすべての機能を利用できますが、次の点が異なります。

  • 合計レスポンス レイテンシ パーセンタイル（p50、p90、p95、p99）のみを構成します。
  • レイテンシ指標に対して 1 時間枠のみを選択できます。
  • フィルタでは [リージョン] に対して [任意] は選択できません。表示する特定のリージョンを選択する必要があります。

レイテンシ指標の詳細を表示する

特定の指標の詳細を表示するには、マトリックス内の対象ブロックをクリックします。

ブロックの選択

以下を含む、プロキシのレイテンシに関する詳細（青色の行）とターゲット（紫色の行）が右ペインに表示されます。

  • レイテンシの合計（プロキシ レイテンシとターゲット レイテンシの合計）
  • ターゲット別のレイテンシ（ターゲットのレスポンス時間）
  • HTTP ステータス別の分布数

グラフにカーソルを合わせると、次のような詳細な情報が表示されます。

レイテンシ指標ビュー

[ターゲットあたりのレイテンシ] グラフには、最大レイテンシに基づく上位 16 個のターゲットが表示されます。ターゲットごとに 1 つのグラフが表示されます。グラフにカーソルを合わせるか、プルダウン リストを選択して、各ターゲットに対応するグラフを決定します。

指標の詳細からのログの表示

ステータス コードまたはレイテンシの指標の詳細を表示しているときに、[ログを表示] をクリックすると、選択した指標のすべてのログが表示されます。

選択

[トラフィック ログ] ダイアログ ボックスが開き、最大 1000 件のログエントリが表示されます。 ログエントリをクリックして、その詳細をリストに展開します。

ログ

以下によって、ログをさらにフィルタリングできます。

  • トラフィック ソース
  • エラーの種類
  • 最小応答時間

[トラフィック ログ] ダイアログからログデータをダウンロードすることはできません。ただし、カスタム レポートを作成するか、Google Cloud Storage や BigQuery などの独自のデータ リポジトリに分析データをダウンロードして、独自のデータ分析を実行できます。

Investigate ダッシュボードからのカスタム レポートの作成

選択した条件に基づいてカスタム レポートを作成します。作成したカスタム レポートは、必要に応じて編集したり、指標とディメンションを追加または削除したりできます。たとえば、調査対象を特定のアクセス トークン、デベロッパー アプリ、API プロキシに制限できます。詳細については、アナリティクス指標、分割項目、フィルタのリファレンスをご覧ください。

詳細については、カスタム レポートの作成をご覧ください。

カスタム レポートを作成する方法は次のとおりです。

  1. マトリックス内のブロックをクリックすると、詳細が表示されます。

    ブロックの選択

  2. 右ペインで カスタム レポートの作成 をクリックします。

    レポートの作成

    新しいタブにカスタム レポート ページが表示されます。関連するフィールドにはデータがすでに入力されています。

    注: デフォルトのカスタム レポート設定の詳細については、カスタム レポートの作成をご覧ください。

    レポートの編集

  3. 必要に応じて、カスタム レポートを編集します。カスタム レポートを管理するをご覧ください。

  4. [保存] をクリックしてカスタム レポートを保存します。

レポートはデフォルトで過去 1 時間に収集されたデータを使用して実行され、そのデータはカスタム レポート ダッシュボードに表示されます。カスタム レポート ダッシュボードを詳しく見るをご覧ください。

レポートページでは、API Monitoring を使用して生成されたカスタム レポートに「API Monitoring Investigate Generated」という形式の名前が付けられます。

特定のアラートを調査する

特定のアラートを調査するには、[Alert History] ページでアラートの名前を選択します。[Investigate] ダッシュボードが表示されます。ダッシュボードの上部にグラフが表示され、アラート固有の情報のみが含まれています。

アラートページの調査

  • アラートがトリガーされた時点の API トラフィックの詳細が表示されます。
  • アラートがトリガーされた時刻など、アラートに関するコンテキスト情報がグラフの中央に表示されます。
  • [条件の詳細] をクリックすると、ポップアップ ウィンドウにアラート条件の詳細が表示されます。

  • [Playbook]（利用可能な場合）をクリックすると、アラートのプレイブックが表示されます。

    プレイブックのリンク

  • [アラートを管理] をクリックして、アラートを編集します。

  • [レポートを表示]（利用可能な場合）をクリックすると、カスタム レポートが表示されます。

  • 必要に応じて、ページの自動更新を有効または無効にできます。