Megosztás a következőn keresztül:

Diagnosztikai naplók beállításainak referencia: API Management

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint

Ez a hivatkozás az API Management-példányból történő API-diagnosztikai naplózás beállításait ismerteti. Az API-kérések naplózásának engedélyezéséhez tekintse meg az alábbi útmutatást:

Feljegyzés

Bizonyos beállítások, ahol fel vannak jegyezve, csak az Application Insightsba való naplózásra vonatkoznak.

Beállítás Típus Leírás
Engedélyezés Logikai Megadja, hogy engedélyezve van-e az API naplózása.

A naplózás az összes API-hoz vagy egy adott API-hoz engedélyezhető. Ha engedélyezve van, az egyes API-k felülbírálási beállításai.
Cél Azure-alkalmazás Insights-naplózó Az Application Insights naplózásához használandó naplózót adja meg.
Mintavételezés (%) tizedes Értékek 0 és 100 között (százalék).
A naplózott kérések százalékos arányát adja meg. A 0%-os mintavételezés nulla naplózott kérést jelent, míg a 100%-os mintavételezés az összes naplózott kérést jelenti. Alapértelmezett: 100

Az Application Insights naplózásának teljesítménybeli hatásaiért lásd a teljesítményre gyakorolt hatásokat és a naplómintavételt.
Mindig naplóhibák Logikai Ha ez a beállítás engedélyezve van, a rendszer a mintavételezési beállítástól függetlenül minden hibát naplóz.
Naplóügyfél IP-címe Logikai Ha ez a beállítás engedélyezve van, a rendszer naplózza az API-kérések ügyfél IP-címét.
Részletesség Megadja a naplók részletességét, valamint azt, hogy a nyomkövetési szabályzatokban konfigurált egyéni nyomkövetések naplózva legyenek-e.

* Hiba – sikertelen kérések és egyéni súlyossági nyomkövetések error
* Információ – sikertelen és sikeres kérések, valamint egyéni súlyossági error és information
* Részletes - sikertelen és sikeres kérések, valamint a súlyosság erroregyéni nyomkövetései, informationés verbose

Alapértelmezett: Információ
Korrelációs protokoll Megadja a több összetevő által az Application Insightsnak küldött telemetriai adatok korrelálásához használt protokollt. Alapértelmezett: Örökölt

További információ: Telemetriai korreláció az Application Insightsban.
Naplózandó fejlécek list Megadja a kérések és válaszok naplózott fejléceit. Alapértelmezett: a rendszer nem naplózza a fejléceket.
Naplózandó hasznos adat (törzs) bájtjainak száma egész szám Megadja a naplózott előtér- vagy háttéralkalmazás vagy válasz törzs kezdeti bájtjainak számát. Maximum: 8192. Alapértelmezett: 0
Előtér-kérelem Meghatározza, hogy a rendszer naplózza-e az előtérbeli kéréseket (az API Management-átjáróhoz beérkező kéréseket).

Ha ez a beállítás engedélyezve van, adja meg a naplózni kívánt fejléceket, a naplózandó hasznos adat bájtjainak számát vagy mindkettőt.
Előtérbeli válasz Meghatározza, hogy a rendszer naplózza-e az előtérbeli válaszokat (az API Management-átjáróból kimenő válaszokat).

Ha ez a beállítás engedélyezve van, adja meg a naplózni kívánt fejléceket, a naplózandó hasznos adat bájtjainak számát vagy mindkettőt.
Háttérkérelem Megadja, hogy a háttérbeli kérések (az API Management-átjáróról kimenő kérések) naplózva legyenek-e és hogyan.

Ha ez a beállítás engedélyezve van, adja meg a naplózni kívánt fejléceket, a naplózandó hasznos adat bájtjainak számát vagy mindkettőt.
Háttérválasz Megadja, hogy a háttérbeli válaszok (az API Management-átjáróra érkező válaszok) naplózva legyenek-e.

Ha ez a beállítás engedélyezve van, adja meg a naplózni kívánt fejléceket, a naplózandó hasznos adat bájtjainak számát vagy mindkettőt.

Fontos

Ha engedélyezve van, a naplózott kérések vagy válaszok hasznos adatai legfeljebb 8192 bájtot tartalmazhatnak. Az API Management 32 KB-os korlátot is kényszerít az Azure Monitornak küldött diagnosztikai naplóbejegyzésre, amely tartalmazza a hasznos adatokat és egyéb attribútumokat, például az állapotkódokat, fejléceket és időbélyegeket. Ha az attribútumok együttes mérete meghaladja a 32 KB-ot, az API Management az összes törzs- és nyomkövetési tartalom eltávolításával levágja a bejegyzést.

Következő lépések

  • További információt az API Management REST API diagnosztikai entitásának referenciájában talál.
  • A nyomkövetési szabályzattal egyéni nyomkövetéseket adhat hozzá az Application Insights telemetriai adataihoz, erőforrásnaplóihoz vagy kéréskövetéséhez.