Azure Service Bus som en Event Grid-källa

  • Artikel

Den här artikeln innehåller egenskaper och schema för Service Bus-händelser. En introduktion till händelsescheman finns i Händelseschema för Azure Event Grid.

Kommentar

Endast Service Bus-namnområdet på Premium-nivå stöder händelseintegrering. Nivåerna Basic och Standard stöder inte integrering med Event Grid.

Tillgängliga händelsetyper

Service Bus genererar följande händelsetyper:

Händelsetyp beskrivning
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Utlöses när ett nytt aktivt meddelande tas emot i en kö eller prenumeration och det inte finns några mottagare som lyssnar.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Upphöjt när nya aktiva meddelanden tas emot i en kö med obeställbara meddelanden och det inte finns några aktiva lyssnare.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Upphöjt var 30:e sekund om det finns aktiva meddelanden i en kö eller prenumeration, även om det finns aktiva lyssnare i den specifika kön eller prenumerationen. Det utlöses också när antalet aktiva meddelanden övergår från 0 till ett positivt värde för kön eller prenumerationen.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Upphöjt var 30:e sekund om det finns meddelanden i en entitet med obeställbara meddelanden i en kö eller prenumeration, även om det finns aktiva lyssnare i entiteten med obeställbara meddelanden i den specifika kön eller prenumerationen. Det genereras också när antalet meddelanden med obeställbara meddelanden övergår från 0 till ett positivt värde för entiteten med obeställbara bokstäver i kön eller prenumerationen.

Exempelhändelse

Aktiva meddelanden tillgängliga utan lyssnare

Den här händelsen genereras om det finns aktiva meddelanden i en kö eller prenumeration och inga mottagare lyssnar.

[{
  "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"
}]

Meddelanden med obeställbara meddelanden tillgängliga utan lyssnare

Schemat för en köhändelse med obeställbara meddelanden liknar det. Du får minst en händelse per kö med obeställbara meddelanden och inga aktiva mottagare.

[{
  "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"
}]

Aktiva meddelanden tillgängliga periodiska meddelanden

Den här händelsen genereras regelbundet om du har aktiva meddelanden i den specifika kön eller prenumerationen, även om det finns aktiva lyssnare för den specifika kön eller prenumerationen.

[{
  "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"
}]

Meddelanden med obeställbara meddelanden tillgängliga periodiska meddelanden

Den här händelsen genereras regelbundet om du har deadletter-meddelanden i den specifika kön eller prenumerationen, även om det finns aktiva lyssnare på deadletter-entiteten för den specifika kön eller prenumerationen.

[{
  "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"
}]

Händelseegenskaper

En händelse har följande data på den översta nivån:

Property Type Description
topic sträng Fullständig resurssökväg till händelsekällan. Det här fältet kan inte skrivas. Event Grid ger det här värdet.
subject sträng Utgivardefinierad sökväg till händelseobjektet.
eventType sträng En av de registrerade händelsetyperna för den här händelsekällan.
eventTime sträng Den tid då händelsen genereras baserat på leverantörens UTC-tid.
id sträng Unik identifierare för händelsen.
data objekt Händelsedata för Blob Storage.
dataVersion sträng Dataobjektets schemaversion. Utgivaren definierar schemaversion.
metadataVersion sträng Schemaversionen av händelsens metadata. Event Grid definierar schemat för de översta egenskaperna. Event Grid ger det här värdet.

Dataobjektet har följande egenskaper:

Property Type Description
namespaceName sträng Service Bus-namnområdet som resursen finns i.
requestUri sträng URI:n till den specifika kön eller prenumerationen som genererar händelsen.
entityType sträng Typen av Service Bus-entitet som genererar händelser (kö eller prenumeration).
queueName sträng Kön med aktiva meddelanden om du prenumererar på en kö. Värde null om du använder ämnen/prenumerationer.
topicName sträng Ämnet som Service Bus-prenumerationen med aktiva meddelanden tillhör. Värde null om du använder en kö.
subscriptionName sträng Service Bus-prenumerationen med aktiva meddelanden. Värde null om du använder en kö.

Självstudier och instruktioner

Title Description
Självstudie: Integreringsexempel för Azure Service Bus till Azure Event Grid Event Grid skickar meddelanden från Service Bus-ämnet till funktionsappen och logikappen.
Azure Service Bus till Event Grid-integrering Översikt över integrering av Service Bus med Event Grid.

Kommentar

När en redundansväxling sker för ett Service Bus-namnområde som är Geo-DR aktiverat genererar inte det sekundära namnområdet händelser till Event Grid. Du måste lägga till Event Grid-prenumerationen manuellt för det sekundära namnområdet.

Nästa steg