Dela via

Självstudie: Övervaka publicerade API:er

  • Artikel

GÄLLER FÖR: Alla API Management-nivåer

Med Azure Monitor kan du visualisera, fråga, vidarebefordra, aktivera och vidta åtgärder för mått eller loggar från Azure API Management-tjänsten.

Kommentar

För närvarande är den här funktionen inte tillgänglig på arbetsytor.

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

  • Visa mått för din API
  • Konfigurera en aviseringsregel
  • Visa aktivitetsloggar
  • Aktivera och visa resursloggar

Kommentar

API Management stöder en rad ytterligare verktyg för att observera API:er, inklusive inbyggd analys och integrering med Application Insights. Läs mer

Förutsättningar

Visa mått för dina API:er

API Management genererar mått varje minut, vilket ger dig nästan realtidssynlighet i status och hälsa för dina API:er. Följande är de mått som används oftast. En lista över alla tillgängliga mått finns i Mått som stöds.

  • Kapacitet – hjälper dig att fatta beslut om att uppgradera/nedgradera dina API Management-tjänster. Måttet genereras per minut och återspeglar den uppskattade gatewaykapaciteten vid tidpunkten för rapporteringen. Måttet sträcker sig från 0–100 som beräknas baserat på gatewayresurser som processor- och minnesanvändning och andra faktorer.

    Dricks

    På v2-tjänstnivåerna har API Management ersatt kapacitetsmåttet med separata mått för PROCESSOR- och minnesanvändning. Dessa mått kan också användas för att skala beslut och felsökning. Läs mer

  • Begäranden – hjälper dig att analysera API-trafik som går igenom dina API Management-tjänster. Måttet genereras per minut och rapporterar antalet gatewaybegäranden med dimensioner. Filtrera begäranden efter svarskoder, plats, värdnamn och fel.

Viktigt!

Följande mått har dragits tillbaka: Totalt antal gatewaybegäranden, lyckade gatewaybegäranden, obehöriga gatewaybegäranden, misslyckade gatewaybegäranden, andra gatewaybegäranden. Migrera till måttet Begäranden som innehåller liknande funktioner.

Skärmbild av mått i ÖVERSIKT ÖVER API Management

Så här får du åtkomst till mått:

  1. I Azure Portal navigerar du till din API Management-instans. På sidan Översikt går du till fliken Övervaka och granskar viktiga mått för dina API:er.

  2. Om du vill undersöka mått i detalj väljer du Övervakningsmått> på den vänstra menyn.

    Skärmbild av måttobjektet på övervakningsmenyn i portalen.

  3. I listrutan väljer du mått som du är intresserad av. Till exempel Begäranden.

  4. Diagrammet visar det totala antalet API-anrop. Justera tidsintervallet för att fokusera på perioder av intresse.

  5. Du kan filtrera diagrammet med hjälp av måttet Begäranden . Välj till exempel Lägg till filter, välj Serverdelssvarskodkategori och ange 500 som värde. Diagrammet visar antalet misslyckade begäranden i API-serverdelen.

Konfigurera en aviseringsregel

Du kan ta emot aviseringar baserat på mått och aktivitetsloggar. I Azure Monitor konfigurerar du en aviseringsregel för att utföra en åtgärd när den utlöses. Vanliga åtgärder är:

  • Skicka ett e-postmeddelande
  • Anropa en webbhook
  • Anropa en Azure Logic App

Så här konfigurerar du ett exempel på en aviseringsregel baserat på ett mått för begäran:

  1. I Azure Portal navigerar du till din API Management-instans.

  2. Välj Övervakningsaviseringar> på den vänstra menyn.

    Skärmbild av alternativet Aviseringar på övervakningsmenyn i portalen.

  3. Välj + Skapa>aviseringsregel.

  4. På fliken Villkor :

    1. I Signalnamn väljer du Begäranden.
    2. I Aviseringslogik granskar eller ändrar du standardvärdena för aviseringen. Uppdatera till exempel det statiska tröskelvärdet, vilket är antalet förekomster varefter aviseringen ska utlösas.
    3. I Dela efter dimensioner går du till Dimensionsnamn och väljer Gateway-svarskodkategori.
    4. I Dimensionsvärden väljer du 4xx för klientfel som obehöriga eller ogiltiga begäranden. Om dimensionsvärdet inte visas väljer du Lägg till anpassat värde och anger 4xx.
    5. I När du ska utvärdera godkänner du standardinställningarna eller väljer andra inställningar för att konfigurera hur ofta regeln körs. Välj Nästa.

    Skärmbild av konfiguration av aviseringslogik i portalen.

  5. På fliken Åtgärder väljer eller skapar du en eller flera åtgärdsgrupper för att meddela användarna om aviseringen och vidta en åtgärd. Skapa till exempel en ny åtgärdsgrupp för att skicka ett e-postmeddelande till admin@contoso.com. Detaljerade steg finns i Skapa och hantera åtgärdsgrupper i Azure Portal.

    Skärmbild av hur du konfigurerar meddelanden för en ny åtgärdsgrupp i portalen.

  6. På fliken Information i Skapa en aviseringsregel anger du ett namn och en beskrivning av aviseringsregeln och väljer allvarlighetsgrad.

  7. Du kan också konfigurera de återstående inställningarna. Välj sedan Skapa på fliken Granska + skapa.

  8. Du kan också testa aviseringsregeln med hjälp av en HTTP-klient för att simulera en begäran som utlöser aviseringen. Kör till exempel följande kommando i en terminal och ersätt API Management-värdnamnet med värdnamnet för din API Management-instans:

    curl GET https://contoso.azure-api.net/non-existent-endpoint HTTP/1.1

    En avisering utlöses baserat på utvärderingsperioden och skickar e-post till admin@contoso.com.

    Aviseringar visas också på sidan Aviseringar för API Management-instansen.

    Skärmbild av aviseringar i portalen.

Aktivitetsloggar

Aktivitetsloggar ger insikter om åtgärderna i dina API Management-tjänster. Med aktivitetsloggar kan du bestämma ”vad, vem och när” för skrivåtgärder (PUT, POST, DELETE) som ska vidtas för dina API Management-tjänster.

Kommentar

Aktivitetsloggar omfattar inte läsåtgärder (GET) eller åtgärder som utförs i Azure Portal.

Du kan få åtkomst till aktivitetsloggar i API Management-tjänsten eller få åtkomst till loggar för alla dina Azure-resurser i Azure Monitor.

Skärmbild av aktivitetsloggen i portalen.

Så här visar du aktivitetsloggen:

  1. I Azure Portal navigerar du till din API Management-instans.

  2. Välj Aktivitetslogg.

    Skärmbild av aktivitetsloggobjektet på övervakningsmenyn i portalen.

  3. Välj önskat filtreringsomfång och sedan Använd.

Resursloggar

Resursloggar (Azure Monitor-loggar) innehåller omfattande information om API Management-åtgärder och fel som är viktiga för gransknings- och felsökningsändamål. När de aktiveras via en diagnostikinställning samlar loggarna in information om API-begäranden som tas emot och bearbetas av API Management-gatewayen.

Kommentar

Förbrukningsnivån stöder inte insamling av resursloggar.

Så här konfigurerar du resursloggar:

  1. I Azure Portal navigerar du till din API Management-instans.

  2. Välj Övervaka>diagnostikinställningar.

    Skärmbild av objektet Diagnostikinställningar på övervakningsmenyn i portalen.

  3. Väj + Lägg till diagnostikinställning.

  4. Välj de loggar eller mått som du vill samla in.

    Du har flera alternativ för var loggarna och måtten ska skickas. Du kan till exempel arkivera resursloggar tillsammans med mått till ett lagringskonto, strömma dem till en händelsehubb eller skicka dem till en Log Analytics-arbetsyta.

    Dricks

    Om du väljer en Log Analytics-arbetsyta kan du välja att lagra data i den resursspecifika tabellen ApiManagementGatewayLogs eller lagra dem i den allmänna AzureDiagnostics-tabellen. Vi rekommenderar att du använder den resursspecifika tabellen för loggmål som stöder den. Läs mer

  5. När du har konfigurerat information för loggmålet eller mål väljer du Spara.

Kommentar

Om du lägger till ett objekt för diagnostikinställningar kan det leda till ett fel om egenskapen MinApiVersion för API Management-tjänsten har angetts till en API-version som är högre än 2022-09-01-preview.

Mer information finns i Skapa diagnostikinställningar för att skicka plattformsloggar och mått till olika mål.

Visa loggar och mått i Azure Monitor

Om du aktiverar insamling av loggar eller mått på en Log Analytics-arbetsyta kan det ta några minuter innan data visas i Azure Monitor.

Så här visar du data:

  1. I Azure Portal navigerar du till din API Management-instans.

  2. Välj Loggar på den vänstra menyn.

    Skärmbild av objektet Loggar på övervakningsmenyn i portalen.

  3. Kör frågor för att visa data. Flera exempelfrågor tillhandahålls eller kör dina egna. Följande fråga hämtar till exempel de senaste 24 timmarna data från tabellen ApiManagementGatewayLogs:

    ApiManagementGatewayLogs
| where TimeGenerated > ago(1d)

    Skärmbild av frågan till tabellen ApiManagementGatewayLogs i portalen.

Mer information om hur du använder resursloggar för API Management finns i:

Ändra API-loggningsinställningar

När du skapar en diagnostikinställning för att aktivera insamling av resursloggar aktiveras loggning som standard för alla API:er med standardinställningar. Du kan justera loggningsinställningarna för alla API:er eller åsidosätta dem för enskilda API:er. Du kan till exempel justera samplingsfrekvensen eller utförligheten för data, aktivera loggning av huvuden eller nyttolaster för begäran eller svar eller inaktivera loggning för vissa API:er.

Mer information om loggningsinställningarna finns i Referens för inställningar för diagnostikloggning.

Så här konfigurerar du loggningsinställningar för alla API:er:

  1. I den vänstra menyn i DIN API Management-instans väljer du API:er API:er>>Alla API:er.
  2. Välj fliken Inställningar i det övre fältet.
  3. Rulla ned till avsnittet Diagnostikloggar och välj fliken Azure Monitor .
  4. Granska inställningarna och gör ändringar om det behövs. Välj Spara.

Så här konfigurerar du loggningsinställningar för ett specifikt API:

  1. I den vänstra menyn i API Management-instansen väljer du API:er>OCH sedan namnet på API:et.
  2. Välj fliken Inställningar i det övre fältet.
  3. Rulla ned till avsnittet Diagnostikloggar och välj fliken Azure Monitor .
  4. Granska inställningarna och gör ändringar om det behövs. Välj Spara.

Viktigt!

Om aktiverad kan loggade nyttolaster för begäran eller svar vara upp till 8 192 byte. API Management tillämpar också en gräns på 32 KB för en diagnostikloggpost som skickas till Azure Monitor, som innehåller nyttolaster och andra attribut som statuskoder, rubriker och tidsstämplar. Om den kombinerade storleken på attributen överskrider 32 KB trimmar API Management posten genom att ta bort allt brödtext- och spårningsinnehåll.

Nästa steg

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

  • Visa mått för din API
  • Konfigurera en aviseringsregel
  • Visa aktivitetsloggar
  • Aktivera och visa resursloggar

Gå vidare till nästa kurs:

Spåra anrop