التواصل مع edgeAgent باستخدام أساليب مباشرة مضمنة

ينطبق على: 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.

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

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

يتم التعامل مع أسماء هذه الأساليب المباشرة غير حساسة لحالة الأحرف.

أداة اختبار الاتصال

يعد أسلوب ping مفيدا للتحقق مما إذا كان IoT Edge يعمل على جهاز، أو ما إذا كان الجهاز لديه اتصال مفتوح ب IoT Hub. استخدم هذا الأسلوب المباشر ل ping عامل IoT Edge والحصول على حالته. يقوم اختبار الاتصال الناجح بإرجاع حمولة فارغة و "الحالة": 200.

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

az iot hub invoke-module-method --method-name 'ping' -n <hub name> -d <device name> -m '$edgeAgent'

في مدخل Microsoft Azure، استدع الأسلوب باسم ping الأسلوب وحمولة {}JSON فارغة .

إعادة تشغيل الوحدة النمطية

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

يتوفر أسلوب RestartModule في الإصدار 1.0.9 من IoT Edge والإصدارات الأحدث.

تلميح

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

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

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

az iot hub invoke-module-method --method-name 'RestartModule' -n <hub name> -d <device name> -m '$edgeAgent' --method-payload \
'
    {
        "schemaVersion": "1.0",
        "id": "<module name>"
    }
'

في مدخل Microsoft Azure، استدع الأسلوب باسم RestartModule الأسلوب وحمولة JSON التالية:

{
    "schemaVersion": "1.0",
    "id": "<module name>"
}

الأساليب التشخيصية المباشرة

• GetModuleLogs: استرداد سجلات الوحدة النمطية المضمنة في استجابة الأسلوب المباشر.
• UploadModuleLogs: استرداد سجلات الوحدة النمطية وتحميلها إلى Azure Blob Storage.
• UploadSupportBundle: استرداد سجلات الوحدة النمطية باستخدام حزمة دعم وتحميل ملف مضغوط إلى Azure Blob Storage.
• GetTaskStatus: تحقق من حالة سجلات التحميل أو طلب حزمة الدعم.

تتوفر هذه الأساليب التشخيصية المباشرة اعتبارا من الإصدار 1.0.10.

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

خصائص عامل IoT Edge وتوائم وحدة مركز IoT Edge