مشاركة عبر

مساحة اسم شبكة أحداث Azure (معاينة) كمصدر لشبكة الأحداث

  • مقالة

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

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

تصدر مساحة اسم Azure Event Grid (معاينة) أنواع الأحداث التالية:

نوع الحدث ‏‏الوصف
Microsoft.EventGrid.MQTTClientSession الاتصال ed يتم نشرها عند توصيل جلسة عمل عميل MQTT بشبكة الأحداث.
Microsoft.EventGrid.MQTTClientSessionDisconnected يتم نشرها عند قطع اتصال جلسة عمل عميل MQTT ب Event Grid.
Microsoft.EventGrid.MQTTClientCreatedOrUpdated يتم نشره عند إنشاء عميل MQTT أو تحديثه في مساحة اسم شبكة الأحداث.
Microsoft.EventGrid.MQTTClientDeleted يتم نشره عند حذف عميل MQTT من مساحة اسم شبكة الأحداث.

مثال حدث

يظهر هذا الحدث النموذجي مخطط حدث تم رفعه عندما تكون جلسة عمل عميل MQTT متصلة بشبكة أحداث:

[{
  "specversion": "1.0",
  "id": "5249c38a-a048-46dd-8f60-df34fcdab06c",
  "time": "2023-07-29T01:23:49.6454046Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionConnected",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1
  }
}]

يظهر هذا الحدث النموذجي مخطط حدث تم رفعه عند قطع اتصال جلسة عمل عميل MQTT بشبكة الأحداث:

[{
  "specversion": "1.0",
  "id": "e30e5174-787d-4e19-8812-580148bfcf7b",
  "time": "2023-07-29T01:27:40.2446871Z",
  "type": "Microsoft.EventGrid.MQTTClientSessionDisconnected",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1/sessions/session1",
  "data": {
    "namespaceName": "myns",
    "clientAuthenticationName": "client1",
    "clientSessionName": "session1",
    "sequenceNumber": 1,
    "disconnectionReason": "ClientInitiatedDisconnect"
  }
}]

يظهر هذا الحدث النموذجي مخطط حدث تم رفعه عند إنشاء عميل MQTT أو تحديثه في مساحة اسم شبكة الأحداث:

[{
  "specversion": "1.0",
  "id": "383d1562-c95f-4095-936c-688e72c6b2bb",
  "time": "2023-07-29T01:14:35.8928724Z",
  "type": "Microsoft.EventGrid.MQTTClientCreatedOrUpdated",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "createdOn": "2023-07-29T01:14:34.2048108Z",
    "updatedOn": "2023-07-29T01:14:34.2048108Z",
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1",
    "state": "Enabled",
    "attributes": {
      "attribute1": "value1"
    }
  }
}]

يظهر هذا الحدث النموذجي مخطط حدث تم رفعه عند حذف عميل MQTT من مساحة اسم شبكة الأحداث:

[{
  "specversion": "1.0",
  "id": "2a93aaf9-66c2-4f8e-9ba3-8d899c10bf17",
  "time": "2023-07-29T01:30:52.5620566Z",
  "type": "Microsoft.EventGrid.MQTTClientDeleted",
  "source": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myrg/providers/Microsoft.EventGrid/namespaces/myns",
  "subject": "clients/client1",
  "data": {
    "namespaceName": "myns",
    "clientName": "client1",
    "clientAuthenticationName": "client1"
  }
}]

خصائص الحدث

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

الخاصية نوع الوصف
id سلسلة المعرف الفريد للحدث.
source سلسلة مسار المورد الكامل إلى مصدر الحدث. هذا الحقل غير قابل للكتابة. توفر شبكة الأحداث هذه القيمة.
subject سلسلة مسار يحدده الناشر لموضوع الحدث.
type سلسلة أحد أنواع الأحداث المسجلة لمصدر الحدث الماثل.
time سلسلة الوقت الذي يتم إنشاء الحدث استناداً إلى وقت UTC الموفر.
data كائن بيانات حدث مساحة اسم شبكة الأحداث.
specversion سلسلة إصدار مواصفات مخطط CloudEvents.

يحتوي كائن البيانات على الخصائص التالية:

الخاصية نوع الوصف
namespaceName سلسلة اسم مساحة اسم شبكة الأحداث حيث كان عميل MQTT متصلا أو غير متصل.
clientAuthenticationName سلسلة المعرف الفريد لعميل MQTT الذي يقدمه العميل إلى الخدمة للمصادقة. يمكن أن يصل طول السلسلة الحساسة لحالة الأحرف هذه إلى 128 حرفا، وتدعم أحرف UTF-8.
clientSessionName سلسلة معرف فريد لجلسة عمل عميل MQTT. يمكن أن يصل طول السلسلة الحساسة لحالة الأحرف هذه إلى 128 حرفا، وتدعم أحرف UTF-8.
sequenceNumber طويل رقم يساعد على الإشارة إلى ترتيب أحداث جلسة عمل عميل MQTT المتصلة أو غير المتصلة. سيكون لأحدث حدث رقم تسلسل أعلى من الحدث السابق.
disconnectionReason سلسلة سبب قطع اتصال جلسة عمل عميل MQTT. قد تكون القيمة إحدى القيم في جدول أسباب قطع الاتصال.
createdOn سلسلة الوقت الذي يتم فيه إنشاء مورد العميل استنادا إلى وقت UTC للموفر.
updatedOn سلسلة وقت آخر تحديث لمورد العميل استنادا إلى وقت UTC للموفر. إذا لم يتم تحديث مورد العميل مطلقا، تكون هذه القيمة مطابقة لقيمة الخاصية "createOn"
clientName سلسلة وقت آخر تحديث لمورد العميل استنادا إلى وقت UTC للموفر. إذا لم يتم تحديث مورد العميل مطلقا، تكون هذه القيمة مطابقة لقيمة الخاصية "createOn".
state سلسلة الحالة المكونة للعميل. يمكن تمكين القيمة أو تعطيلها.
attributes سلسلة صفيف سمات زوج قيمة المفتاح التي تم تعيينها إلى مورد العميل.

أسباب قطع الاتصال:

توضح القائمة التالية تفاصيل القيم المختلفة ل disconnectionReason ووصفها:

سبب قطع الاتصال ‏‏الوصف
ClientAuthenticationError تم قطع اتصال العميل لأي أسباب مصادقة (على سبيل المثال، انتهت صلاحية الشهادة أو تعطيل العميل أو تغيير تكوين العميل)
ClientAuthorizationError تم قطع اتصال العميل لأي أسباب تخويل (على سبيل المثال، بسبب تغيير في تكوين مسافات الموضوع أو روابط الأذونات أو مجموعات العملاء)
ClientError أرسل العميل طلبا غير صحيح أو استخدم إحدى الميزات غير المدعومة التي أدت إلى إنهاء الاتصال بواسطة الخدمة.
ClientInitiatedDisconnect يبدأ العميل قطع اتصال رشيق من خلال حزمة DISCONNECT ل MQTT أو إطار إغلاق ل MQTT عبر WebSocket.
الاتصال است يتم فقدان الاتصال بين العميل والخادم.
IpForbidden يتم حظر عنوان IP الخاص بالعميل بواسطة عامل تصفية IP أو تكوين الارتباطات الخاصة.
QuotaExceeded تجاوز العميل واحدا أو أكثر من حدود التقييد التي أدت إلى إنهاء الاتصال بواسطة الخدمة.
ServerError تم إنهاء الاتصال بسبب خطأ خادم غير متوقع
ServerInitiatedDisconnect يبدأ الخادم قطع اتصال رشيق لأي سبب تشغيلي
تجاوز جلسة العمل وصلت قائمة انتظار العميل لرسائل QoS1 غير المعترف بها إلى حدها الأقصى، مما أدى إلى إنهاء الاتصال بواسطة الخادم
SessionTakenOver تمت إعادة اتصال العميل بنفس اسم المصادقة، مما أدى إلى إنهاء الاتصال السابق.

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

  • لمعرفة المزيد حول موضوعات نظام شبكة الأحداث، راجع موضوعات النظام
  • للتعرف على الأحداث المنبعثة من مساحة اسم Event Grid وكيفية استخدامها، راجع أحداث دورة حياة عميل MQTT.