الإدارة التلقائية لجهاز IoT والوحدة النمطية باستخدام مدخل Microsoft Azure

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

• مدخل Azure
• CLI

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

ملاحظة

تتوفر الميزات الموضحة في هذه المقالة فقط في الطبقة القياسية من IoT Hub. لمزيد من المعلومات حول طبقات IoT Hub الأساسية والقياسية/المجانية، راجع اختيار طبقة IoT Hub المناسبة.

تعمل الإدارة التلقائية للجهاز عن طريق تحديث مجموعة من توائم الجهاز أو توائم الوحدة النمطية ذات الخصائص المطلوبة والإبلاغ عن ملخص يستند إلى الخصائص التي تم الإبلاغ عنها للتوائم يُقدم فئة جديدة و مستند JSON يسمى تكوين يحتوي على ثلاثة أجزاء:

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

• يحدد المحتوى المستهدف الخصائص المطلوبة التي سيتم إضافتها أو تحديثها في توائم الجهاز المستهدفة أو توائم الوحدة. يتضمن المحتوى مساراً إلى قسم الخصائص المطلوبة المراد تغييرها.

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

يتم تشغيل التكوينات التلقائية لأول مرة بعد وقت قصير من إنشاء التكوين ثم على فترات زمنية مدتها خمس دقائق. يتم تشغيل استعلامات المقاييس في كل مرة يتم فيها تشغيل التكوين التلقائي.

تنفيذ التوائم

تتطلب تكوينات الجهاز التلقائية استخدام توائم الجهاز لمزامنة الحالة بين السحابة والأجهزة. لمزيد من المعلومات، راجع فهم واستخدام الجهاز المزدوج في IoT Hub.

تتطلب تكوينات الوحدة التلقائية استخدام توائم الوحدة النمطية لمزامنة الحالة بين السحابة والوحدات. لمزيد من المعلومات، راجع فهم التوائم النمطية واستخدامها في IoT Hub.

استخدام العلامات لاستهداف الأجهزة المزدوجة

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

"tags": {
	"location": {
		"state": "Washington",
		"city": "Tacoma"
    }
},

إنشاء تكوين

1. في مدخل Azure، انتقل إلى مركز إنترنت الأشياء.

2. حدد التكوينات في جزء التنقل الأيمن.

3. حدد إضافة تكوين الجهاز أو إضافة تكوينالوحدة النمطية.

   

هناك خمس خطوات لإنشاء تكوين. الأقسام التالية تمشي من خلال كل واحد.

الاسم والتسمية

1. امنح التكوين اسما فريدا يصل طوله إلى 128 حرفا. يسمح بالأحرف الصغيرة والأحرف الخاصة التالية: -+%_*!'. لا يسمح بالمسافات.

2. أضف تسميات للمساعدة في تعقب التكوينات. التّسميات هي الاسم، وأزواج القيم التي تصف التكوين الخاص بك. على سبيل المثال، HostPlatform, Linux أو Version, 3.0.1.

3. حدد "التالي" للانتقال إلى علامة التبويب التالية.

تحديد الإعدادات

يحدد هذا القسم المحتوى المراد تعيينه في الخصائص المستهدفة للجهاز التوأم أو الوحدة التوأم المطلوب. هناك إدخالان لكل مَجموعة من الإعدادات. الأول هو المسار التوأم ، وهو المسار إلى قسم JSON ضمن الخصائص التوأم المطلوبة التي سيتم تعيينها. والثاني هو محتوى JSON لإدراجه في هذا المَقطع.

على سبيل المثال، يمكنك تعيين المسار المزدوج إلى properties.desired.chiller-water محتوى JSON التالي ثم توفيره:

{
  "temperature": 66,
  "pressure": 28
}

يمكنك أيضا تعيين الإعدادات الفردية عن طريق تحديد المسار التوأم بأكمله وتوفير القيمة بدون أقواس. على سبيل المثال ، باستخدام المسار properties.desired.chiller-water.temperatureالتوأم ، اضبط المحتوى على 66. ثم قم بإنشاء إعداد توأم جديد لخاصية الضغط.

إذا استهدف تكوينان أو أكثر نفس المسار المزدوج، تطبيق المحتوى من تكوين الأولوية العليا (يتم تعريف الأولوية في الخطوة 4).

إذا كنت ترغب في إزالة خاصية موجودة، فحدد قيمة الخاصية إلى null.

يمكنك إضافة إعدادات إضافية عن طريق تحديد إضافة إعداد توأم الجهاز أو إضافة إعداد توأمالوحدة النمطية.

تحديد المقاييس (اختياري)

توفر المقاييس عددا موجزا للحالات المختلفة التي قد يبلغ عنها الجهاز أو الوحدة النمطية بعد تطبيق محتوى التكوين. على سبيل المثال، يُمكنك إنشاء مقياس لتغييرات الإعدادات المعلقة، ومقياس للأخطاء، ومقياس للتغييرات الناجحة في الإعدادات.

يمكن أن يحتوي كل تكوين على ما يصل إلى خمسة مقاييس مخصصة.

1. أدخل اسما لاسم المقياس.

2. أدخل استعلام عن معايير المقياس. يستند الاستعلام إلى خصائص الجهاز المزدوج المبلغ عنها. يُمثل المقياس عدد الصفوف التي تم إرجاعها بواسطة الاستعلام.

على سبيل المثال:

SELECT deviceId FROM devices 
  WHERE properties.reported.chillerWaterSettings.status='pending'

يمكنك تضمين جملة "تم تطبيق التكوين"، على سبيل المثال:

/* Include the double brackets. */
SELECT deviceId FROM devices 
  WHERE configurations.[[yourconfigname]].status='Applied'

إذا كنت تقوم بإنشاء مقياس للإبلاغ عن الوحدات النمطية التي تم تكوينها، فحدد moduleId من devices.modules. على سبيل المثال:

SELECT deviceId, moduleId FROM devices.modules
  WHERE properties.reported.lastDesiredStatus.code = 200

الأجهزة المستهدفة

استخدم خاصية العلامات من توأمك لاستهداف الأجهزة أو الوحدات النمطية المحددة التي يجب أن تتلقى هذا التكوين. يمكنك أيضا استهداف الخصائص المزدوجة المبلغ عنها.

يمكن لتكوينات الجهاز التلقائية استهداف العلامات المزدوجة للجهاز فقط، ويمكن لتكوينات الوحدات التلقائية استهداف العلامات المزدوجة للوحدة النمطية فقط.

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

1. أدخل عددا صحيحا موجبالأولويةالتكوين. تعتبر أعلى قيمة عددية هي الأولوية القصوى. إذا كان هناك تكوينان لهما نفس رقم الأولوية، يُعتد بالترتيب الذي تم إنشاؤه مؤخرًا.

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

   بالنسبة إلى التكوين التلقائي للجهاز، يمكنك تحديد العلامة أو الموقع الذي تم الإبلاغ عنه لاستهدافه فقط. على سبيل المثال، tags.environment='test' أو properties.reported.chillerProperties.model='4000x'. يمكنك تحديد * لاستهداف جميع الأجهزة.

   بالنسبة للتكوين التلقائي للوحدة النمطية، استخدم استعلاما لتحديد العلامات أو الخصائص التي تم الإبلاغ عنها من الوحدات النمطية المسجلة في مركز إنترنت الأشياء. على سبيل المثال، from devices.modules where tags.environment='test' أو from devices.modules where properties.reported.chillerProperties.model='4000x'. لا يمكن استخدام حرف البدل لاستهداف جميع الوحدات النمطية.

3. حدد «التالي» للانتقال إلى الخطوة الأخيرة.

مراجعة التكوين

راجع معلومات التكوين، ثم حدد «إرسال».

راقب التكوين

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

1. في مدخل Azure، انتقل إلى مركز إنترنت الأشياء.

2. حدد التكوينات في إدارة الأجهزة.

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

   • معرف - اسم التكوين.

   • الشرط المستهدف - الاستعلام المستخدم لتحديد الأجهزة أو الوحدات النمطية المستهدفة.

   • أولوية - رقم الأولوية المُعين للتكوين.

   • وقت الإنشاء - الطابع الزمني عند إنشاء التكوين. يتم استخدام هذا الطابع الزمني لقطع العلاقات عندما يكون هناك تكوينان لهما نفس الأولوية.

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

   • المقاييس المخصصة - المقاييس التي حددها مطور البرامج كطلبات بحث مقابل المواقع المزدوجة التي تم الإبلاغ عنها. يُمكن تعريف ما يصل إلى خمسة مقاييس مخصصة لكل تكوين.

4. حدّد التكوين الذي تريد مراقبته.

5. افحص تفاصيل التكوين. يُمكنك استخدام علامات التبويب لعرض تفاصيل محددة حول الأجهزة التي تلقت التكوين.

   • حالة الهدف - الأجهزة أو الوحدات التي تطابق الحالة المستهدفة.

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

   • الإعدادات الإعدادات التوأم للجهاز أو الوحدة التوأم - الإعدادات التوأم التي تم تعيينها بواسطة التكوين.

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

عدّل تكوين

عند تعديل تكوين، يتم نسخ التغييرات على الفور إلى جميع الأجهزة أو الوحدات النمطية المستهدفة.

إذا قمت بتحديث شرط الهدف، تحدث التحديثات التالية:

• إذا لم يستوف التوأم شرط الهدف القديم، ولكنه استوفى شرط الهدف الجديد وكان هذا التكوين هو الأولوية القصوى لهذا التوأم، تطبيق هذا التكوين.

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

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

لتعديل تكوين، استخدم الخَطوات التالية:

1. في مدخل Azure، انتقل إلى مركز إنترنت الأشياء.

2. حدد التكوينات في إدارة الأجهزة.

3. يرجى اختيار التكوين الذي تريد تعديله.

4. أدخل التحديثات على الحقول التالية:

   • أولوية
   • المقاييس
   • شرط الهدف
   • تسميات/ ملصقات

5. حدد ⁧⁩حفظ⁧⁩.

6. اتبع الخطوات الواردة في مراقبة تكوين لمشاهدة التغييرات التي يتم طرحها.

حذف تكوين

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

1. في مدخل Azure، انتقل إلى مركز إنترنت الأشياء.

2. حدد التكوينات في إدارة الأجهزة.

3. استخدم خانة الاختيار لتَحديد التكوين الذي تريد حذفه.

4. حدد⁧⁩حذف⁧⁩.

5. سيطلب منك التأكيد الفوري.

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

في هذه المقالة، تعلمت كيفية تكوين أجهزة إنترنت الأشياء ومراقبتها على نطاق واسع. اتبع هذه الروابط لمعرفة المزيد حول إدارة Azure IoT Hub:

• إدارة هويات أجهزة IoT Hub بشكل مجمع
• مراقبة مركز إنترنت الأشياء الخاص بك

لمزيد من استكشاف إمكانات IoT Hub، راجع:

• دليل مطوري IoT Hub
• نشر الذكاء الاصطناعي إلى الأجهزة الطرفية باستخدام Azure IoT Edge

لاستكشاف استخدام خدمة توفير الأجهزة IoT Hub لتمكين إدارة الحسابات بدون لمس وفي الوقت المناسب، راجع:

• انقر فوق خدمات تكوين إعدادات تشغيل الخدمة لجهاز مركز إنترنت الأشياء في Azure