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 denverbosity
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
- Principavsnitt: inkommande, utgående, serverdel
- Principomfattningar: global, arbetsyta, produkt, API, åtgärd
- Gatewayer: klassisk, v2, förbrukning, lokalt installerad, arbetsyta
Exempel
<trace source="PetStore API" severity="verbose">
<message>@((string)context.Variables["clientConnectionID"])</message>
<metadata name="Operation Name" value="New-Order"/>
</trace>
Relaterade principer
Relaterat innehåll
Mer information om hur du arbetar med principer finns i:
- Självstudie: Transformera och skydda ditt API
- Principreferens för en fullständig lista över principinstruktioner och deras inställningar
- Principuttryck
- Ange eller redigera principer
- Återanvända principkonfigurationer
- Lagringsplats för principfragment
- Skapa principer med Microsoft Copilot i Azure