API プロキシ パフォーマンス

このページの内容は Apigee と Apigee ハイブリッドに該当します。

Apigee Edge のドキュメントを表示する。

このダッシュボードの内容

[Proxy Performance] ダッシュボードでは、API プロキシのトラフィック パターンと処理時間を確認できます。API によって生成されるトラフィックの量と API 呼び出しの処理にかかる時間（API 呼び出しが Apigee で受信されてからクライアント アプリに返されるまでの時間）を簡単に可視化できます。

[API Proxy Performance] ダッシュボード

[Proxy Performance] ダッシュボードにアクセスするには:

  • Cloud コンソールの Apigee UI を使用している場合: [アナリティクス] > [API 指標]を選択して、[API Proxy Performance] タブをクリックします。
  • 従来の Apigee UI を使用している場合: [Analyze] > [API Metrics] > [API Proxy Performance] を選択します。

[API Proxy Performance] ビューを以下に示します（Cloud コンソール バージョン）。

このダッシュボードの測定内容

このダッシュボードには、以下のグラフがあります。

1 秒あたりの平均トランザクション数（TPS）

指標 説明
平均 TPS 1 秒あたりの API リクエストと結果のレスポンスの平均数。

トラフィック

指標 説明
総トラフィック 組織内の API 環境について Apigee で受信した API リクエストの合計数。
トラフィック完了 レスポンスに成功したリクエストの合計数。エラー レスポンスはカウントされません。
Traffic Errors 失敗したすべての API リクエスト、つまりエンドユーザーが必要とするレスポンスを送信しないリクエストの合計数です。このカウントには、プロキシとターゲットの両方のエラーが含まれます。

平均応答時間

Apigee コミュニティ サイトに、どのような場合に平均合計レスポンス時間が平均ターゲット レスポンス時間を下回るか？という興味深い記事があります。こちらもご覧ください。

指標 説明
平均応答時間

Apigee 組織環境に対して行われたすべての API 呼び出しについて測定された合計レスポンス時間の平均。合計レスポンス時間は、Apigee に対する API 呼び出しが戻るまでにかかる時間（ミリ秒単位）です。

言い換えると、合計レスポンス時間は、Apigee で API 呼び出し全体が受信されたところから、Apigee によってクライアント アプリにレスポンスの返信が開始されるまでの測定時間です。

このグラフでは、すべてのプロキシの平均が測定されます。個々のプロキシについては、以下の Average Response Time by Proxy グラフをご覧ください。
プロキシ レスポンス時間の平均値

この値は、Apigee 組織環境に対して行われるすべての API 呼び出しについて、合計レスポンス時間からターゲット レスポンス時間を引いた値の平均値として計算されます。

基本的には、API 呼び出しが Apigee 自体を通過する時間（ミリ秒単位）の測定です。
ターゲット レスポンス時間の平均値

リクエストの最後のバイトが Apigee からバックエンド ターゲットに送信された時点から、Apigee でレスポンスの最後のバイトが受信されるときまでにかかる平均時間（ミリ秒単位）。

基本的には、API 呼び出しがターゲット システムで費やす時間の測定です。

プロキシ レスポンス時間の平均値は、レスポンスの合計時間の平均値とターゲット レスポンス時間の平均値の差として計算されます。レスポンスの合計時間はターゲット レスポンス時間よりも長くなると想定されます。ただし、プリフライト リクエスト、キャッシュに保存されたレスポンス、バックエンド システムに到達しない OAuth トークンなど、プロキシ自体によって処理される呼び出しもあります。プロキシによるこのような「より速い」呼び出しでは、ターゲット レスポンス時間が短くならずに、レスポンスの合計時間の平均値が短くなります。したがって、レスポンスの合計時間の平均値は、必ずしもターゲット レスポンス時間の平均値より長くなるとは限らず、プロキシ レスポンス時間に負の値が表示されることがあります。期間をあまりズームインせずに大きな TPS を見ると、こうした例外が多くを占めることはないので、より正確で実用的なデータが得られます。

短期間に収集された少数のリクエストではなく、長期間にわたって大量のリクエストが収集されると、有意義な平均レスポンス データが得られます。期間が短く受信したリクエストの数が少ない場合は、ターゲットに到達しない呼び出しが 1 回あるだけで、プロキシ レスポンス時間の平均値が負の値になることがあります。レスポンス時間の平均値を評価する場合は、長い期間で多くのトラフィックを確認することをおすすめします。

プロキシによるトラフィック

指標 説明
<プロキシ名> 指定された API プロキシについて、記録された API リクエストおよびレスポンスの数。

Average Response Time by Proxy

指標 説明
<プロキシ名>

指定された API プロキシについて、Apigee 環境に対して行われたすべての API 呼び出しについて測定された合計レスポンス時間の平均。合計レスポンス時間は、Apigee に対する API 呼び出しが戻るまでにかかる時間（ミリ秒単位）です。

グラフにカーソルを合わせると、プロキシ側とターゲット側で費やされた合計時間と、平均が表示されます。