Share via

ناقل خدمة Azure كمصدر شبكة الأحداث

  • مقالة

توفر هذه المقالة خصائص ومخطط أحداث ناقل خدمة Azure. للحصول على مقدمة لمخططات الأحداث، راجع مخطط حدث Azure Event Grid.

إشعار

تدعم مساحة الاسم Premium tier ناقل خدمة Microsoft Azure فقط تكامل الأحداث. لا تدعم المستويات الأساسية والقياسية التكامل مع Event Grid.

أنواع الأحداث المتاحة

خدمة ناقل ترسل أنواع الأحداث التالية:

نوع الحدث ‏‏الوصف
Microsoft.ServiceBus.ActiveMessagesAvailableWithNoListeners يرفع عند وصول رسالة نشطة جديدة في قائمة انتظار أو اشتراك ولا توجد أجهزة استقبال تستمع.
Microsoft.ServiceBus.DeadletterMessagesAvailableWithNoListeners يتم رفعه عند وصول رسائل نشطة جديدة في قائمة انتظار غير مستخدمة ولا توجد وحدات استماع نشطة.
Microsoft.ServiceBus.ActiveMessagesAvailablePeriodicNotifications يتم رفعها كل 30 ثانية إذا كانت هناك رسائل نشطة في قائمة انتظار أو اشتراك، حتى إذا كان هناك مستمعون نشطون في قائمة الانتظار أو الاشتراك المحدد. يتم رفعها أيضا عندما ينتقل عدد الرسائل النشطة من 0 إلى قيمة إيجابية لقائمة الانتظار أو الاشتراك.
Microsoft.ServiceBus.DeadletterMessagesAvailablePeriodicNotifications يتم رفعها كل 30 ثانية إذا كانت هناك رسائل في كيان الأحرف المهملة لقائمة انتظار أو اشتراك، حتى إذا كان هناك مستمعون نشطون في كيان الحرف المهمل في قائمة الانتظار أو الاشتراك المحدد. يتم رفعه أيضا عندما ينتقل عدد رسائل الأحرف المهملة من 0 إلى قيمة إيجابية لكيان الحرف المهمل في قائمة الانتظار أو الاشتراك.

مثال حدث

الرسائل النشطة المتوفرة بدون مستمعين

يتم إنشاء هذا الحدث إذا كان لديك رسائل نشطة في قائمة انتظار أو اشتراك ولا توجد أجهزة استقبال تستمع.

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

تتوفر رسائل غير مستخدمة بدون مستمعين

المخطط لحدث قائمة انتظار حرف مهمل مشابه. تحصل على حدث واحد على الأقل لكل قائمة انتظار بالأحرف المهملة تحتوي على رسائل ولا توجد أجهزة استقبال نشطة.

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

الإعلامات الدورية المتوفرة للرسائل النشطة

يتم إنشاء هذا الحدث بشكل دوري إذا كانت لديك رسائل نشطة في قائمة الانتظار أو الاشتراك المحدد، حتى إذا كانت هناك وحدات استماع نشطة لقائمة الانتظار أو الاشتراك المحدد.

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

الرسائل غير المستخدمة المتوفرة إعلامات دورية

يتم إنشاء هذا الحدث بشكل دوري إذا كان لديك رسائل بخط توقف في قائمة الانتظار أو الاشتراك المحدد، حتى إذا كان هناك مستمعون نشطون على كيان الخط المهمل الخاص بقائمة الانتظار أو الاشتراك المحدد.

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

خصائص الحدث

ويحتوي الحدث على بيانات المستوى الأعلى التالية:

الخاصية نوع الوصف
topic سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر شبكة الأحداث هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
eventType سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث الماثل.
eventTime سلسلة الوقت الذي يتم إنشاء الحدث استناداً إلى وقت UTC الموفر.
id سلسلة المعرف الفريد للحدث.
data كائن بيانات حدث تخزين البيانات الثنائية الكبيرة.
dataVersion سلسلة إصدار مخطط كائن البيانات. يعرّف الناشر إصدار المخطط.
metadataVersion سلسلة إصدار مخطط البيانات الوصفية للحدث. تحدد «شبكة الأحداث» مخطط خصائص المستوى الأعلى. توفر شبكة الأحداث هذه القيمة.

كائن البيانات له الخصائص التالية:

الخاصية نوع الوصف
namespaceName سلسلة مساحة اسم ناقل الخدمة الموجود في المورد.
requestUri سلسلة عنوان URI إلى قائمة الانتظار المحددة أو الاشتراك الذي ينبعث منه الحدث.
entityType سلسلة نوع كيان ناقل الخدمة الذي يرسل أحداث (قائمة الانتظار أو الاشتراك).
queueName سلسلة قائمة الانتظار التي تحتوي على رسائل نشطة في حالة الاشتراك في قائمة انتظار. القيمة فارغة إذا كنت تستخدم مواضيع / اشتراكات.
topicName سلسلة الموضوع الذي ينتمي إليه اشتراك ناقل الخدمة مع الرسائل النشطة. القيمة فارغة إذا كنت تستخدم قائمة انتظار.
subscriptionName سلسلة اشتراك ناقل الخدمة مع الرسائل النشطة. القيمة فارغة إذا كنت تستخدم قائمة انتظار.

البرامج التعليمية والدروس المعرفية

المسمى الوظيفي ‏‏الوصف
البرنامج التعليمي: أمثلة على تكامل ناقل خدمة Microsoft Azure إلى خطوط شبكة الأحداث Microsoft Azure يرسل Event Grid رسائل من موضوع ناقل خدمة Microsoft Azure إلى تطبيق الوظائف والتطبيق المنطقي.
نظرة عامة على تكامل Azure Service Bus إلى Event Grid نظرة عامة حول دمج ناقل خدمة Microsoft Azure مع شبكة الأحداث.

إشعار

عند حدوث تجاوز فشل لمساحة اسم ناقل خدمة Microsoft Azure التي تم تمكين Geo-DR بها، لا تصدر مساحة الاسم الثانوية أحداثا إلى شبكة الأحداث. تحتاج إلى إضافة اشتراك Event Grid يدويا لمساحة الاسم الثانوية.

الخطوات التالية