مراقبة عمليات توزيع IoT Edge

ينطبق على: IoT Edge 1.5 IoT Edge 1.4

هام

IoT Edge 1.5 LTS وIoT Edge 1.4 LTS هي إصدارات مدعومة. IoT Edge 1.4 LTS هو نهاية العمر الافتراضي في 12 نوفمبر 2024. إذا كنت تستخدم إصدارا سابقا، فشاهد تحديث IoT Edge.

يوفر Azure IoT Edge تقارير تتيح لك مراقبة المعلومات في الوقت الحقيقي على الوحدات النمطية المنشورة على أجهزة IoT Edge. تسترد خدمة IoT Hub الحالة من الأجهزة وتجعلها متاحة للمشغل. المراقبة مهمة أيضا بالنسبة إلى عمليات النشر التي تتم على نطاق واسع والتي تتضمن عمليات النشر التلقائية وعمليات النشر ذات الطبقات.

تحتوي كل من الأجهزة والوحدات النمطية على بيانات مماثلة، مثل الاتصال، لذلك يتم الحصول على القيم وفقا لمعرف الجهاز أو معرف الوحدة النمطية.

تجمع خدمة IoT Hub البيانات التي تم الإبلاغ عنها بواسطة توائم الجهاز والوحدة النمطية وتوفر عدد الحالات المختلفة التي قد تكون لدى الأجهزة. تنظم خدمة IoT Hub هذه البيانات في أربع مجموعات من المقاييس:

النوع	‏‏الوصف
مستهدف	إظهار أجهزة IoT Edge التي تطابق حالة استهداف التوزيع.
تم التطبيق	يعرض أجهزة IoT Edge المستهدفة التي لا تستهدفها عملية نشر أخرى ذات أولوية أعلى.
الإبلاغ عن النجاح	يظهر أجهزة IoT Edge التي أبلغت عن نشر الوحدات بنجاح.
فشل إعداد التقارير	يعرض أجهزة IoT Edge التي أبلغت عن عدم نشر وحدة نمطية واحدة أو أكثر بنجاح. للمزيد من التحقيق في الخطأ، اتصل عن بعد بهذه الأجهزة واعرض ملفات السجل.

توفر خدمة IoT Hub هذه البيانات لمراقبتها في مدخل Microsoft Azure وفي Azure CLI.

مراقبة التوزيع في مدخل Microsoft Azure

لعرض تفاصيل التوزيع ومراقبة الأجهزة التي تقوم بتشغيله، استخدم الخطوات التالية:

1. سجل الدخول إلى مدخل Microsoft Azure وانتقل إلى IoT Hub.

2. حدد Configurations + Deployments ضمن قائمة إدارة الأجهزة.

3. فحص قائمة التوزيع. لكل عملية نشر، يمكنك عرض التفاصيل التالية:

   العمود	‏‏الوصف
   البطاقة/رقم البطاقة	اسم التوزيع.
   نوع	نوع التوزيع، إما النشر أو التوزيع متعدد الطبقات.
   شرط الهدف	العلامة المستخدمة لتعريف الأجهزة المستهدفة.
   أولوية	رقم الأولوية المعين للنشر.
   مقاييس النظام	عدد توائم الجهاز في IoT Hub التي تطابق شرط الاستهداف. يحدد Applied عدد الأجهزة التي تم تطبيق محتوى التوزيع عليها على توائم الوحدة النمطية الخاصة بهم في IoT Hub.
   مقاييس الجهاز	عدد أجهزة IoT Edge التي تبلغ عن نجاح أو أخطاء من وقت تشغيل عميل IoT Edge.
   مقاييس مخصصة	عدد أجهزة IoT Edge التي تقوم بالإبلاغ عن البيانات لأي مقاييس قمت بتعريفها للنشر.
   تم الإنشاء	الطابع الزمني من وقت إنشاء النشر. يتم استخدام هذا الطابع الزمني لقطع الروابط عندما يكون لاثنين من عمليات التوزيع الأولوية نفسها.

4. حدد التوزيع الذي تريد مراقبته.

5. في صفحة تفاصيل النشر، مرر لأسفل إلى القسم السفلي وحدد علامة التبويب الشرط الهدف. حدد عرض لسرد الأجهزة التي تطابق الشرط الهدف. يمكنك تغيير الشرط وأيضا الأولوية. حدد حفظ إذا قمت بإجراء تغييرات.

   

6. حدد علامة التبويب Metrics. إذا اخترت مقياسا من القائمة المنسدلة تحديد مقياس، يظهر زر عرض لعرض النتائج. يمكنك أيضا تحديد تحرير المقاييس لضبط المعايير لأي مقاييس مخصصة قمت بتعريفها. حدد حفظ إذا قمت بإجراء تغييرات.

   

لإجراء تغييرات على التوزيع، راجع تعديل عملية توزيع.

مراقبة التوزيع باستخدام Azure CLI

استخدم الأمر az iot edge deployment show لعرض تفاصيل عملية نشر واحدة:

az iot edge deployment show --deployment-id [deployment id] --hub-name [hub name]

يأخذ أمر عرض التوزيع المعلمات التالية:

• --deployment-id - اسم النشر الموجود في مركز IoT. المعلمة المطلوبة.
• --hub-name - اسم مركز IoT الذي يوجد فيه التوزيع. يجب أن يكون المركز موجود في الاشتراك الحالي. قم بالتبديل إلى الاشتراك المطلوب باستخدام الأمر az account set -s [subscription name]

افحص التوزيع في نافذة الأوامر. تسرد خاصية القياسات عددًا لكل قياس يتم تقييمه بواسطة كل مركز:

• targetedCount - مقياس نظام يحدد عدد الأجهزة المزدوجة في IoT Hub التي تتطابق مع حالة الاستهداف.
• appliedCount - يحدد مقياس النظام عدد الأجهزة التي تم تطبيق محتوى التوزيع عليها على توائم الوحدة النمطية في IoT Hub.
• reportedSuccessfulCount - مقياس جهاز يحدد عدد أجهزة IoT Edge في نجاح تقارير النشر من وقت تشغيل عميل IoT Edge.
• reportedFailedCount - مقياس جهاز يحدد عدد أجهزة IoT Edge في فشل إعداد التقارير عن النشر من وقت تشغيل عميل IoT Edge.

يمكنك عرض قائمة بمعرفات الجهاز أو الكائنات لكل مقياس من المقاييس باستخدام الأمر az iot edge deployment show-metric :

az iot edge deployment show-metric --deployment-id [deployment id] --metric-id [metric id] --hub-name [hub name]

يأخذ الأمر deployment show-metric المعلمات التالية:

• --deployment-id - اسم النشر الموجود في مركز IoT.
• --metric-id - اسم المقياس الذي تريد رؤية قائمة معرفات الجهاز له، على سبيل المثال reportedFailedCount.
• --hub-name - اسم مركز IoT الذي يوجد فيه التوزيع. يجب أن يكون المركز موجود في الاشتراك الحالي. التبديل إلى الاشتراك المطلوب باستخدام الأمر az account set -s [subscription name].

لإجراء تغييرات على التوزيع، راجع تعديل عملية توزيع.

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

تعرف على كيفية مراقبة توائم الوحدة النمطية، في المقام الأول IoT Edge Agent ووحدات وقت تشغيل IoT Edge Hub، للاتصال وصحة عمليات نشر IoT Edge.