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

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:

• Erőforrásnaplók gyűjtése
• Az Azure API Management integrálása Azure-alkalmazás Elemzések

Feljegyzés

Bizonyos beállítások, ahol fel vannak jegyezve, csak az Application Elemzések naplózására 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ő. Gépház az egyes API-k felülbírálási beállításaihoz, ha engedélyezve van.
Cél	Azure-alkalmazás Elemzések naplózó	Az alkalmazás Elemzések 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 alkalmazás Elemzések 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		Meghatározza a több összetevő által az Application Elemzések felé küldött telemetriai adatok korrelációjának protokollt. Alapértelmezett: Örökölt További információt az Application Elemzések telemetriai korrelációjában talál.
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 alkalmazáshoz Elemzések telemetriai adatokhoz, erőforrásnaplókhoz vagy kérések nyomkövetéséhez.