مشاركة عبر

دليل استكشاف أخطاء Device Update for IoT Hub وإصلاحها

  • مقالة

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

عملية استيراد التحديثات

س: أواجه مشكلة في توصيل مثيل تحديث الجهاز بمثيل IoT Hub الخاص بي

يُرجى التأكد من تكوين مسارات رسائل IoT Hub بشكل صحيح، وفقًا لمستندات موارد Device Update.

قد لا يكون لديك أذونات وصول تم تكوينها بشكل صحيح. يُرجى التأكد من تكوين أذونات الوصول بشكل صحيح وفقًا لمستندات التحكم بالوصول إلى Device Update.

س: أواجه خطأ من نوع 500 عند استيراد المحتوى إلى خدمة تحديث الجهاز

من الممكن أن يشير رمز الخطأ في النطاق 500 إلى وجود مشكلة في خدمة Device Update. يُرجى الانتظار لمدة 5 دقائق، ثم المحاولة مرة أخرى. إذا استمر الخطأ نفسه، يُرجى اتباع الإرشادات الواردة في قسم التواصل مع دعم Microsoft لتقديم طلب دعم إلى Microsoft.

س: أرغب في الاحتفاظ بنفس خصائص التوافق (استهداف التحديث الخاص بي إلى نفس نوع الجهاز)، ولكن تغيير الموفر أو الاسم في بيان الاستيراد. ولكن أحصل على خطأ "فشل: خطأ في استيراد التحديث بسبب تجاوز الحد" عند القيام بذلك

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

س: أواجه رسالة خطأ عند استيراد المحتوى وأود أن أفهم المزيد عنه

يُرجى الرجوع إلى مستندات رموز أخطاء Device Update للحصول على معلومات أكثر تفصيلاً بشأن رسائل الخطأ المتعلقة بالاستيراد.

حالات فشل الجهاز

س: كيف يمكنني التأكد من أن جهازي متصل بـ Device Update for IoT Hub؟

يمكنك التحقق من أن جهازك متصل بـ Device Update عن طريق التحقق مما إذا كان يظهر ضمن قسم الأجهزة «غير المجمعة» في عرض التوافق لمدخل Microsoft Azure.

س: فشل تحديث جهاز واحد أو أكثر من أجهزتي

هناك الكثير من الأسباب الجذرية المحتملة لفشل تحديث الجهاز. يُرجى التحقق من أن: 1) الجهاز متصل بمثيل IoT Hub الخاص بك، و2) الجهاز متصل بمثيل Device Update الخاص بك، و3) خدمة تحسين التسليم (DO) قيد التشغيل. إذا كانت جميع الحالات الثلاث صحيحة لجهازك، يُرجى اتباع الإرشادات الواردة في قسم التواصل مع دعم Microsoft لتقديم طلب دعم إلى Microsoft.

س: فشل وكيل تحديث الجهاز في بدء التشغيل

أحد الأسباب الأكثر شيوعا للفشل في بدء تشغيل عامل Device Update هو ملف تكوين مشوه (du-config.json). يرجى الرجوع إلى وثائق ملف التكوين والتأكد من تكوين الوكيل الخاص بك بشكل صحيح. لاحظ أن جميع القيم في ملف التكوين يجب أن تستخدم علامات اقتباس مزدوجة.

نشر تحديث

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

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

س: تظهر حالة نشر جهازي غير متوافقة، ماذا أفعل؟

تم تغيير خصائص الشركة المُصنّعة والطراز للجهاز المستهدف بعد توصيل الجهاز بـ IoT Hub، ما تسبب في اعتبار الجهاز الآن غير متوافق مع محتوى التحديث للنشر الحالي.

تحقق من واجهة ADU الأساسية لمعرفة الشركة المُصنّعة والطراز اللذين يقدمهما جهازك إلى خدمة Device Update، وتأكد من أنهما يطابقان الشركة المُصنّعة والطراز الذي حددته في بيان الاستيراد لمحتوى التحديث الذي يتم نشره. يمكنك تغيير هذه الخصائص لجهاز معين باستخدام ملف تكوين Device Update.

س: أرى أن النشر الخاص بي في مرحلة «نشط» ولكن لا يوجد أي من أجهزتي «قيد التقدم» مع التحديث. ماذا يجب أن أفعل؟

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

س: أحاول تجميع أجهزتي، لكنني لا أرى العلامة في القائمة المنسدلة عند إنشاء مجموعة

تأكد من تكوين مسارات الرسائل بشكل صحيح في IoT Hub وفقًا لمستندات موارد Device Update. يتعين عليك وضع علامة على جهازك مرة أخرى بعد تكوين المسار.

قد يكون السبب الجذري الآخر هو أنك قمت بتطبيق العلامة قبل توصيل جهازك بـ Device Update for IoT Hub. تأكد من أن جهازك متصل بالفعل بـ Device Update. يمكنك التحقق من أن جهازك متصل بـ Device Update for IoT Hub عن طريق التحقق مما إذا كان يظهر ضمن الأجهزة «غير المجمعة» في عرض التوافق. أضف علامة بقيمة مختلفة مؤقتًا، ثم أضف العلامة المقصودة مرة أخرى بمجرد توصيل الجهاز.

إذا كنت تستخدم خدمة توفير الأجهزة (DPS)، فتأكد من وضع علامة على أجهزتك بعد توفيرها وليس في أثناء عملية إنشاء الجهاز. إذا قمت بالفعل بوضع علامة على جهازك في أثناء خطوة إنشاء الجهاز، فسيتعين عليك وضع علامة على جهازك مؤقتًا بقيمة مختلفة بعد توفيره، ثم إضافة العلامة المقصودة مرة أخرى.

س: اكتمل النشر بنجاح، ولكن فشل تحديث بعض الأجهزة

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

س: واجهت خطأ في تجربة المستخدم عند محاولة بدء نشر

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

س: لقد بدأت التوزيع ولكنه لا يصل إلى حالة النهاية

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

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

قد يكون هذا قد حدث إذا لم تقم بإزالة العامل الأقدم الذي كان يتصل عبر Device Twin. عندما تقوم بتوفير عامل Device Update كوحدة نمطية (انظر كيفية القيام بذلك)، تحدث جميع الاتصالات بين الجهاز وخدمة Device Update عبر Module Twin، لذلك تذكر وضع علامة على Module Twin للجهاز عند إنشاء المجموعات ويجب أن تحدث جميع الاتصالات عبر توأم الوحدة النمطية.

تنزيل التحديثات على الأجهزة

س: كيف يمكنني استئناف التنزيل عند إعادة توصيل الجهاز بعد فترة من انقطاع الاتصال؟

يتم استئناف التنزيل ذاتيًا عند استعادة الاتصال خلال فترة 24 ساعة. بعد 24 ساعة، يحتاج المستخدم إلى إعادة بدء التنزيل.

استخدام ذاكرة التخزين المؤقت المتصلة من Microsoft (‏MCC)

س: أواجه مشكلة عند محاولة نشر وحدة MCC على جهاز IoT Edge الخاص بي

راجع مستندات IoT Edge لنشر وحدات Edge إلى أجهزة IoT Edge. يمكنك التحقق مما إذا كانت وحدة MCC تعمل بنجاح على جهاز IoT Edge عن طريق الانتقال إلى http://localhost:5100/Summary.

س: يحاول أحد أجهزة IoT الخاصة بي تنزيل تحديث من خلال MCC، ولكنه يفشل

هناك العديد من المشكلات التي قد تتسبب في فشل جهاز IoT في الاتصال بـ MCC. لتشخيص المشكلة، يُرجى جمع سجلات عميل DO وNginx من الجهاز الذي يفشل (انظر قسم التواصل مع دعم Microsoft للحصول على إرشادات حول جمع سجلات العميل).

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

استكشاف أخطاء مثيل مفقود وإصلاحها في مدخل Microsoft Azure

س: لا أرى مثيل تحديث الجهاز ل IoT Hub عند تحديد أيقونة "الترس"

هناك بعض الأسباب المحتملة لهذه المشكلة. انظر أدناه للاطلاع على خطوات استكشاف الأخطاء وإصلاحها.

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

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

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

  • لإدارة الأذونات لمركز IoT الخاص بك:
    • حدد المركز الخاص بك من مدخل Microsoft Azure
    • حدد "التحكم بالوصول (IAM) من شريط التنقل الأيسر.
    • حدد "إضافة تعيين دور".
    • حدد دورا مع حق الوصول للقراءة على الأقل وحدد التالي.
    • بجوار "Members"، حدد "+Select members".
    • أضف حسابك في القائمة المنبثقة اليمنى، وحدد الزر "Select".
    • حدد "Review + assign".
  • لإدارة أذونات تحديث الجهاز لحساب IoT Hub، اطلب من مالك الحساب اتخاذ الخطوات التالية:
    • حدد حساب تحديث الجهاز من مدخل Microsoft Azure.
    • حدد "التحكم بالوصول (IAM) من شريط التنقل الأيسر.
    • حدد "إضافة تعيين دور".
    • حدد دور القارئ (أو دور له أذونات مكافئة).
    • بجوار "Members"، حدد "+Select members".
    • أضف حسابك في القائمة المنبثقة اليمنى، وحدد الزر "Select".
    • حدد "Review + assign".

تعرف على المزيد حول التحكم في الوصول المستند إلى الدور لخدمة Device Update.

التواصل مع دعم Microsoft

إذا واجهت مشكلات لا يمكن حلها باستخدام الأسئلة المتداولة أعلاه، يمكنك تقديم طلب دعم إلى دعم Microsoft باستخدام واجهة مدخل Microsoft Azure. بناءً على الفئة التي تشير إلى أن المشكلة تنتمي إليها، قد يُطلب منك جمع بيانات إضافية ومشاركتها لمساعدة دعم Microsoft في التحقيق في المشكلة.

يُرجى الاطلاع على ما يرد أدناه للحصول على إرشادات حول كيفية جمع كل نوع بيانات.

يمكنك استخدام getDevice للتحقق من وجود معلومات إضافية في استجابة الحمولة لواجهة برمجة التطبيقات.

بالإضافة إلى ذلك، يمكن أن تكون المعلومات التالية مفيدة لتضييق السبب الجذري فيما يتعلق بمشكلتك:

  • ما نوع الجهاز الذي تحاول تحديثه (بوابة IoT Edge، وغيرها)
  • ما نوع عميل Device Update الذي تستخدمه (مستند إلى الصورة، مستند إلى الحزمة، المحاكي)
  • ما نظام التشغيل الذي يعمل به جهازك
  • التفاصيل المتعلقة ببنية جهازك
  • ما إذا كنت قد استخدمت Device Update بنجاح من أجل تحديث جهاز من قبل

إذا توفرت لديك أي من المعلومات المذكورة أعلاه، يُرجى تضمينها في وصفك للمشكلة.

جمع سجلات العميل

  • توجد مجموعتان من السجلات على جهاز Raspberry Pi هنا:

    /adu/logs

    /var/cache/do-client-lite/log

  • فيما يتعلق بالعميل الذب تم حزمه، يتم العثور على السجلات هنا:

    /var/log/adu

    /var/cache/do-client-lite/log

  • بالنسبة إلى المحاكي، يتم العثور على السجلات هنا:

    /tmp/aduc-logs

رموز الخطأ

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

يمكن الحصول على رموز الخطأ من خلال البحث في واجهة ADUCoreInterface. يُرجى الرجوع إلى مستندات رموز خطأ Device Update للحصول على معلومات حول كيفية تحليل رموز الأخطاء للتشخيص الذاتي واستكشاف الأخطاء وإصلاحها.

معرّف التتبع

قد يُطلب منك توفير معرّف تتبع عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو نشره.

يمكن العثور على معرّف التتبع لإجراء مستخدم معين ضمن استجابة واجهة برمجة التطبيقات، أو في قسم محفوظات الاستيراد من واجهة مستخدم مدخل Microsoft Azure.

حاليًا، يمكن الوصول إلى معرّفات التتبع لإجراءات النشر فقط من خلال استجابة واجهة برمجة التطبيقات.

معرف التوزيع

قد يُطلب منك توفير معرّف النشر عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.

يتم إنشاء معرّف النشر بواسطة المستخدم عند استدعاء واجهة برمجة التطبيقات لبدء النشر.

حاليًا، يتم إنشاء معرّفات النشر لعمليات النشر التي بدأت من واجهة مستخدم مدخل Microsoft Azure تلقائيًا ولا تظهر للمستخدم.

اسم مثيل IoT Hub

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

يتم اختيار اسم IoT Hub من قِبل المستخدم عند توفيره للمرة الأولى.

اسم حساب Device Update

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

يتم اختيار اسم حساب Device Update من قِبل المستخدم عند تسجيل الاشتراك لأول مرة في الخدمة. يمكن العثور على مزيد من المعلومات في مستندات موارد Device Update.

اسم مثيل Device Update

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

يتم اختيار اسم مثيل Device Update من قِبل المستخدم عند توفيره لأول مرة. يمكن العثور على مزيد من المعلومات في مستندات موارد Device Update.

معرف الجهاز

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

يتم تعريف معرّف الجهاز من قِبل العميل عند توفير الجهاز لأول مرة. يمكن أيضًا استرداده باستخدام Device Twin للجهاز.

معرّف التحديث

قد يُطلب منك توفير معرّف تحديث عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.

يتم تعريف معرّف التحديث من قِبل العميل عند بدء النشر.

سجلات Nginx

قد يُطلب منك توفير سجلات Nginx عند الإبلاغ عن مشكلة تتعلق بذاكرة التخزين المؤقت المتصلة من Microsoft.

ADU-conf.txt

قد يُطلب منك توفير ملف تكوين Device Update‏ («adu-conf.txt») عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.

ملف التكوين اختياري ويتم إنشاؤه من قِبل المستخدم باتباع الإرشادات الواردة في مستندات تكوين Device Update.

بيان الاستيراد

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

بيان الاستيراد هو ملف يتم إنشاؤه من قِبل العميل عند استيراد محتوى التحديث إلى خدمة Device Update.

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

تعرف على المزيد حول رموز خطأ تحديث الجهاز