Sdílet prostřednictvím

Azure Service Bus jako zdroj Event Gridu

  • Článek

Tento článek obsahuje vlastnosti a schéma pro události služby Service Bus. Úvod do schémat událostí najdete ve schématu událostí služby Azure Event Grid.

Poznámka:

Integrace událostí podporuje pouze obor názvů Service Bus úrovně Premium. Úrovně Basic a Standard nepodporují integraci se službou Event Grid.

Dostupné typy událostí

Service Bus generuje následující typy událostí:

Typ události Popis
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Vyvolá se při příchodu nové aktivní zprávy do fronty nebo odběru a nenaslouchají žádní příjemci.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Vyvolá se při příchodu nových aktivních zpráv do fronty nedoručených zpráv a neexistují žádné aktivní naslouchací procesy.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Vyvolání každých 30 sekund, pokud jsou ve frontě nebo odběru aktivní zprávy, i když jsou v dané konkrétní frontě nebo odběru aktivní naslouchací procesy. Vyvolá se také v případě, že počet aktivních zpráv přejde z 0 na kladnou hodnotu fronty nebo odběru.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Vyvolá se každých 30 sekund, pokud existují zprávy v entitě nedoručených zpráv fronty nebo odběru, i když existují aktivní naslouchací procesy u entity nedoručených zpráv dané fronty nebo odběru. Vyvolá se také v případě, že se počet nedoručených zpráv přepočítá z 0 na kladnou hodnotu pro entitu nedoručených zpráv fronty nebo odběru.

Příklad události

Aktivní zprávy dostupné bez naslouchacích procesů

Tato událost se generuje v případě, že ve frontě nebo odběru máte aktivní zprávy, ale žádný příjemce nenaslouchá.

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

Nedoručované zprávy dostupné bez naslouchacích procesů

Schéma události fronty nedoručených zpráv je podobné. Získáte alespoň jednu událost na frontu nedoručených zpráv, která obsahuje zprávy a žádné aktivní příjemce.

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

Aktivní dostupné pravidelné oznámení

Tato událost se generuje pravidelně, pokud máte aktivní zprávy v konkrétní frontě nebo odběru, i když pro danou konkrétní frontu nebo odběr existují aktivní naslouchací procesy.

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

Zprávy o nedoručených zprávách jsou k dispozici pravidelně

Tato událost se generuje pravidelně, pokud máte zprávy deadletter v konkrétní frontě nebo odběru, i když existují aktivní naslouchací procesy v entitě deadletter dané konkrétní fronty nebo odběru.

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

Vlastnosti události

Událost má následující data nejvyšší úrovně:

Vlastnost Type Description
topic string Úplná cesta prostředku ke zdroji událostí. Toto pole není zapisovatelné. Tuto hodnotu poskytuje Event Grid.
subject string Cesta k předmětu události, kterou definuje vydavatel.
eventType string Jeden z registrovaných typů události pro tento zdroj události.
eventTime string Čas vygenerování události na základě času UTC poskytovatele.
id string Jedinečný identifikátor události.
data objekt Data událostí úložiště objektů blob
dataVersion string Verze schématu datového objektu. Verzi schématu definuje vydavatel.
metadataVersion string Verze schématu metadat události. Schéma vlastností nejvyšší úrovně definuje Event Grid. Tuto hodnotu poskytuje Event Grid.

Datový objekt má následující vlastnosti:

Vlastnost Type Description
namespaceName string Obor názvů služby Service Bus, ve které prostředek existuje.
requestUri string Identifikátor URI pro konkrétní frontu nebo odběr vygenerující událost.
entityType string Typ entity Service Bus generující události (frontu nebo odběr).
queueName string Fronta s aktivními zprávami, pokud se přihlašuje k odběru fronty. Hodnota null, pokud používáte témata nebo odběry.
topicName string Téma předplatné služby Service Bus s aktivními zprávami patří. Hodnota null, pokud používáte frontu.
subscriptionName string Odběr služby Service Bus s aktivními zprávami. Hodnota null, pokud používáte frontu.

Kurzy a postupy

Titulek Popis
Kurz: Příklady integrace služby Azure Service Bus do služby Azure Event Grid Event Grid odesílá zprávy z tématu služby Service Bus do aplikace funkcí a aplikace logiky.
Integrace služby Azure Service Bus do Event Gridu Přehled integrace služby Service Bus s Event Gridem

Poznámka:

Když dojde k převzetí služeb při selhání pro obor názvů služby Service Bus, který je povolený geograficky dr, sekundární obor názvů negeneruje události do Event Gridu. Musíte ručně přidat odběr služby Event Grid pro sekundární obor názvů.

Další kroky