Självstudie: Felsöka dina API:er med hjälp av spårning av begäranden

GÄLLER FÖR: Förbrukning | Utvecklare | Grundläggande | Standard | Premium

I den här självstudien beskrivs hur du inspekterar (spårning) bearbetning av begäranden i Azure API Management. Spårning hjälper dig att felsöka ditt API.

I den här självstudien lär du dig att:

Förutsättningar

• Lär dig Azure API Management-terminologin.
• Slutför följande snabbstart: Skapa en Azure API Management-instans.
• Slutför följande självstudie: Importera och publicera ditt första API.

Spåra ett anrop i portalen

1. Logga in på Azure-portalen och gå till din API Management-instans.

2. Välj API:er.

3. Välj Demo Conference API i din API-lista.

4. Välj fliken Test.

5. Välj åtgärden GetSpeakers.

6. Du kan också kontrollera värdet för rubriken Ocp-Apim-Subscription-Key som används i begäran genom att välja ikonen "eye".

   Dricks

   Du kan åsidosätta värdet ocp-apim-subscription-key genom att hämta en nyckel för en annan prenumeration i portalen. Välj Prenumerationer och öppna snabbmenyn (...) för en annan prenumeration. Välj Visa/dölj nycklar och kopiera en av nycklarna. Du kan också återskapa nycklar om det behövs. I testkonsolen väljer du sedan + Lägg till rubrik för att lägga till ett Ocp-Apim-Subscription-Key-huvud med det nya nyckelvärdet.

7. Välj Spåra.

Granska spårningsinformation

1. När anropet är klart går du till fliken Spårning i HTTP-svaret.

2. Välj någon av följande länkar för att gå till detaljerad spårningsinformation: Inkommande, Serverdel, Utgående, På-fel.

   

   • Inkommande – visar den ursprungliga begäran som API Management tog emot från anroparen och de principer som tillämpas på begäran. Om du till exempel har lagt till principer i Självstudie: Transformera och skydda ditt API visas de här.

   • Serverdelen – Visar begäranden som API Management skickade till API-serverdelen och det svar som den tog emot.

   • Utgående – Visar de principer som tillämpas på svaret innan du skickar tillbaka till anroparen.

   • Vid fel – Visar de fel som inträffade under bearbetningen av begäran och de principer som tillämpas på felen.

   Dricks

   Alla steg visar också hur lång tid det tog efter att begäran togs emot av API Management.

Aktivera spårning för ett API

Du kan aktivera spårning för ett API när du gör begäranden till API Management med hjälp av curl, en REST-klient som Visual Studio Code med REST-klienttillägget eller en klientapp.

Aktivera spårning genom att följa stegen nedan med hjälp av anrop till API Management REST API.

1. Hämta spårningsautentiseringsuppgifter genom att anropa API:et för listfelsökningsautentiseringsuppgifter . Skicka gateway-ID:t i URI:n eller använd "hanterad" för instansens hanterade gateway i molnet. Om du till exempel vill hämta spårningsautentiseringsuppgifter för den hanterade gatewayen använder du ett anrop som liknar följande:

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/managed/listDebugCredentials?api-version=2023-05-01-preview
   

   I begärandetexten skickar du det fullständiga resurs-ID:t för det API som du vill spåra och anger purposes som tracing. Som standard upphör tokenautentiseringsuppgifterna som returneras i svaret att gälla efter 1 timme, men du kan ange ett annat värde i nyttolasten.

   {
       "credentialsExpireAfter": PT1H,
       "apiId": "<API resource ID>",
       "purposes: ["tracing"]
   }
   

   Tokenautentiseringsuppgifterna returneras i svaret, ungefär som följande:

   {
         "token": "aid=api-name&p=tracing&ex=......."
   }
   

2. Om du vill aktivera spårning för en begäran till API Management-gatewayen skickar du tokenvärdet i ett Apim-Debug-Authorization huvud. Om du till exempel vill spåra ett anrop till demokonferens-API:et använder du ett anrop som liknar följande:

   curl -v GET https://apim-hello-world.azure-api.net/conference/speakers HTTP/1.1 -H "Ocp-Apim-Subscription-Key: <subscription-key>" -H "Apim-Debug-Authorization: aid=api-name&p=tracing&ex=......."
   

3. Beroende på token innehåller svaret olika rubriker:

   • Om token är giltig innehåller svaret en Apim-Trace-Id rubrik vars värde är spårnings-ID:t.
   • Om token har upphört att gälla innehåller svaret en Apim-Debug-Authorization-Expired rubrik med information om förfallodatum.
   • Om token hämtades för fel API innehåller svaret en Apim-Debug-Authorization-WrongAPI rubrik med ett felmeddelande.

4. Om du vill hämta spårningen skickar du spårnings-ID:t som erhölls i föregående steg till API:et listspårning för gatewayen. Om du till exempel vill hämta spårningen för den hanterade gatewayen använder du ett anrop som liknar följande:

   POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/managed/listTrace?api-version=2023-05-01-preview
   

   I begärandetexten skickar du spårnings-ID:t som erhölls i föregående steg.

   {
       "traceId": "<trace ID>"
   }
   

   Svarstexten innehåller spårningsdata för den tidigare API-begäran till gatewayen. Spårningen liknar den spårning som du kan se genom att spåra ett anrop i portalens testkonsol.

Information om hur du anpassar spårningsinformation finns i spårningsprincipen .

Nästa steg

I den här självstudiekursen lärde du dig att:

Gå vidare till nästa kurs: