Referens för inställningar för diagnostikloggar: API Management

  • Artikel

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

Den här referensen beskriver inställningar för API-diagnostikloggning från en API Management-instans. Information om hur du aktiverar loggning av API-begäranden finns i följande vägledning:

Kommentar

Vissa inställningar, där detta anges, gäller endast för loggning till Application Insights.

Inställning Typ Beskrivning
Aktivera boolean Anger om loggning av det här API:et är aktiverat.

Loggning kan aktiveras för alla API:er eller för ett enskilt API. Inställningar för enskilda API-åsidosättningsinställningar för alla API:er, om det är aktiverat.
Mål Azure Application Insights-loggare Anger loggning som ska användas för Application Insights-loggning.
Sampling (%) decimal Värden från 0 till 100 (procent).
Anger procentandelen begäranden som loggas. 0 % sampling innebär att inga begäranden loggas, medan 100 % sampling innebär att alla begäranden loggas. Standard: 100

Prestandaeffekter av Application Insights-loggning finns i Prestandakonsekvenser och loggsampling.
Logga alltid fel boolean Om den här inställningen är aktiverad loggas alla fel, oavsett inställningen Sampling .
Logga klientens IP-adress boolean Om den här inställningen är aktiverad loggas klientens IP-adress för API-begäranden.
Utförlighet Anger utförligheten i loggarna och om anpassade spårningar som har konfigurerats i spårningsprinciper loggas.

* Fel – misslyckade begäranden och anpassade spårningar av allvarlighetsgrad error
* Information – misslyckade och lyckade begäranden och anpassade spårningar av allvarlighetsgrad error och information
* Utförlig – misslyckade och lyckade begäranden och anpassade spårningar av allvarlighetsgrad error, informationoch verbose

Standard: Information
Korrelationsprotokoll Anger det protokoll som används för att korrelera telemetri som skickas av flera komponenter till Application Insights. Standard: Äldre

Mer information finns i Telemetrikorrelation i Application Insights.
Rubriker att logga lista Anger de huvuden som loggas för begäranden och svar. Standard: inga rubriker loggas.
Antal nyttolastbyte (brödtext) som ska loggas integer Anger antalet inledande byte för klientdelen eller serverdelens begäran eller svarstext som loggas. Max: 8 192. Standard: 0
Klientdelsbegäran Anger om och hur klientdelsbegäranden (begäranden som inkommande till API Management-gatewayen) loggas.

Om den här inställningen är aktiverad anger du Rubriker att logga, Antal nyttolastbyte som ska loggas eller båda.
Klientdelssvar Anger om och hur klientdelssvar (svar som utgåendes från API Management-gatewayen) loggas.

Om den här inställningen är aktiverad anger du Rubriker att logga, Antal nyttolastbyte som ska loggas eller båda.
Serverdelsbegäran Anger om och hur serverdelsbegäranden (begäranden som utgående från API Management-gatewayen) loggas.

Om den här inställningen är aktiverad anger du Rubriker att logga, Antal nyttolastbyte som ska loggas eller båda.
Serverdelssvar Anger om och hur serverdelssvar (svar som inkommande till API Management-gatewayen) loggas.

Om den här inställningen är aktiverad anger du Rubriker att logga, Antal nyttolastbyte som ska loggas eller båda.

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