Aanmelden bij Event Hub

  • Artikel

VAN TOEPASSING OP: Alle API Management-lagen

Het log-to-eventhub beleid verzendt berichten in de opgegeven indeling naar een Event Hub die is gedefinieerd door een Logger-entiteit . Zoals de naam al aangeeft, wordt het beleid gebruikt voor het opslaan van geselecteerde aanvraag- of antwoordcontextinformatie voor online- of offlineanalyse.

Notitie

Zie API Management-gebeurtenissen registreren met Azure Event Hubs voor stapsgewijze instructies voor het configureren van een Event Hub en logboekregistratiegebeurtenissen.

Notitie

Stel de elementen en onderliggende elementen van het beleid in de volgorde in die in de beleidsverklaring is opgegeven. Meer informatie over het instellen of bewerken van API Management-beleid.

Beleidsinstructie

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

Kenmerken

Kenmerk Beschrijving Vereist Standaardinstelling
logger-id De id van de logger die is geregistreerd bij uw API Management-service. Beleidsexpressies zijn niet toegestaan. Ja N.v.t.
partitie-id Hiermee geeft u de index van de partitie waarin berichten worden verzonden. Beleidsexpressies zijn niet toegestaan. Optioneel. Gebruik niet als partition-key deze wordt gebruikt. N.v.t.
partitiesleutel Hiermee geeft u de waarde die wordt gebruikt voor partitietoewijzing wanneer berichten worden verzonden. Beleidsexpressies zijn toegestaan. Optioneel. Gebruik niet als partition-id deze wordt gebruikt. N.v.t.

Gebruik

Gebruiksnotities

  • Het beleid wordt niet beïnvloed door Application Insights-steekproeven. Alle aanroepen van het beleid worden geregistreerd.
  • De maximaal ondersteunde berichtgrootte die vanuit dit beleid naar een Event Hub kan worden verzonden, is 200 kilobytes (KB). Een groter bericht wordt automatisch afgekapt tot 200 kB voordat deze wordt overgedragen naar een Event Hub.

Opmerking

Elke tekenreeks kan worden gebruikt als de waarde die moet worden vastgelegd in Event Hubs. In dit voorbeeld worden de datum en tijd, de naam van de implementatieservice, de aanvraag-id, het IP-adres en de naam van de bewerking voor alle binnenkomende aanroepen vastgelegd in de Event Hub Logger die is geregistreerd bij de contoso-logger id.

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

Gerelateerde inhoud

Zie voor meer informatie over het werken met beleid: