要求トレースを使用して API をデバッグするDebug your APIs using request tracing

このチュートリアルでは、API のデバッグとトラブルシューティングに役立つ要求処理の検査方法について説明します。This tutorial describes how to inspect request processing to help you with debugging and troubleshooting your API.

このチュートリアルでは、以下の内容を学習します。In this tutorial, you learn how to:

  • 呼び出しのトレースTrace a call

API インスペクター

前提条件Prerequisites

呼び出しのトレースTrace a call

API のトレース

  1. [API] を選択します。Select APIs.

  2. API の一覧で [Demo Conference API](デモ会議 API) をクリックします。Click Demo Conference API from your API list.

  3. [テスト] タブに切り替えます。Switch to the Test tab.

  4. [GetSpeakers] 操作を選択します。Select GetSpeakers operation.

  5. Ocp-Apim-Trace という名前の HTTP ヘッダーを、値を true に設定して含めます。Make sure to include an HTTP header named Ocp-Apim-Trace with the value set to true.

    注意

    Ocp-Apim-Subscription-Key が自動的に入力されない場合は、開発者ポータルに移動し、プロファイル ページのキーを公開することで取得できます。If Ocp-Apim-Subscription-Key is not automatically populated, you can retrieve it by going to the Developer Portal and exposing the keys on the profile page.

  6. [送信] をクリックして、API 呼び出しを行います。Click "Send" to make an API call.

  7. 呼び出しが完了するのを待ちます。Wait for the call to complete.

  8. API コンソール[トレース] タブに移動します。Go to the Trace tab in the API console. 詳細なトレース情報に移動するには、リンク ( [受信][バックエンド][送信] ) をクリックします。You can click any of the following links to jump to detailed trace info: inbound, backend, outbound.

    [受信] セクションには、API Management が呼び出し元から受信した元の要求と、要求に適用されるすべてのポリシー (手順 2. で追加した rate-limit、set-header ポリシーなど) が表示されます。In the inbound section, you see the original request API Management received from the caller and all the policies applied to the request including the rate-limit and set-header policies we added in step 2.

    [バックエンド] セクションには、API Management が API バックエンドに送信した要求と、受信した応答が表示されます。In the backend section, you see the requests API Management sent to the API backend and the response it received.

    [送信] セクションには、呼び出し元に送り返される前に応答に適用されるすべてのポリシーが表示されます。In the outbound section, you see all the policies applied to the response before sending back to the caller.

    ヒント

    各ステップには、API Management が要求を受信してからの経過時間も表示されます。Each step also shows the elapsed time since the request is received by API Management.

次の手順Next steps

このチュートリアルでは、以下の内容を学習しました。In this tutorial, you learned how to:

  • 呼び出しのトレースTrace a call

次のチュートリアルに進みます。Advance to the next tutorial: