Gebeurtenissen voor het Azure Event Hubs in Azure API Management

Azure Event Hubs is een zeer schaalbare service voor inkomende gegevens die miljoenen gebeurtenissen per seconde kan opnemen, voor verwerking en analyse van de enorme hoeveelheden gegevens die worden geproduceerd door verbonden apparaten en toepassingen. Event Hubs fungeert als de 'front door' voor een gebeurtenispijplijn en zodra gegevens zijn verzameld in een Event Hub, kunnen deze worden getransformeerd en opgeslagen met behulp van een realtime analyseprovider of batch-/opslagadapters. Event Hubs koppelt de productie van een gebeurtenissenstroom los van het gebruik van deze gebeurtenissen, zodat de consumenten ervan toegang hebben tot de gebeurtenissen op basis van hun eigen planning.

In dit artikel wordt beschreven hoe u gebeurtenissen API Management met behulp van Azure Event Hubs.

Een Azure Event Hub maken

Zie Create an Event Hubs namespace and an event hub using the Azure Portal (Een Event Hubs-naamruimte en een Event Hub maken met behulp van de Azure Portal) voor gedetailleerde stappen voor het maken van een Event Hub en het ontvangen van verbindingsreeksen die u nodig hebt om gebeurtenissen te verzenden en te ontvangen van en naar de Event Hub.

Notitie

De Event Hub-resource kan zich in een ander abonnement of zelfs een andere tenant dan de API Management resource

Een API Management maken

Nu u een Event Hub hebt, bestaat de volgende stap uit het configureren van een logboekregistratie in uw API Management-service, zodat gebeurtenissen kunnen worden gelogd bij de Event Hub.

API Management zijn geconfigureerd met behulp van de API Management REST API. Zie Loggers maken voor gedetailleerde voorbeelden van aanvragen.

Log-to-eventhub-beleid configureren

Zodra uw logboekregistratie is geconfigureerd in API Management, kunt u het beleid log-to-eventhub configureren om de gewenste gebeurtenissen te loggen. Het beleid log-to-eventhub kan worden gebruikt in de sectie voor het binnenkomende beleid of in de sectie uitgaand beleid.

  1. Blader naar de APIM-instantie.
  2. Selecteer het tabblad API.
  3. Selecteer de API waaraan u het beleid wilt toevoegen. In dit voorbeeld voegen we een beleid toe aan de Echo-API in het product Onbeperkt .
  4. Selecteer Alle bewerkingen.
  5. Selecteer bovenaan het scherm het tabblad Ontwerpen.
  6. Klik in het venster Binnenkomende of uitgaande verwerking op het driehoekje (naast het potlood).
  7. Selecteer de Code-editor. Zie How to set or edit policies (Beleid instellen of bewerken) voor meer informatie.
  8. Plaats de cursor in de sectie inbound of outbound het beleid.
  9. Selecteer in het venster aan de rechterkant Geavanceerde beleidsregelsLogennaar EventHub. Hiermee voegt u de beleidsoverzichtsjabloon log-to-eventhub in.
<log-to-eventhub logger-id="logger-id">
    @{
        return new JObject(
            new JProperty("EventTime", DateTime.UtcNow.ToString()),
            new JProperty("ServiceName", context.Deployment.ServiceName),
            new JProperty("RequestId", context.RequestId),
            new JProperty("RequestIp", context.Request.IpAddress),
            new JProperty("OperationName", context.Operation.Name)
        ).ToString();
    }
</log-to-eventhub>

Vervang logger-id door de waarde die u hebt gebruikt {loggerId} voor in de aanvraag-URL voor het maken van de logboeken in de vorige stap.

U kunt elke expressie gebruiken die een tekenreeks retourneert als de waarde voor het log-to-eventhub element . In dit voorbeeld wordt een tekenreeks in JSON-indeling vastgelegd met de datum en tijd, de servicenaam, de aanvraag-id, het AANVRAAG-IP-adres en de bewerkingsnaam.

Klik op Opslaan om de bijgewerkte beleidsconfiguratie op te slaan. Zodra het beleid is opgeslagen, is het actief en worden gebeurtenissen geregistreerd bij de aangewezen Event Hub.

Notitie

De maximale ondersteunde berichtgrootte die vanuit dit beleid naar een Event Hub API Management wordt verzonden, is 200 kilobytes (KB). Als een bericht dat naar een Event Hub wordt verzonden groter is dan 200 KB, wordt het automatisch afgekapt en wordt het afgekapte bericht overgedragen naar Event Hubs.

Bekijk een voorbeeld van de Event Hubs met behulp van Azure Stream Analytics

U kunt een voorbeeld van het logboek in Event Hubs met behulp van Azure Stream Analytics query's.

  1. Blader in Azure Portal naar de Event Hub waar de logger gebeurtenissen naar verzendt.
  2. Selecteer onder Functies het tabblad Gegevens verwerken.
  3. Selecteer op de kaart Realtime-inzichten van gebeurtenissen inschakelen de optie Verkennen.
  4. U moet een voorbeeld van het logboek kunnen bekijken op het tabblad Voorbeeld van invoer. Als de weergegeven gegevens niet actueel zijn, selecteert u Vernieuwen om de meest recente gebeurtenissen weer te geven.

Volgende stappen