Självstudie: Felsöka API:er med hjälp av spårning av förfrågningar

Den här självstudien beskriver hur du inspekterar (spårar) bearbetning av begäran i Azure API Management som hjälper dig att felsöka ditt API.

I den här guiden får du lära dig att:

  • Spåra ett exempelsamtal
  • Granska bearbetningssteg för begäran

API Inspector

Förutsättningar

Kontrollera inställningen Tillåt spårning

Inställningen Tillåt spårning för prenumerationen som används för ditt API måste vara aktiverad. Om du använder den inbyggda prenumerationen för all åtkomst är den aktiverad som standard. Om du vill verifiera i portalen går du till din API Management-instans och väljer Prenumerationer.

Tillåt spårning för prenumeration

Spåra ett anrop

  1. Logga in på Azure Portaloch gå till din API Management instans.
  2. Välj API:er.
  3. Välj Demo Conference API (Demokonferens-API) i din API-lista.
  4. Välj fliken Test.
  5. Välj åtgärden GetSpeakers.
  6. Bekräfta att HTTP-begärandehuvudet innehåller Ocp-Apim-Trace: True och ett giltigt värde för Ocp-Apim-Subscription-Key. Om den inte är det väljer du + Lägg till rubrik för att lägga till rubriken.
  7. Välj Skicka för att göra ett API-anrop.

Konfigurera API-spårning

Tips

Om Ocp-Apim-Subscription-Key inte fylls i automatiskt i HTTP-begäran kan du hämta den i portalen. Välj Prenumerationer och öppna snabbmenyn (...) för din prenumeration. Välj Visa/dölj nycklar. Du kan också återskapa nycklar om det behövs. Lägg sedan till en nyckel i rubriken.

Granska spårningsinformation

  1. När anropet har slutförts går du till fliken Trace (Spåra) i HTTP-svaret.

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

    Granska svarsspårning

    • Inkommande – Visar den ursprungliga API Management tas 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 APIvisas de här.

    • Backend – Visar de begäranden API Management skickas till API-backend och det svar som togs emot.

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

    Tips

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

  3. På fliken Meddelande visar rubriken ocp-apim-trace-location platsen för de spårningsdata som lagras i Azure Blob Storage. Om det behövs går du till den här platsen för att hämta spårningen.

    Spårningsplats i Azure Storage

Nästa steg

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

  • Spåra ett exempelsamtal
  • Granska bearbetningssteg för begäran

Gå vidare till nästa kurs: