title | description | services | documentationcenter | author | manager | editor | ms.service | ms.workload | ms.tgt_pltfrm | ms.devlang | ms.custom | ms.topic | ms.date | ms.author |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Debug your APIs using request tracing in Azure API Management | Microsoft Docs |
Follow the steps of this tutorial to learn how to inspect request processing steps in Azure API Management. |
api-management |
vladvino |
cfowler |
api-management |
mobile |
na |
na |
mvc |
tutorial |
06/15/2018 |
apimpm |
This tutorial describes how to inspect request processing to help you with debugging and troubleshooting your API.
In this tutorial, you learn how to:
[!div class="checklist"]
- Trace a call
- Learn the Azure API Management terminology.
- Complete the following quickstart: Create an Azure API Management instance.
- Also, complete the following tutorial: Import and publish your first API.
-
Select APIs.
-
Click Demo Conference API from your API list.
-
Switch to the Test tab.
-
Select GetSpeakers operation.
-
Make sure to include an HTTP header named Ocp-Apim-Trace with the value set to true.
[!NOTE] 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.
-
Click "Send" to make an API call.
-
Wait for the call to complete.
-
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.
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.
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.
[!TIP] Each step also shows the elapsed time since the request is received by API Management.
In this tutorial, you learned how to:
[!div class="checklist"]
- Trace a call
Advance to the next tutorial:
[!div class="nextstepaction"] Use revisions