Bejelentkezés az eseményközpontba
A KÖVETKEZŐRE VONATKOZIK: Minden API Management-szint
A log-to-eventhub
szabályzat a megadott formátumban küld üzeneteket egy Logger-entitás által meghatározott eseményközpontnak. Ahogy a neve is mutatja, a szabályzat a kiválasztott kérés- vagy válaszkörnyezeti információk online vagy offline elemzéshez való mentésére szolgál.
Feljegyzés
Az eseményközpontok konfigurálásáról és a naplózási eseményekről részletes útmutatót az API Management-események naplózása az Azure Event Hubs használatával című témakörben talál.
Feljegyzés
Állítsa be a szabályzat elemeit és gyermekelemeit a szabályzatutasításban megadott sorrendben. További információ az API Management-szabályzatok beállításáról és szerkesztéséről.
Szabályzatutasítás
<log-to-eventhub logger-id="id of the logger entity" partition-id="index of the partition where messages are sent" partition-key="value used for partition assignment">
Expression returning a string to be logged
</log-to-eventhub>
Attribútumok
Attribútum | Leírás | Kötelező | Alapértelmezett |
---|---|---|---|
logger-id | Az API Management szolgáltatásban regisztrált naplózó azonosítója. A szabályzatkifejezések nem engedélyezettek. | Igen | n/a |
partícióazonosító | Annak a partíciónak az indexét adja meg, amelyben az üzeneteket küldik. A szabályzatkifejezések nem engedélyezettek. | Opcionális. Használat esetén partition-key ne használja. |
n/a |
partíciókulcs | Megadja a partíció-hozzárendeléshez használt értéket az üzenetek küldésekor. A szabályzatkifejezések engedélyezettek. | Opcionális. Használat esetén partition-id ne használja. |
n/a |
Használat
- Szabályzatszakaszok: bejövő, kimenő, háttérrendszer, hiba
- Szabályzat hatókörei: globális, termék, API, művelet
- Átjárók: klasszikus, v2, használat, saját üzemeltetésű
Használati megjegyzések
- Az Application Insights mintavételezése nem befolyásolja a szabályzatot. A rendszer naplózza a szabályzat összes meghívását.
- A házirendből egy eseményközpontba küldhető maximális támogatott üzenetméret 200 kilobájt (KB). A nagyobb üzeneteket a rendszer automatikusan 200 KB-ra csonkolja, mielőtt átkerül egy eseményközpontba.
Példa
Bármely sztring használható az Event Hubsban naplózandó értékként. Ebben a példában a rendszer az összes bejövő hívás dátumát és idejét, üzembehelyezési szolgáltatásnevét, kérésazonosítóját, IP-címét és műveletnevét naplózza az contoso-logger
azonosítóval regisztrált eseményközpont-naplózóba.
<policies>
<inbound>
<log-to-eventhub logger-id ='contoso-logger'>
@( string.Join(",", DateTime.UtcNow, context.Deployment.ServiceName, context.RequestId, context.Request.IpAddress, context.Operation.Name) )
</log-to-eventhub>
</inbound>
<outbound>
</outbound>
</policies>
Kapcsolódó szabályzatok
Kapcsolódó tartalom
A szabályzatok használatával kapcsolatos további információkért lásd:
- Oktatóanyag: AZ API átalakítása és védelme
- Szabályzathivatkozás a szabályzatutasságok és azok beállításainak teljes listájához
- Házirend-kifejezések
- Házirendek beállítása vagy szerkesztése
- Szabályzatkonfigurációk újrafelhasználása
- Szabályzatrészletek adattára
- Azure API Management policy toolkit
- Szabályzatok létrehozása a Microsoft Copilot használatával az Azure-ban