Aracılığıyla paylaş

Event Grid kaynağı olarak Azure Service Bus

  • Makale

Bu makalede Service Bus olaylarının özellikleri ve şeması sağlanır. Olay şemalarına giriş için bkz . Azure Event Grid olay şeması.

Not

Yalnızca Premium katman Service Bus ad alanı olay tümleştirmeyi destekler. Temel ve Standart katmanlar Event Grid ile tümleştirmeyi desteklemez.

Kullanılabilir olay türleri

Service Bus aşağıdaki olay türlerini yayar:

Olay türü Açıklama
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners Yeni bir etkin ileti bir kuyruğa veya aboneliğe ulaştığında ve dinleyen alıcı olmadığında tetiklenir.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners Yeni bir etkin ileti teslim edilemeyen ileti kuyruğuna geldiğinde ve etkin dinleyici olmadığında tetiklenir.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications Kuyrukta veya abonelikte etkin iletiler varsa, belirli bir kuyrukta veya abonelikte etkin dinleyiciler olsa bile her 30 saniyede bir tetiklenir. Ayrıca etkin ileti sayısı 0'dan kuyruk veya abonelik için pozitif bir değere geçtiğinde de oluşturulur.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications Bir kuyruğun veya aboneliğin teslim edilemeyen ileti varlığında iletiler varsa, belirli bir kuyruğun veya aboneliğin teslim edilemeyen ileti varlığında etkin dinleyiciler olsa bile her 30 saniyede bir tetiklenir. Ayrıca, teslim edilemeyen ileti sayısı 0'dan kuyruğun veya aboneliğin teslim edilemeyen harf varlığı için pozitif bir değere geçtiğinde de tetiklenir.

Örnek olay

Dinleyicisi olmayan etkin iletiler

Bir kuyrukta veya abonelikte etkin iletileriniz varsa ve bir alıcı dinleme gerçekleştirmiyorsa bu olay oluşturulur.

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

Dinleyici olmadan kullanılabilir teslim edilemeyen iletiler

Teslim edilemeyen bir kuyruk olayının şeması benzerdir. İletileri olan ve etkin alıcısı olmayan teslim edilemeyen iletiler kuyruğu başına en az bir olay alırsınız.

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

Etkin iletiler düzenli aralıklarla kullanılabilir bildirimler

Belirli bir kuyruk veya abonelik için etkin dinleyiciler olsa bile belirli bir kuyrukta veya abonelikte etkin iletileriniz varsa bu olay düzenli aralıklarla oluşturulur.

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

Teslim edilemeyen iletiler kullanılabilir düzenli bildirimler

Belirli bir kuyruk veya aboneliğin deadletter varlığında etkin dinleyiciler olsa bile, belirli bir kuyrukta veya abonelikte ölü iletiniz varsa, bu olay düzenli aralıklarla oluşturulur.

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

Olay özellikleri

Bir olay aşağıdaki üst düzey verilere sahiptir:

Özellik Türü Veri Akışı Açıklaması
topic Dize Olay kaynağının tam kaynak yolu. Bu alan yazılabilir değil. Event Grid bu değeri sağlar.
subject Dize Olay konusunun yayımcı tarafından tanımlanan yolu.
eventType Dize Bu olay kaynağı için kayıtlı olay türlerinden biri.
eventTime Dize Sağlayıcının UTC saati temelinde olayın oluşturulduğu saat.
id Dize Olayın benzersiz tanımlayıcısı.
data nesne Blob depolama olay verileri.
dataVersion Dize Veri nesnesinin şema sürümü. Şema sürümünü yayımcı tanımlar.
metadataVersion Dize Olay meta verilerinin şema sürümü. Event Grid en üst düzey özelliklerin şemasını tanımlar. Event Grid bu değeri sağlar.

Veri nesnesi aşağıdaki özelliklere sahiptir:

Özellik Türü Veri Akışı Açıklaması
namespaceName Dize Kaynağın içinde bulunduğu Service Bus ad alanı.
requestUri Dize Olayı yayan belirli bir kuyruğa veya aboneliğe URI.
entityType Dize Olayları (kuyruk veya abonelik) yayan Service Bus varlığının türü.
queueName Dize Kuyruğa abone olunan etkin iletileri içeren kuyruk. Konu başlıkları /abonelikler kullanılıyorsa null değeri.
topicName Dize Etkin iletileri içeren Service Bus aboneliğinin ait olduğu konu başlığı. Kuyruk kullanıyorsanız null değeri.
subscriptionName Dize Etkin iletiler içeren Service Bus aboneliği. Kuyruk kullanıyorsanız null değeri.

Öğreticiler ve nasıl yapılır kılavuzları

Ünvan Açıklama
Öğretici: Azure Service Bus - Azure Event Grid tümleştirme örnekleri Event Grid, Service Bus konusundan işlev uygulamasına ve mantıksal uygulamaya ileti gönderir.
Azure Service Bus - Event Grid tümleştirmesi Service Bus'ın Event Grid ile tümleştirilmesine genel bakış.

Not

Geo-DR etkin bir Service Bus ad alanı için yük devretme gerçekleştiğinde, ikincil ad alanı Event Grid'e olay yaymaz. İkincil ad alanı için Event Grid aboneliğini el ile eklemeniz gerekir.

Sonraki adımlar