デバッグビューを使用してメッセージ データを表示する

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

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

学習内容

このチュートリアルでは、次のことを学習します。

  • レスポンス メッセージのヘッダーと本文の内容を確認する方法。
  • エラー メッセージを確認する方法。

必要なもの

メッセージ データを表示する

Apigee プロキシ エディタのデバッグビューでは、ヘッダー、変数、オブジェクトなど、API プロキシ リクエストとレスポンス フローのレスポンス時間などの詳細を表示できます。さらに、API プロキシによる処理に従ってリクエストまたはレスポンスがどのように変化するかも確認できます。デバッグビューの詳細については、デバッグの使用をご覧ください。

前のチュートリアルで、SpikeArrest ポリシーを使用してリクエスト数を制限しました。このページでは、レートを超過した場合にどうなるかを確認するため、デバッグビューの使い方について説明します。

新しいプロキシ エディタ

  1. API プロキシの [Develop] タブで、Spike Arrest ポリシーの <Rate> が再び 1pm になるように編集し、[Save] をクリックしてプロキシを保存します。これにより、成功した API 呼び出しと失敗した(制限オーバーの)API 呼び出しの両方を確認できるようになります。
  2. プロキシ エディタで [Debug] タブをクリックします。
  3. [Start Debug Session] をクリックします。
  4. ダイアログで操作する場合:

    1. デバッグ セッションを実行する環境を選択します。
    2. (省略可)[フィルタ] プルダウン リストから、作成するデバッグ セッションのすべてのトランザクションに適用するフィルタを選択します。デフォルトは None (All transactions) で、これにはトレースデータ内のすべてのトランザクションが含まれます。

      フィルタの使用方法については、デバッグ セッションでのフィルタの使用をご覧ください。組み込みフィルタの詳細については、定義済みフィルタの使用をご覧ください。

    3. [起動] をクリックします。
  5. 左側のペインに少なくとも 1 つの 200 レスポンスと 1 つの 429 レスポンスが表示されるまで、curlを使用して(またはウェブブラウザで URL を使用して)、再度 API プロキシを複数回呼び出します。

    デバッグビューのステータス 200 と 439。

  6. 左側の [Transactions] ペインで、429 トランザクションをクリックします。これにより、右側のペインにトランザクションのガントチャートが表示されます。

    ガントチャートにステータス 429 のトランザクションが表示されます。

    Spike Arrest ポリシーの行があり、エラーアイコン付きで表示されます。

  7. エラー」というラベルの付いた行をクリックします。グラフの右側にエラーの詳細が表示されます。次の図に、エラーの詳細の [Properties] セクションを示します。

    Spike Arrest エラーの詳細。

ガントチャートの下にある [Back] ボタンと [Next] ボタンをクリックすると、フロー内のステップ間を移動して、各ステップの詳細を確認できます。

デバッグ セッション全体を 1 つのドキュメントとしてダウンロードするには、[Download Session] をクリックします。デバッグ セッションは、終了後 24 時間で削除されるため、それ以降にセッションを表示する場合は、事前にダウンロードしておく必要があります。

従来バージョンのプロキシ エディタ

  1. API プロキシの [Develop] タブで、Spike Arrest ポリシーの <Rate> が再び 1pm になるように編集し、[Save] をクリックしてプロキシを保存します。これにより、成功した API 呼び出しと失敗した(制限オーバーの)API 呼び出しの両方を確認できるようになります。
  2. プロキシ エディタで [Debug] タブをクリックします。
  3. [Start a debug session] で、プロキシがデプロイされている環境を選択します。
  4. [Start Debug Session] をクリックします。
  5. [Debug Transactions] ペインに 1 つ以上の 200 レスポンスと 1 つの 429 レスポンスが表示されるまで、curl を使用して(またはウェブブラウザで URL を使用して)API プロキシを繰り返し呼び出します。

    curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy

    ここで、YOUR ENV_GROUP_HOSTNAME は環境グループのホスト名です。環境グループのホスト名を探すをご覧ください。

    200 レスポンスと 429 レスポンスを以下に示します。

    200 レスポンスと 429 レスポンスによる Apigee UI でのデバッグ セッション。

  6. 左側の [Transactions] ペインで、200 トランザクションをクリックします。このデバッグの詳細が、メイン ウィンドウのトランザクション マップに読み込まれ、リクエスト / レスポンス図が表示されます。Spike Arrest アイコンはリクエスト フローにあります。
  7. フロー図で、レスポンス フローの右端にある丸いアイコン(下の図で示されているアイコン)をクリックします。

    [Phase Details] ペインに、フローのその時点で使用可能なデータが表示されます。このペインをスクロールすると、HTTP レスポンスのヘッダーと本文の内容を確認できます。

  8. 次は、デバッグでエラーを調べます。

    [Transactions] ペインで 429 トランザクションをクリックします。メイン エディタ ウィンドウに、リクエスト内のアイテムのみを含むフロー図が表示されます。フロー図にはエラーを示す赤い感嘆符が付いた Spike Arrest アイコンも表示されます。

    Spike Arrest アイコンの右側にある小さなチューブ型のエラーアイコンをクリックし、[Phase Details] ペインで Spike Arrest ポリシー違反の詳細を確認します。

    Spike Arrest エラー

フロー図内の [Back] ボタンや [Next] ボタンをクリックすると、フロー内のポイント間を移動してデバッグの詳細を確認できます。

デバッグ セッション全体を 1 つのドキュメントとして表示する場合は、[Download Debug Session] をクリックしてダウンロードします。

詳細については、デバッグの使用をご覧ください。