إضافة القياسات المخصصة

ينطبق على: علامة اختيار IoT Edge 1.5 IoT Edge 1.5 علامة اختيار IoT Edge 1.4 IoT Edge 1.4

هام

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

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

نموذج مستودع الوحدات النمطية

راجع azure-samples repo للحصول على أمثلة من الوحدات النمطية المخصصة التي تم تجهيزها لإصدار المقاييس. حتى إذا لم تتوفر عينة باللغة التي تختارها بعد، فقد يساعدك النهج العام.

تقاليد التسمية

راجع أفضل الممارسات من مستندات Prometheus للحصول على إرشادات عامة. يمكن أن تكون التوصيات الإضافية التالية مفيدة لسيناريوهات IoT Edge.

  • قم بتضمين اسم الوحدة النمطية في بداية اسم المقياس لتوضيح الوحدة النمطية التي انبعث منها المقياس.

  • قم بتضمين اسم مركز IoT أو اسم تطبيق IoT Central ومعرف جهاز IoT Edge ومعرف الوحدة النمطية كتسميات (تسمى أيضا أبعاد العلامات/) في كل مقياس. تتوفر هذه المعلومات كمتغيرات بيئة لكل وحدة بدأها عامل IoT Edge. يتم توضيح النهج من خلال المثال في مستودع العينات. بدون هذا السياق، من المستحيل إقران قيمة قياس معينة بجهاز معين.

  • تضمين معرف مثيل في التسميات. يمكن أن يكون معرف المثيل أي معرف فريد مثل GUID الذي يتم إنشاؤه أثناء بدء تشغيل الوحدة النمطية. يمكن أن تساعد معلومات معرف المثيل في تسوية إعادة تشغيل الوحدة النمطية عند معالجة مقاييس الوحدة النمطية في الخلفية.

تكوين مجمع المقاييس لجمع المقاييس المخصصة

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

يجب تحديث متغير MetricsEndpointsCSV البيئة لتضمين عنوان URL لنقطة نهاية مقاييس الوحدة المخصصة. عند تحديث متغير البيئة، تأكد من تضمين نقاط نهاية وحدة النظام كما هو موضح في مثال تكوين مجمع القياس.

إشعار

بشكل افتراضي، لا تحتاج نقطة نهاية مقاييس الوحدة النمطية المخصصة إلى تعيينها إلى منفذ مضيف للسماح لجامع المقاييس بالوصول إليها. ما لم يتم تجاوزها بشكل صريح، على Linux، يتم بدء تشغيل كلتا الوحدتين النمطيتين على شبكة جسر Docker المعرفة من قبل المستخدم تسمى azure-iot-edge.

تتضمن شبكات Docker المعرفة من قبل المستخدم محلل DNS افتراضيا يسمح بالاتصال بين الوحدات النمطية باستخدام أسماء الوحدة النمطية (الحاوية). على سبيل المثال، إذا كانت وحدة نمطية مخصصة تسمى module1 تنبعث منها مقاييس على منفذ http 9600 في المسار /metrics، يجب تكوين المجمع لتجميعه من نقطة http://module1:9600/metricsالنهاية .

قم بتشغيل الأمر التالي على جهاز IoT Edge لاختبار ما إذا كانت المقاييس المنبعثة من وحدة نمطية مخصصة على منفذ http 9600 في المسار /المقاييس يمكن الوصول إليها:

sudo docker exec replace-with-metrics-collector-module-name curl http://replace-with-custom-module-name:9600/metrics

إضافة مرئيات مخصصة

بمجرد تلقي مقاييس مخصصة في Log Analytics، يمكنك إنشاء مرئيات وتنبيهات مخصصة. يمكن زيادة مصنفات المراقبة لإضافة مرئيات مدعومة بالاستعلام.

يرتبط كل مقياس بمعرف المورد لمركز IoT أو تطبيق IoT Central. لهذا السبب يمكنك التحقق مما إذا كانت مقاييسك المخصصة قد تم استيعابها بشكل صحيح من صفحة Logs الخاصة بمركز IoT المقترن أو تطبيق IoT Central بدلا من مساحة عمل Log Analytics المدعومة. استخدم استعلام KQL الأساسي هذا للتحقق من:

InsightsMetrics
| where Name == 'replace-with-custom-metric-name'

بمجرد تأكيد الاستيعاب، يمكنك إما إنشاء مصنف جديد أو زيادة مصنف موجود. استخدم مستندات المصنفات والاستعلامات من مصنفات IoT Edge المنسقة كدليل.

عندما تكون راضيا عن النتائج، يمكنك مشاركة المصنف مع فريقك أو توزيعه برمجيا كجزء من عمليات نشر موارد مؤسستك.

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

استكشف خيارات تصور المقاييس الإضافية باستخدام المصنفات المنسقة.