Dela via


Spårning

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

Principen trace lägger till en anpassad spårning i begärandespårningsutdata i testkonsolen, Application Insights-telemetrier och/eller resursloggar.

  • Principen lägger till en anpassad spårning i begärandespårningsutdata i testkonsolen när spårning utlöses.
  • Principen skapar en spårningstelemetri i Application Insights, när Application Insights-integrering är aktiverad och den severity som anges i principen är lika med eller större än den verbosity som anges i diagnostikinställningen.
  • Principen lägger till en egenskap i loggposten när resursloggar är aktiverade och allvarlighetsgraden som anges i principen är på eller högre än den verbositetsnivå som anges i diagnostikinställningen.
  • Principen påverkas inte av Application Insights-sampling. Alla anrop av principen loggas.

Viktigt!

  • Spårning av API Management-begäranden med hjälp av Ocp-Apim-Trace-huvudet i en begäran och med hjälp av värdet för svarshuvudet Ocp-Apim-Trace-Location är inaktuellt.
  • För att förbättra säkerheten kan spårning nu aktiveras på nivån för ett enskilt API genom att hämta en tidsbegränsad token med API Management REST API och skicka token i en begäran till gatewayen. Mer information finns i Aktivera spårning av ett API.
  • Var försiktig när du aktiverar spårning, eftersom den kan exponera känslig information i spårningsdata. Se till att du har lämpliga säkerhetsåtgärder för att skydda spårningsdata.

Kommentar

Ange principens element och underordnade element i den ordning som anges i principbeskrivningen. Läs mer om hur du anger eller redigerar API Management-principer.

Principuttryck

<trace source="arbitrary string literal" severity="verbose | information | error">
    <message>String literal or expressions</message>
    <metadata name="string literal or expressions" value="string literal or expressions"/>
</trace>

Attribut

Attribut beskrivning Obligatoriskt Standardvärde
source Strängliteral meningsfull för spårningsvisaren och ange källan till meddelandet. Principuttryck tillåts inte. Ja Ej tillämpligt
allvarlighetsgrad Anger allvarlighetsgraden för spårningen. Tillåtna värden är verbose, information, error (från lägsta till högsta). Principuttryck tillåts inte. Nej verbose

Element

Name beskrivning Obligatoriskt
meddelande En sträng eller ett uttryck som ska loggas. Principuttryck tillåts. Ja
metadata Lägger till en anpassad egenskap i telemetrin Application Insights Trace . Nej

metadataattribut

Attribut beskrivning Obligatoriskt Standardvärde
name Namnet på egenskapen. Ja Ej tillämpligt
värde Egenskapens värde. Ja Ej tillämpligt

Användning

Exempel

<trace source="PetStore API" severity="verbose">
    <message>@((string)context.Variables["clientConnectionID"])</message>
    <metadata name="Operation Name" value="New-Order"/>
</trace>

Mer information om hur du arbetar med principer finns i: