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 som anges i principen är lika med eller större än den severity som anges i diagnostikinställningenverbosity.
  • 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!

  • API Management stöder inte längre prenumerationer för spårning eller Ocp-Apim-Trace-huvudet .
  • För att förbättra API-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
källa 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

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

metadataattribut

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

Förbrukning

Exempel

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

Relaterat innehåll

Mer information om hur du arbetar med principer finns i: