Aanmelden bij Event Hub

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 Gebeurtenissen registreren met Azure Event Hubs voor een stapsgewijze handleiding voor het configureren van een Event Hub en het API Management vastleggen van gebeurtenissen.

Notitie

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

Beleidsverklaring

<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 Standaard
logger-id De id van de logger die is geregistreerd bij uw API Management service. Ja N.v.t.
partitie-id Hiermee geeft u de index van de partitie waar berichten worden verzonden. Optioneel. Niet gebruiken als partition-key wordt gebruikt. N.v.t.
partitiesleutel Hiermee geeft u de waarde op die wordt gebruikt voor partitietoewijzing wanneer berichten worden verzonden. Optioneel. Niet gebruiken als partition-id wordt gebruikt. N.v.t.

Gebruik

Gebruiksopmerkingen

  • Het beleid wordt niet beïnvloed door Application Insights-steekproeven. Alle aanroepen van het beleid worden geregistreerd.
  • De maximale 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.

Voorbeeld

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 inkomende aanroepen vastgelegd bij de event hub Logger die is geregistreerd met 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>

Volgende stappen

Zie voor meer informatie over het werken met beleid: