Zelfstudie: Fouten opsporen in uw API's met behulp van de tracering van aanvragen
In deze zelfstudie wordt beschreven hoe u aanvraagverwerking controleert (traceert) in Azure API Management om u te helpen fouten op te sporen en problemen op te lossen in uw API.
In deze zelfstudie leert u het volgende:
- Een voorbeeld van een aanroep traceren
- Aanvraagverwerkingsstappen controleren
Vereisten
- Informatie over de terminologie van Azure API Management.
- Voltooi de volgende snelstartgids: Een Azure API Management-exemplaar maken.
- Voltooi de volgende zelfstudie: Uw eerste API importeren en publiceren.
Instelling 'Traceren toestaan' verifiëren
De instelling Traceren toestaan voor het abonnement dat voor uw API wordt gebruikt, moet ingeschakeld zijn. Als u het ingebouwde all-access abonnement gebruikt, is de instelling standaard ingeschakeld. Om dit te verifiëren in de portal, gaat u naar uw exemplaar van API Management en selecteert u Abonnementen.
Een aanroep traceren
- Meld u aan bij de Azure-portal en ga naar uw exemplaar van API Management.
- Selecteer API's.
- Selecteer Demo Conference-API in uw lijst met API's.
- Selecteer het tabblad Testen.
- Selecteer de bewerking GetSpeakers.
- Bevestig dat de HTTP-aanvraagheader Ocp-Apim-Trace: True en een geldige waarde voor Ocp-Apim-Subscription-Key bevat. Als dat niet het geval is, selecteert u + Header toevoegen om de header toe te voegen.
- Selecteer Verzenden om een API-aanroep te maken.
Tip
Als Ocp-Apim-Subscription-Key niet automatisch is ingevuld in de HTTP-aanvraag, kunt u deze ophalen in de portal. Selecteer Abonnementen en open het contextmenu ( ... ) voor uw abonnement. Selecteer Sleutels weergeven/verbergen. U kunt sleutels indien nodig ook opnieuw genereren. Voeg vervolgens een sleutel aan de header toe.
Traceringsgegevens controleren
Nadat de aanroep is voltooid, gaat u naar het tabblad Tracering in het HTTP-antwoord.
Selecteer een van de volgende koppelingen om naar gedetailleerde traceringsgegevens te gaan: Inkomend, Back-end, Uitgaand.
Inkomend: Toont de oorspronkelijke aanvraag die API Management van de aanroepende functie heeft ontvangen en de beleidsregels die op de aanvraag worden toegepast. Als u bijvoorbeeld beleidsregels hebt toegevoegd in Zelfstudie: Uw API transformeren en beveiligen, worden ze daar weergegeven.
Back-end: Toont de aanvragen die API Management naar de API-back-end heeft verzonden en het antwoord daarop.
Uitgaand: Toont de beleidsregels die op het antwoord worden toegepast voordat het naar de aanroepende functie wordt teruggestuurd.
Tip
Bij elke stap wordt ook de verstreken tijd weergegeven vanaf dat de aanvraag is ontvangen door de API Management.
Op het tabblad Bericht toont de header ocp-apim-trace-location de locatie van de traceringsgegevens die in Azure Blob Storage zijn opgeslagen. Ga indien nodig naar deze locatie om de traceringsgegevens op te halen.
Volgende stappen
In deze zelfstudie heeft u het volgende geleerd:
- Een voorbeeld van een aanroep traceren
- Aanvraagverwerkingsstappen controleren
Ga door naar de volgende zelfstudie: