Delen via

Trace

  • Artikel

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 ondersteunt geen abonnementen meer voor tracering of de Ocp-Apim-Trace-header .
  • Om de API-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

Opmerking

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

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: