このページの内容は Apigee と Apigee ハイブリッドに該当します。
Apigee Edge のドキュメントを表示する
学習内容
このチュートリアルでは、次のことを学習します。
- レスポンス メッセージのヘッダーと本文の内容を確認する方法。
- エラー メッセージを確認する方法。
必要なもの
- 始める前に、概要と前提条件の手順を完了してください。
- 1 つ以上のプロキシ内のポリシー
- マシンに実装した
curl。コマンドラインから API 呼び出しを行うときに必要です。
メッセージ データを表示する
Apigee プロキシ エディタのデバッグビューでは、ヘッダー、変数、オブジェクトなど、API プロキシ リクエストとレスポンス フローのレスポンス時間などの詳細を表示できます。さらに、API プロキシによる処理に従ってリクエストまたはレスポンスがどのように変化するかも確認できます。デバッグビューの詳細については、デバッグの使用をご覧ください。
前のチュートリアルで、SpikeArrest ポリシーを使用してリクエスト数を制限しました。このページでは、レートを超過した場合にどうなるかを確認するため、デバッグビューの使い方について説明します。
新しいプロキシ エディタ
- API プロキシの [Develop] タブで、Spike Arrest ポリシーの
<Rate>が再び 1pm になるように編集し、[Save] をクリックしてプロキシを保存します。これにより、成功した API 呼び出しと失敗した（制限オーバーの）API 呼び出しの両方を確認できるようになります。 - プロキシ エディタで [Debug] タブをクリックします。
- [Start Debug Session] をクリックします。
- デバッグ セッションを実行する環境を選択します。
- （省略可）[フィルタ] プルダウン リストから、作成するデバッグ セッションのすべてのトランザクションに適用するフィルタを選択します。デフォルトは
None (All transactions)で、これにはトレースデータ内のすべてのトランザクションが含まれます。フィルタの使用方法については、デバッグ セッションでのフィルタの使用をご覧ください。組み込みフィルタの詳細については、定義済みフィルタの使用をご覧ください。
- [起動] をクリックします。
-
左側のペインに少なくとも 1 つの
200レスポンスと 1 つの429レスポンスが表示されるまで、curlを使用して（またはウェブブラウザで URL を使用して）、再度 API プロキシを複数回呼び出します。
- 左側の [Transactions] ペインで、
429トランザクションをクリックします。これにより、右側のペインにトランザクションのガントチャートが表示されます。
Spike Arrest ポリシーの行があり、エラーアイコン付きで表示されます。
「エラー」というラベルの付いた行をクリックします。グラフの右側にエラーの詳細が表示されます。次の図に、エラーの詳細の [Properties] セクションを示します。
ダイアログで操作する場合:
ガントチャートの下にある [Back] ボタンと [Next] ボタンをクリックすると、フロー内のステップ間を移動して、各ステップの詳細を確認できます。
デバッグ セッション全体を 1 つのドキュメントとしてダウンロードするには、[Download Session] をクリックします。デバッグ セッションは、終了後 24 時間で削除されるため、それ以降にセッションを表示する場合は、事前にダウンロードしておく必要があります。
従来バージョンのプロキシ エディタ
- API プロキシの [Develop] タブで、Spike Arrest ポリシーの
<Rate>が再び 1pm になるように編集し、[Save] をクリックしてプロキシを保存します。これにより、成功した API 呼び出しと失敗した（制限オーバーの）API 呼び出しの両方を確認できるようになります。 - プロキシ エディタで [Debug] タブをクリックします。
- [Start a debug session] で、プロキシがデプロイされている環境を選択します。
- [Start Debug Session] をクリックします。
-
[Debug Transactions] ペインに 1 つ以上の
200レスポンスと 1 つの429レスポンスが表示されるまで、curlを使用して（またはウェブブラウザで URL を使用して）API プロキシを繰り返し呼び出します。curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy
ここで、
YOUR ENV_GROUP_HOSTNAMEは環境グループのホスト名です。環境グループのホスト名を探すをご覧ください。200レスポンスと429レスポンスを以下に示します。
- 左側の [Transactions] ペインで、
200トランザクションをクリックします。このデバッグの詳細が、メイン ウィンドウのトランザクション マップに読み込まれ、リクエスト / レスポンス図が表示されます。Spike Arrest アイコンはリクエスト フローにあります。 - フロー図で、レスポンス フローの右端にある丸いアイコン（下の図で示されているアイコン）をクリックします。
[Phase Details] ペインに、フローのその時点で使用可能なデータが表示されます。このペインをスクロールすると、HTTP レスポンスのヘッダーと本文の内容を確認できます。
- 次は、デバッグでエラーを調べます。
[Transactions] ペインで
429トランザクションをクリックします。メイン エディタ ウィンドウに、リクエスト内のアイテムのみを含むフロー図が表示されます。フロー図にはエラーを示す赤い感嘆符が付いた Spike Arrest アイコンも表示されます。Spike Arrest アイコンの右側にある小さなチューブ型のエラーアイコンをクリックし、[Phase Details] ペインで Spike Arrest ポリシー違反の詳細を確認します。
フロー図内の [Back] ボタンや [Next] ボタンをクリックすると、フロー内のポイント間を移動してデバッグの詳細を確認できます。
デバッグ セッション全体を 1 つのドキュメントとして表示する場合は、[Download Debug Session] をクリックしてダウンロードします。
詳細については、デバッグの使用をご覧ください。