Tracering

  • Artikel
  • 2 minuten om te lezen

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

  • Het beleid voegt een aangepaste tracering toe aan de uitvoer van aanvraagtracering in de testconsole wanneer tracering wordt geactiveerd. Dit betekent Ocp-Apim-Trace dat de aanvraagheader aanwezig is en is ingesteld op true en Ocp-Apim-Subscription-Key de aanvraagheader aanwezig is en een geldige sleutel bevat waarmee tracering mogelijk is.
  • Het beleid maakt een traceringstelemetrie in Application Insights wanneer Application Insights-integratie is ingeschakeld en de severity opgegeven in het beleid gelijk is aan of groter is dan de verbosity opgegeven in de diagnostische instelling.
  • Het beleid voegt een eigenschap toe aan de logboekvermelding wanneer resourcelogboeken zijn ingeschakeld en het ernstniveau dat in het beleid is opgegeven op of hoger is 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.

Waarschuwing

  • Alleen tracering toestaan voor abonnementen die zijn bedoeld voor foutopsporing. Het delen van abonnementssleutels met tracering die is toegestaan met niet-geautoriseerde gebruikers kan leiden tot onthulling van gevoelige informatie in traceringslogboeken zoals sleutels, toegangstokens, wachtwoorden, interne hostnamen en IP-adressen.
  • API Management schakelt tracering automatisch uit 1 uur nadat deze is ingeschakeld voor een abonnement.

Notitie

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

Beleidsverklaring

<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 Standaard
source Letterlijke tekenreeks die relevant is voor de traceringsviewer en waarmee de bron van het bericht wordt opgegeven. Ja N.v.t.
ernst Hiermee geeft u het ernstniveau van de tracering op. Toegestane waarden zijn verbose, information( error van laag naar hoog). No verbose

Elementen

Naam Beschrijving Vereist
message Een tekenreeks of expressie die moet worden geregistreerd. Yes
metagegevens Hiermee voegt u een aangepaste eigenschap toe aan de telemetrie van Application Insights-tracering . No

metagegevenskenmerken

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

Gebruik

Voorbeeld

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

Volgende stappen

Zie voor meer informatie over het werken met beleid: