問題を調査する

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

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

Edge UI で [Analyze] > [API Monitoring] > [Investigate] を選択して、[Investivate] ダッシュボードを開きます。ダッシュボードには次の 2 つのメインエリアがあります。

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

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

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

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

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

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

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

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

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

ステータス コード ページ

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

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

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

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

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

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

  • 障害コードと時間
  • 障害コードと HTTP ステータス
  • 障害ソースと API プロキシ

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

  • 障害コード
  • 障害ポリシー
  • 障害ソース
  • HTTP ステータス
  • プロキシ
  • 時刻
  • 諸国
  • ターゲット(ターゲット サービスまたは ServiceCallout ポリシー)。ターゲットが ServiceCallout ポリシーの場合、表示される値の先頭に sc:// が付加されます。例: sc://my.endpoint.net)。

マトリックスの構成

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

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

ブロックの選択

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

  • 環境
  • 組織
  • 諸国
  • 障害ソース(プロキシ、ターゲット、または Apigee インフラストラクチャ)

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

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

特定の指標のカーディナリティが 1 より大きい場合、詳細パネルには、デベロッパー アプリ別の分布、障害ポリシー別の分布、障害コード別の分布、HTTP ステータス別の分布などのエラー分布の詳細が含まれることがあります。例:

分布数の分類

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

ターゲット別のエラー率

Latency ダッシュボードを使用する

[レイテンシ] ダッシュボードには、組織内の 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](利用可能な場合)をクリックすると、アラートのプレイブックが表示されます。

    プレイブックのリンク

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

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

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