Trace

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 verbosity diagnosztikai 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-kérések nyomkövetése az Ocp-Apim-Trace fejléc használatával egy kérelemben és az Ocp-Apim-Trace-Location válaszfejléc értékének használatával elavult.
• A biztonság javítása érdekében a nyomkövetés mostantól engedélyezhető az egyes API-k szintjén egy korlátozott idejű jogkivonat beszerzésével az API Management REST API használatával, és a jogkivonat átadásával 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, mivel 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
forrá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
metaadatok	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

• Szabályzatszakaszok: bejövő, kimenő, háttérrendszer
• Szabályzathatókörök: globális, munkaterület, termék, API, művelet
• Átjárók: klasszikus, v2, használat, saját üzemeltetésű

Példa

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

Kapcsolódó szabályzatok

• Logging

Kapcsolódó tartalom

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

• Oktatóanyag: AZ API átalakítása és védelme
• Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
• Házirend-kifejezések
• Házirendek beállítása vagy szerkesztése
• Szabályzatkonfigurációk újrafelhasználása
• Szabályzatrészletek adattára
• Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban