Olvasás angol nyelven

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

Bejelentkezés az eseményközpontba

  • Cikk

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.

Megjegyzé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.

Megjegyzé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

XML 
<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

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.

XML 
<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ó tartalom

A szabályzatok használatával kapcsolatos további információkért lásd: