注: このプロダクトの一部の機能はベータ版です。ハイブリッド インストール オプションは一般提供です。ベータ版プログラムに参加するには、Apigee の担当者にお問い合わせください。

Trace を使用してメッセージ データを表示します。

ラボの内容

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

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

必要なもの

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

API プロキシの Trace ツールを使用すると、API プロキシのリクエスト / レスポンス フローのヘッダー、変数、オブジェクト、レスポンス時間などの詳細を表示できます。また、Trace ツールを使用すると、API プロキシによって処理されるとリクエストまたはレスポンスがどのように変化するかを確認できます。

前のチュートリアルで、SpikeArrest ポリシーを使用してリクエスト数を制限しました。次に、トレースツールを使用して、そのレートを超えた場合の興味深い詳細情報を確認します。

  1. API プロキシの [Develop] タブで、Spike Arrest ポリシーの <Rate>1pm に再度編集し、プロキシに [保存] しますこれにより、成功した API 呼び出しと失敗した(制限オーバーの)API 呼び出しの両方を確認できるようになります。
  2. API プロキシ エディタで [Trace] タブをクリックします。

  3. [Trace セッションの開始] で、プロキシがデプロイされている環境を選択します。
  4. [Trace セッションの開始] をクリックします。
  5. [Trace のトランザクション] ペインに 1 つ以上の 200 レスポンスと 1 つの 429 レスポンスが表示されるまで、curl を使用して(またはウェブブラウザで URL を使用して)API プロキシを繰り返し呼び出します。

    curl -v -k https://$EXTERNAL_IP/myproxy

    ここで、$EXTERNAL_IP は外部ロードバランサの IP アドレスです。この IP アドレスはインターネットに公開されます。詳細については、ルーティングの構成をご覧ください。

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

    [フェーズ詳細] ペインに、フローのそのポイントで利用できるデータが表示されます。このペインをスクロールすると、HTTP レスポンスのヘッダーと本文の内容を確認できます。

  8. Trace でエラーを確認します。

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

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

    Spike Arrest エラー

フロー図の [戻る]ボタンと [次へ]ボタンをクリックしてフロー内のポイント間を移動すると、Trace の詳細を表示できます。

Trace 全体を 1 つのドキュメントとして表示するには、[Trace セッションのダウンロード] をクリックしてダウンロードします。

詳細については、Trace ツールの使用をご覧ください。