Trace

VAN TOEPASSING OP: Alle API Management-lagen

Het trace beleid voegt een aangepaste tracering toe aan de uitvoer van de aanvraagtracering in de testconsole, Application Insights-telemetrieën en/of resourcelogboeken.

• Het beleid voegt een aangepaste tracering toe aan de uitvoer van de aanvraagtracering in de testconsole wanneer tracering wordt geactiveerd.
• Het beleid maakt een traceringstelemetrie in Application Insights wanneer Application Insights-integratie is ingeschakeld en het severity opgegeven in het beleid gelijk is aan of groter is dan de verbosity opgegeven in de diagnostische instelling.
• Met het beleid wordt een eigenschap toegevoegd aan de logboekvermelding wanneer resourcelogboeken zijn ingeschakeld en het ernstniveau dat is opgegeven in het beleid, zich op of hoger bevindt dan het uitgebreidheidsniveau dat is opgegeven in de diagnostische instelling.
• Het beleid wordt niet beïnvloed door Application Insights-steekproeven. Alle aanroepen van het beleid worden geregistreerd.

Belangrijk

• Api Management-aanvraagtracering met behulp van de Ocp-Apim-Trace-header in een aanvraag en het gebruik van de waarde van de antwoordheader Ocp-Apim-Trace-Location wordt afgeschaft.
• Om de beveiliging te verbeteren, kan tracering nu worden ingeschakeld op het niveau van een afzonderlijke API door een tijdsgebonden token te verkrijgen met behulp van de API Management REST API en het token door te geven in een aanvraag aan de gateway. Zie Tracering van een API inschakelen voor meer informatie.
• Zorg ervoor dat bij het inschakelen van tracering gevoelige informatie wordt weergegeven in de traceringsgegevens. Zorg ervoor dat u over de juiste beveiligingsmaatregelen beschikt om de traceringsgegevens te beveiligen.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

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

Kenmerken

Kenmerk	Beschrijving	Vereist	Standaardinstelling
source	Letterlijke tekenreeks die zinvol is voor de traceringsviewer en het opgeven van de bron van het bericht. Beleidsexpressies zijn niet toegestaan.	Ja	N.v.t.
ernst	Hiermee geeft u het ernstniveau van de tracering. Toegestane waarden zijn verbose, error information(van laag naar hoog). Beleidsexpressies zijn niet toegestaan.	Nee	verbose

Elementen

Name	Beschrijving	Vereist
bericht	Een tekenreeks of expressie die moet worden geregistreerd. Beleidsexpressies zijn toegestaan.	Ja
metagegevens	Voegt een aangepaste eigenschap toe aan de Application Insights Trace-telemetrie .	Nee

metagegevenskenmerken

Kenmerk	Beschrijving	Vereist	Standaardinstelling
naam	Naam van de eigenschap.	Ja	N.v.t.
waarde	Waarde van de eigenschap.	Ja	N.v.t.

Gebruik

• Beleidssecties: binnenkomend, uitgaand, back-end
• Beleidsbereik: globaal, werkruimte, product, API, bewerking
• Gateways: klassiek, v2, verbruik, zelf-hostend

Opmerking

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

Gerelateerd beleid

• Logboekregistratie

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid:

• Zelfstudie: Uw API transformeren en beveiligen
• Beleidsreferentie voor een volledige lijst met beleidsinstructies en hun instellingen
• Beleidsexpressies
• Beleid instellen of bewerken
• Beleidsconfiguraties opnieuw gebruiken
• Beleidsfragmentenopslagplaats
• Beleid ontwerpen met Behulp van Microsoft Copilot in Azure