Azure Service Bus als event grid-bron

  • Artikel

Dit artikel bevat de eigenschappen en het schema voor Service Bus-gebeurtenissen. Zie het Gebeurtenisschema van Azure Event Grid voor een inleiding tot gebeurtenisschema's.

Notitie

Alleen Service Bus-naamruimte in de Premium-laag ondersteunt gebeurtenisintegratie. Basic- en Standard-lagen bieden geen ondersteuning voor integratie met Event Grid.

Beschikbare gebeurtenistypen

Service Bus verzendt de volgende gebeurtenistypen:

Gebeurtenistype Beschrijving
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Wordt gegenereerd wanneer een nieuw actief bericht binnenkomt in een wachtrij of abonnement en er geen ontvangers luisteren.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Wordt gegenereerd wanneer een nieuwe actieve berichten binnenkomt in een wachtrij met dode brieven en er geen actieve listeners zijn.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Elke 30 seconden verhoogd als er actieve berichten in een wachtrij of abonnement staan, zelfs als er actieve listeners zijn voor die specifieke wachtrij of dat abonnement. Dit wordt ook gegenereerd wanneer het aantal actieve berichten overgaat van 0 naar een positieve waarde voor de wachtrij of het abonnement.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Elke 30 seconden verhoogd als er berichten in de entiteit dead-letter van een wachtrij of abonnement staan, zelfs als er actieve listeners zijn op de entiteit dead-letter van die specifieke wachtrij of dat abonnement. Het wordt ook gegenereerd wanneer het aantal dode berichten overgaat van 0 naar een positieve waarde voor de entiteit dead-letter van de wachtrij of het abonnement.

Voorbeeld van een gebeurtenis

Actieve berichten beschikbaar zonder listeners

Deze gebeurtenis wordt gegenereerd als er actieve berichten in een wachtrij of abonnement zijn, en er geen ontvangers luisteren.

[{
  "topic": "/subscriptions/{subscription-id}/resourcegroups/{your-rg}/providers/Microsoft.ServiceBus/namespaces/{your-service-bus-namespace}",
  "subject": "topics/{your-service-bus-topic}/subscriptions/{your-service-bus-subscription}",
  "eventType": "Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://{your-service-bus-namespace}.servicebus.windows.net/{your-topic}/subscriptions/{your-service-bus-subscription}/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Onbestelbare berichten beschikbaar zonder listeners

Het schema voor een gebeurtenis in de wachtrij met dode letters is vergelijkbaar. U krijgt ten minste één gebeurtenis per wachtrij met dode letters met berichten en geen actieve ontvangers.

[{
  "topic": "/subscriptions/{subscription-id}/resourcegroups/{your-rg}/providers/Microsoft.ServiceBus/namespaces/{your-service-bus-namespace}",
  "subject": "topics/{your-service-bus-topic}/subscriptions/{your-service-bus-subscription}",
  "eventType": "Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://{your-service-bus-namespace}.servicebus.windows.net/{your-topic}/subscriptions/{your-service-bus-subscription}/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Actieve berichten beschikbaar periodieke meldingen

Deze gebeurtenis wordt periodiek gegenereerd als u actieve berichten in de specifieke wachtrij of het specifieke abonnement hebt, zelfs als er actieve listeners zijn voor die specifieke wachtrij of dat abonnement.

[{
  "topic": "/subscriptions/<subscription id>/resourcegroups/DemoGroup/providers/Microsoft.ServiceBus/namespaces/<YOUR SERVICE BUS NAMESPACE WILL SHOW HERE>",
  "subject": "topics/<service bus topic>/subscriptions/<service bus subscription>",
  "eventType": "Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://YOUR-SERVICE-BUS-NAMESPACE-WILL-SHOW-HERE.servicebus.windows.net/TOPIC-NAME/subscriptions/SUBSCRIPTIONNAME/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Berichten met onbestelbare berichten zijn periodieke meldingen beschikbaar

Deze gebeurtenis wordt periodiek gegenereerd als u deadletterberichten hebt in de specifieke wachtrij of het specifieke abonnement, zelfs als er actieve listeners zijn op de deadletter-entiteit van die specifieke wachtrij of dat abonnement.

[{
  "topic": "/subscriptions/<subscription id>/resourcegroups/DemoGroup/providers/Microsoft.ServiceBus/namespaces/<YOUR SERVICE BUS NAMESPACE WILL SHOW HERE>",
  "subject": "topics/<service bus topic>/subscriptions/<service bus subscription>",
  "eventType": "Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications",
  "eventTime": "2018-02-14T05:12:53.4133526Z",
  "id": "dede87b0-3656-419c-acaf-70c95ddc60f5",
  "data": {
    "namespaceName": "YOUR SERVICE BUS NAMESPACE WILL SHOW HERE",
    "requestUri": "https://YOUR-SERVICE-BUS-NAMESPACE-WILL-SHOW-HERE.servicebus.windows.net/TOPIC-NAME/subscriptions/SUBSCRIPTIONNAME/$deadletterqueue/messages/head",
    "entityType": "subscriber",
    "queueName": "QUEUE NAME IF QUEUE",
    "topicName": "TOPIC NAME IF TOPIC",
    "subscriptionName": "SUBSCRIPTION NAME"
  },
  "dataVersion": "1",
  "metadataVersion": "1"
}]

Eigenschappen van gebeurtenis

Een gebeurtenis bevat de volgende gegevens op het hoogste niveau:

Eigenschap Type Omschrijving
topic tekenreeks Volledig resourcepad naar de gebeurtenisbron. Dit veld kan niet worden geschreven. Event Grid biedt deze waarde.
subject tekenreeks Het door de uitgever gedefinieerde pad naar het gebeurtenisonderwerp.
eventType tekenreeks Een van de geregistreerde gebeurtenistypen voor deze gebeurtenisbron.
eventTime tekenreeks Het tijdstip waarop de gebeurtenis wordt gegenereerd op basis van de UTC-tijd van de provider.
id tekenreeks Unieke id voor de gebeurtenis.
data object Blob Storage-gebeurtenisgegevens.
dataVersion tekenreeks De schemaversie van het gegevensobject. De uitgever definieert de schemaversie.
metadataVersion tekenreeks De schemaversie van de metagegevens van de gebeurtenis. Event Grid definieert het schema voor de eigenschappen op het hoogste niveau. Event Grid biedt deze waarde.

Het gegevensobject heeft de volgende eigenschappen:

Eigenschap Type Omschrijving
namespaceName tekenreeks De Service Bus-naamruimte waarin de resource zich bevindt.
requestUri tekenreeks De URI naar de specifieke wachtrij of het specifieke abonnement dat de gebeurtenis verzendt.
entityType tekenreeks Het type Service Bus-entiteit dat gebeurtenissen verzendt (wachtrij of abonnement).
queueName tekenreeks De wachtrij met actieve berichten als u zich abonneert op een wachtrij. Waarde null als u onderwerpen/abonnementen gebruikt.
topicName tekenreeks Het onderwerp waartoe het Service Bus-abonnement met actieve berichten behoort. Waarde null als u een wachtrij gebruikt.
subscriptionName tekenreeks Het Service Bus-abonnement met actieve berichten. Waarde null als u een wachtrij gebruikt.

Zelfstudies en handleidingen

Title Beschrijving
Zelfstudie: Azure Service Bus naar Azure Event Grid-integratievoorbeelden Event Grid verzendt berichten van Service Bus-onderwerp naar functie-app en logische app.
Integratie van Azure Service Bus naar Event Grid Overzicht van de integratie van Service Bus met Event Grid.

Notitie

Wanneer een failover plaatsvindt voor een Service Bus-naamruimte waarvoor Geo-DR is ingeschakeld, verzendt de secundaire naamruimte geen gebeurtenissen naar Event Grid. U moet het Event Grid-abonnement handmatig toevoegen voor de secundaire naamruimte.

Volgende stappen