Nyom

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

A trace szabályzat egyéni nyomkövetést ad hozzá a kérelemkövetési kimenethez a tesztkonzolon, az Application Insights telemetriáiban és/vagy erőforrásnaplóiban.

  • A szabályzat a nyomkövetés aktiválásakor egyéni nyomkövetést ad hozzá a tesztkonzol kéréskövetési kimenetéhez.
  • A szabályzat nyomkövetési telemetriát hoz létre az Application Insightsban, ha engedélyezve van az Application Insights-integráció, és a severity szabályzatban megadott érték egyenlő vagy nagyobb, mint a verbositydiagnosztikai beállításban megadott.
  • A szabályzat hozzáad egy tulajdonságot a naplóbejegyzéshez, ha az erőforrásnaplók engedélyezve vannak, és a szabályzatban megadott súlyossági szint a diagnosztikai beállításban megadott részletességi szintnél vagy annál magasabb.
  • Az Application Insights mintavételezése nem befolyásolja a szabályzatot. A rendszer naplózza a szabályzat összes meghívását.

Fontos

  • Az API Management már nem támogatja a nyomkövetési előfizetéseket vagy az Ocp-Apim-Trace fejlécet.
  • Az API biztonságának javítása érdekében a nyomkövetés mostantól engedélyezhető az egyes API-k szintjén. Az API Management REST API használatával szerezze be az időkorlátos jogkivonatot, és adja át a jogkivonatot egy kérésben az átjárónak. További információ: API nyomkövetésének engedélyezése.
  • Ügyeljen a nyomkövetés engedélyezésére. Bizalmas információkat tehet közzé a nyomkövetési adatokban. Győződjön meg arról, hogy rendelkezik a nyomkövetési adatok védelméhez szükséges biztonsági intézkedésekkel.

Feljegyzés

Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.

Szabályzatutasítás

<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>

Attribútumok

Attribútum Leírás Kötelező Alapértelmezett
adatforrás A nyomkövetési megjelenítő számára értelmezhető sztringkonstans, amely megadja az üzenet forrását. A szabályzatkifejezések nem engedélyezettek. Igen n/a
súlyosság A nyomkövetés súlyossági szintjét adja meg. Az engedélyezett értékek a verbosekövetkezők: , informationerror (a legalacsonyabbtól a legmagasabbig). A szabályzatkifejezések nem engedélyezettek. Nem verbose

Elemek

Név Leírás Kötelező
üzenet Naplózandó sztring vagy kifejezés. A szabályzatkifejezések engedélyezettek. Igen
metaadat Egyéni tulajdonságot ad hozzá az Application Insights Trace telemetriához. Nem

metaadat-attribútumok

Attribútum Leírás Kötelező Alapértelmezett
név A tulajdonság neve. Igen n/a
Érték A tulajdonság értéke. Igen n/a

Használat

Példa

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

Kapcsolódó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd:

  • Last updated on