Share via

Naslaginformatie over instellingen voor diagnostische logboeken: API Management

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

In deze naslaginformatie worden instellingen beschreven voor logboekregistratie van diagnostische API-gegevens van een API Management-exemplaar. Raadpleeg de volgende richtlijnen om logboekregistratie van API-aanvragen in te schakelen:

Notitie

Bepaalde instellingen, waar vermeld, zijn alleen van toepassing op logboekregistratie op Application Insights.

Instelling Type Description
Inschakelen boolean Hiermee geeft u op of logboekregistratie van deze API is ingeschakeld.

Logboekregistratie kan worden ingeschakeld voor alle API's of voor een afzonderlijke API. Instellingen voor een afzonderlijke API-onderdrukkingsinstellingen voor alle API's, indien ingeschakeld.
Bestemming Azure-toepassing Insights-logboekregistratie Hiermee geeft u logboekregistratie moet worden gebruikt voor Application Insights-logboekregistratie.
Steekproeven (%) decimal Waarden tussen 0 en 100 (procent).
Hiermee geeft u het percentage aanvragen op dat wordt geregistreerd. 0% steekproeven betekent dat er geen aanvragen zijn geregistreerd, terwijl 100% steekproeven alle geregistreerde aanvragen betekenen. Standaard: 100

Zie Prestatieimplicaties en logboeksampling voor prestatie-effecten van Application Insights-logboekregistratie.
Fouten in het logboek altijd vastleggen boolean Als deze instelling is ingeschakeld, worden alle fouten vastgelegd, ongeacht de instelling Sampling .
IP-adres van logboekclient boolean Als deze instelling is ingeschakeld, wordt het IP-adres van de client voor API-aanvragen geregistreerd.
Uitgebreidheid Hiermee geeft u de uitgebreidheid van de logboeken op en of aangepaste traceringen die zijn geconfigureerd in traceringsbeleid worden vastgelegd.

* Fout - mislukte aanvragen en aangepaste traceringen van ernst error
* Informatie - mislukte en geslaagde aanvragen, en aangepaste traceringen van ernst error en information
* Uitgebreid - mislukte en geslaagde aanvragen, en aangepaste traceringen van ernst error, informationen verbose

Standaard: informatie
Correlatieprotocol Hiermee geeft u het protocol op dat wordt gebruikt om telemetrie te correleren die door meerdere onderdelen naar Application Insights wordt verzonden. Standaard: verouderd

Zie Telemetriecorrelatie in Application Insights voor meer informatie.
Te registreren headers lijst Hiermee geeft u de headers op die zijn geregistreerd voor aanvragen en antwoorden. Standaard: er worden geen headers geregistreerd.
Aantal nettolading (hoofdtekst) bytes dat moet worden geregistreerd geheel getal Hiermee geeft u het aantal initiële bytes van de front-end- of back-endaanvraag of antwoordtekst op die worden geregistreerd. Maximum: 8.192. Standaardwaarde: 0
Front-endaanvraag Hiermee geeft u op of en hoe front-endaanvragen (aanvragen die binnenkomen bij de API Management-gateway) worden geregistreerd.

Als deze instelling is ingeschakeld, geeft u headers op die moeten worden geregistreerd, aantal nettoladingbytes dat moet worden geregistreerd of beide.
Front-endantwoord Hiermee geeft u op of en hoe front-endreacties (antwoorden die uitgaan van de API Management-gateway) worden geregistreerd.

Als deze instelling is ingeschakeld, geeft u headers op die moeten worden geregistreerd, aantal nettoladingbytes dat moet worden geregistreerd of beide.
Back-endaanvraag Hiermee geeft u op of en hoe back-endaanvragen (aanvragen die uitgaan van de API Management-gateway) worden geregistreerd.

Als deze instelling is ingeschakeld, geeft u headers op die moeten worden geregistreerd, aantal nettoladingbytes dat moet worden geregistreerd of beide.
Antwoord op back-end Hiermee geeft u op of en hoe back-endreacties (antwoorden die binnenkomen bij de API Management-gateway) worden geregistreerd.

Als deze instelling is ingeschakeld, geeft u headers op die moeten worden geregistreerd, aantal nettoladingbytes dat moet worden geregistreerd of beide.

Belangrijk

Indien ingeschakeld, kunnen geregistreerde nettoladingen voor aanvragen of antwoorden maximaal 8.192 bytes zijn. API Management dwingt ook een limiet van 32 kB af voor een diagnostische logboekvermelding die naar Azure Monitor wordt verzonden, waaronder de nettoladingen en andere kenmerken, zoals statuscodes, headers en tijdstempels. Als de gecombineerde grootte van de kenmerken groter is dan 32 kB, wordt de vermelding door API Management verwijderd door alle hoofdtekst en traceringsinhoud te verwijderen.

Volgende stappen

  • Zie de naslaginformatie voor de diagnostische entiteit in de API Management REST API voor meer informatie.
  • Gebruik het traceringsbeleid om aangepaste traceringen toe te voegen aan Application Insights-telemetrie, resourcelogboeken of tracering van aanvragen.