Client-gebeurtenissen verzenden naar Event Hubs
Notitie
De functie gebeurtenislistener is in preview. Het verzenden van MQTT-clientevenementen naar gebeurtenislistener wordt nog niet ondersteund.
Overzicht
Als u naar uw clientevenementen wilt luisteren zonder een openbaar toegankelijk eindpunt weer te geven, kunt u een regel voor gebeurtenislistener configureren met een Event Hub-eindpunt en een filter om op te geven welke soorten gebeurtenissen het betreft. U kunt meerdere gebeurtenislisteners tegelijk configureren. De Web PubSub-service geeft alle informatie over gebeurtenislisteners parallel wanneer er een clientevenement komt.
In deze zelfstudie leert u hoe u uw Web PubSub-service autoriseert om verbinding te maken met Event Hubs en hoe u een regel voor een gebeurtenislistener toevoegt aan uw service-instellingen.
De Web PubSub-service maakt gebruik van Microsoft Entra ID met beheerde identiteit om verbinding te maken met Event Hubs. Daarom moet u de beheerde identiteit van de service inschakelen en ervoor zorgen dat deze over de juiste machtigingen beschikt om verbinding te maken met Event Hubs. U kunt de ingebouwde azure Event Hubs-gegevenszenderrol verlenen aan de beheerde identiteit, zodat deze voldoende machtigingen heeft.
Als u een Event Hubs-listener wilt configureren, moet u het volgende doen:
- Client-gebeurtenissen verzenden naar Event Hubs
Een gebeurtenislistener configureren
Een beheerde identiteit toevoegen aan uw Web PubSub-service
Zoek uw Azure Web PubSub-service vanuit de Azure-portal. Navigeer naar Identiteit. Als u een door het systeem toegewezen identiteit wilt toevoegen, schakelt u op het tabblad Toegewezen systeem over naar Status aan. Selecteer Opslaan. Zie Beheerde identiteiten in Azure Web PubSub voor meer informatie over beheerde identiteiten.
De beheerde identiteit een Azure Event Hubs Data sender rol verlenen
Zoek uw Azure Event Hubs-resource in Azure Portal. U kunt ervoor kiezen om de rol toe te kennen op het niveau van de Event Hubs-naamruimte of het entiteitsniveau. De volgende stappen kiezen het niveau van de naamruimte.
Navigeer naar Toegangsbeheer. Selecteer Roltoewijzing toevoegen.
Selecteer de rol Azure Event Hubs-gegevenszender op het tabblad Rol . Selecteer vervolgens Volgende.
Kies op het tabblad Leden om toegang tot beheerde identiteit toe te wijzen. Selecteer Leden selecteren om uw Web PubSub-service te selecteren. Vervolgens kunt u uw roltoewijzing beoordelen en toewijzen .
Een regel voor gebeurtenislistener toevoegen aan uw service-instellingen
Zoek uw service vanuit Azure Portal. Ga naar Settings. Selecteer Vervolgens Toevoegen om uw gebeurtenislistener te configureren. Voor een bestaande hubconfiguratie selecteert u ... aan de rechterkant, gaat u naar dezelfde bewerkingspagina.
Vervolgens moet u op de onderstaande bewerkingspagina de naam van de hub configureren en toevoegen selecteren om een gebeurtenislistener toe te voegen.
Configureer eerst een Event Hub-eindpunt op de pagina Gebeurtenislistener configureren. U kunt Event Hub selecteren in uw abonnement om te selecteren of rechtstreeks de volledig gekwalificeerde naamruimte en de naam van de Event Hub invoeren. Selecteer
userensystemgebeurtenissen waarnaar u wilt luisteren. Selecteer Ten slotte Bevestigen wanneer alles klaar is.
Uw configuratie testen met live demo
Open deze Event Hubs Consumer Client-web-app en voer de Event Hubs-verbindingsreeks in om als consument verbinding te maken met een Event Hub. Als u de Event Hubs verbindingsreeks van een Event Hubs-naamruimteresource in plaats van een Event Hub-exemplaar krijgt, moet u de naam van de Event Hub opgeven. Deze Event Hub-consumentenclient is verbonden met de modus die alleen nieuwe gebeurtenissen leest; de gebeurtenissen die eerder zijn gepubliceerd, worden hier niet weergegeven. U kunt de clientverbindingsmodus voor consumenten wijzigen om alle beschikbare gebeurtenissen in de productieomgeving te lezen.
Gebruik deze WebSocket Client-web-app om clientevenementen te genereren. Als u hebt geconfigureerd dat systeemgebeurtenis
connectednaar die Event Hub wordt verzonden, moet u een afgedrukteconnectedgebeurtenis kunnen zien in de Event Hubs-consumentenclient nadat u verbinding hebt gemaakt met de Web PubSub-service. U kunt ook een gebruikersevenement genereren met de app.
Volgende stappen
In dit artikel hebt u geleerd hoe gebeurtenislisteners werken en hoe u een gebeurtenislistener configureert met een Event Hub-eindpunt. Lees de volgende specificatie voor meer informatie over de gegevensindeling die naar Event Hubs wordt verzonden.