Share via

Az Azure Service Bus mint Event Grid-forrás

  • Cikk

Ez a cikk a Service Bus-események tulajdonságait és sémáját ismerteti. Az eseménysémákról az Azure Event Grid eseményséma című témakörben olvashat.

Feljegyzés

Csak a prémium szintű Service Bus-névtér támogatja az eseményintegrációt. Az alapszintű és a standard szintek nem támogatják az Event Grid-integrációt.

Elérhető eseménytípusok

A Service Bus a következő eseménytípusokat bocsátja ki:

Eseménytípus Leírás
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Amikor egy új aktív üzenet érkezik egy üzenetsorba vagy előfizetésbe, és nincsenek fogadók figyelve.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Akkor merül fel, amikor egy új aktív üzenet érkezik egy kézbesítetlen levelek üzenetsorába, és nincsenek aktív figyelők.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications 30 másodpercenként érkezik, ha aktív üzenetek vannak egy üzenetsorban vagy előfizetésben, még akkor is, ha aktív figyelők vannak az adott üzenetsoron vagy előfizetésen. Akkor is felmerül, ha az aktív üzenetszám 0-ról pozitív értékre vált az üzenetsor vagy az előfizetés számára.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications 30 másodpercenként érkezik, ha egy üzenetsor vagy előfizetés kézbesítetlen levél entitásában vannak üzenetek, még akkor is, ha aktív figyelők vannak az adott üzenetsor vagy előfizetés kézbesítetlen levelek entitásán. Akkor is felmerül, ha a kézbesítetlen üzenetek száma 0-ról pozitív értékre vált az üzenetsor vagy előfizetés kézbesítetlen levelű entitásához.

Példaesemény

Figyelők nélkül elérhető aktív üzenetek

Ez az esemény akkor jön létre, ha aktív üzenetek találhatók egy üzenetsorban vagy előfizetésben, és nincsenek figyelő fogadók.

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

Figyelők nélkül elérhető kézbesíthetetlen üzenetek

A kézbesítetlen levelek üzenetsor-eseményének sémája hasonló. Üzenetsoronként legalább egy olyan eseményt kap, amely üzeneteket tartalmaz, és nincsenek aktív fogadók.

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

Aktív üzenetek – rendszeres értesítések

Ez az esemény rendszeres időközönként jön létre, ha aktív üzenetei vannak az adott üzenetsorban vagy előfizetésben, még akkor is, ha az adott üzenetsor vagy előfizetés aktív figyelői vannak.

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

A kézbesíthetetlen üzenetek rendszeres értesítéseket is elérhetővé válnak

Ez az esemény rendszeres időközönként létrejön, ha az adott üzenetsoron vagy előfizetésen holtleíró üzenetek vannak, még akkor is, ha az adott üzenetsor vagy előfizetés holtleíró entitásán aktív figyelők találhatók.

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

Esemény tulajdonságai

Egy esemény a következő legfelső szintű adatokkal rendelkezik:

Tulajdonság Típus Leírás
topic húr Az eseményforrás teljes erőforrás-elérési útja. Ez a mező nem írható. Az értéket az Event Grid adja meg.
subject húr Az esemény tárgyra mutató, a közzétevő által megadott elérési út.
eventType húr Az eseményforráshoz felvett eseménytípusok egyike.
eventTime húr Az esemény létrehozásának időpontja a szolgáltató UTC-ideje alapján.
id húr Az esemény egyedi azonosítója.
data object Blob Storage-eseményadatok.
dataVersion húr Az adatobjektum sémaverziója. A sémaverziót a közzétevő határozza meg.
metadataVersion húr Az esemény metaadatok sémaverziója. A legfelső szintű tulajdonságokra az Event Grid határozza meg a sémát. Az értéket az Event Grid adja meg.

Az adatobjektum a következő tulajdonságokkal rendelkezik:

Tulajdonság Típus Leírás
namespaceName húr Az erőforrás által megadott Service Bus-névtér.
requestUri húr Az eseményt kibocsátó adott üzenetsor vagy előfizetés URI-ja.
entityType húr Az eseményeket (üzenetsort vagy előfizetést) kibocsátó Service Bus-entitás típusa.
queueName húr Az üzenetsor aktív üzenetekkel, ha feliratkozik egy üzenetsorra. Null érték, ha témaköröket/előfizetéseket használ.
topicName húr Az aktív üzenetekkel rendelkező Service Bus-előfizetés témaköre. Null érték, ha üzenetsort használ.
subscriptionName húr A Service Bus-előfizetés aktív üzenetekkel. Null érték, ha üzenetsort használ.

Oktatóanyagok és útmutatók

Cím Leírás
Oktatóanyag: Azure Service Bus–Azure Event Grid-integrációs példák Az Event Grid üzeneteket küld a Service Bus-témakörből a függvényalkalmazásnak és a logikai alkalmazásnak.
Azure Service Bus–Event Grid-integráció A Service Bus és az Event Grid integrálásának áttekintése.

Feljegyzés

Ha feladatátvétel történik egy olyan Service Bus-névtér esetében, amely engedélyezve van a Geo-DR-ben, a másodlagos névtér nem bocsát ki eseményeket az Event Gridnek. Manuálisan kell hozzáadnia az Event Grid-előfizetést a másodlagos névtérhez.

Következő lépések