دليل استكشاف الأخطاء وإصلاحها في تحديث الجهاز ل IoT Hub
يسرد هذا المستند بعض الأسئلة والمشكلات الشائعة التي أبلغ عنها مستخدمو "تحديث الجهاز". مع تقدم "تحديث الجهاز" من خلال "المعاينة العامة"، سيتم تحديث دليل استكشاف الأخطاء وإصلاحها هذا بشكل دوري بأسئلة وحلول جديدة. إذا واجهت مشكلة لا تظهر في دليل استكشاف الأخطاء وإصلاحها هذا، فراجع قسم الاتصال بدعم Microsoft لتوثيق الموقف لديك.
استيراد التحديثات
س: أواجه مشكلة في توصيل مثيل "تحديث الجهاز" بمثيل IoT Hub الخاص بي.
يرجى التأكد من تكوين مسارات رسائل IoT Hub بشكل صحيح، وفقا لوثائق موارد تحديث الجهاز .
س: أواجه خطأ متعلقا بالدور (رسالة خطأ في مدخل Azure أو خطأ في واجهة برمجة التطبيقات 403).
قد لا يكون لديك أذونات الوصول التي تم تكوينها بشكل صحيح. يرجى التأكد من تكوين أذونات الوصول بشكل صحيح وفقا لوثائق التحكم في الوصول إلى Device Update .
س: أواجه خطأ من النوع 500 عند استيراد محتوى إلى خدمة "تحديث الجهاز".
قد يشير رمز خطأ في النطاق 500 إلى وجود مشكلة في خدمة "تحديث الجهاز". يرجى الانتظار لمدة 5 دقائق، ثم المحاولة مرة أخرى. إذا استمر الخطأ نفسه، فيرجى اتباع الإرشادات الواردة في قسم الاتصال بدعم Microsoft لتقديم طلب دعم إلى Microsoft.
س: أواجه رسالة خطأ عند استيراد المحتوى وأرغب في فهم المزيد عنه.
الرجاء الرجوع إلى وثائق رموز أخطاء تحديث الجهاز للحصول على معلومات أكثر تفصيلا حول رسائل الخطأ المتعلقة بالاستيراد.
فشل الجهاز
س: كيف يمكنني التأكد من توصيل جهازي بتحديث الجهاز لمركز إنترنت الأشياء؟
يمكنك التحقق من أن جهازك متصل ب "تحديث الجهاز" من خلال التحقق مما إذا كان يظهر ضمن قسم "الأجهزة غير المجمعة" في طريقة عرض التوافق الخاصة بمدخل Azure.
س: فشل تحديث جهاز واحد أو أكثر من أجهزتي.
هناك العديد من الأسباب الجذرية المحتملة لفشل تحديث الجهاز. يرجى التحقق من أن الجهاز هو: 1) متصل بمثيل IoT Hub الخاص بك، 2) متصل بمثيل تحديث الجهاز الخاص بك، و 3) خدمة تحسين التسليم (DO) قيد التشغيل. إذا كانت الثلاثة صحيحة بالنسبة لجهازك، فيرجى اتباع الإرشادات الواردة في قسم الاتصال بدعم Microsoft لتقديم طلب دعم إلى Microsoft.
نشر تحديث
س: لقد قمت بنشر تحديث على جهازي (أجهزتي)، ولكن حالة التوافق تشير إلى أنه ليس مدرجا في آخر تحديث. ماذا يجب أن أفعل؟
قد تستغرق حالة توافق الجهاز ما يصل إلى 5 دقائق للتحديث. يرجى الانتظار ، ثم التحقق مرة أخرى.
س: تظهر حالة نشر جهازي غير متوافقة، فماذا أفعل؟
ربما تم تغيير خصائص الشركة المصنعة والطراز للجهاز المستهدف بعد توصيل الجهاز ب IoT Hub، مما تسبب في اعتبار الجهاز الآن غير متوافق مع محتوى التحديث الخاص بالنشر الحالي.
تحقق من الواجهة الأساسية لوحدة أبوظبي لمعرفة الشركة المصنعة والطراز الذي يقوم جهازك بالإبلاغ عنه إلى خدمة "تحديث الجهاز"، وتأكد من مطابقته للشركة المصنعة والطراز الذي حددته في بيان الاستيراد لمحتوى التحديث الذي يتم نشره. يمكنك تغيير هذه الخصائص لجهاز معين باستخدام ملف تكوين تحديث الجهاز.
س: أرى أن عملية النشر الخاصة بي في مرحلة "نشطة" ولكن لا يوجد أي من أجهزتي "قيد التقدم" مع التحديث. ماذا يجب أن أفعل؟
تأكد من عدم تعيين تاريخ بدء النشر في المستقبل. عند إنشاء نشر جديد، يتم تعيين تاريخ بدء النشر افتراضيا إلى اليوم التالي كإجراء حماية ما لم تقم بتغييره صراحة. يمكنك إما الانتظار حتى وصول تاريخ بدء النشر، أو إلغاء النشر المستمر وإنشاء نشر جديد بتاريخ البدء المطلوب.
س: أحاول تجميع أجهزتي، ولكنني لا أرى العلامة في القائمة المنسدلة عند إنشاء مجموعة.
تأكد من تكوين مسارات الرسائل بشكل صحيح في IoT Hub وفقا لوثائق موارد تحديث الجهاز . سيتعين عليك وضع علامة على جهازك مرة أخرى بعد تكوين المسار.
قد يكون السبب الجذري الآخر هو أنك قمت بتطبيق العلامة قبل توصيل جهازك بتحديث الجهاز ل IoT Hub. تأكد من أن جهازك متصل بالفعل ب "تحديث الجهاز". يمكنك التحقق من أن جهازك متصل ب "تحديث الجهاز لمركز إنترنت الأشياء" من خلال التحقق مما إذا كان يظهر ضمن الأجهزة "غير المجمعة" في طريقة عرض الامتثال. أضف علامة بقيمة مختلفة مؤقتا، ثم أضف العلامة المقصودة مرة أخرى بمجرد توصيل الجهاز.
إذا كنت تستخدم خدمة توفير الأجهزة (DPS)، فتأكد من وضع علامة على أجهزتك بعد توفيرها وليس أثناء عملية إنشاء الجهاز. إذا كنت قد وضعت علامة على جهازك بالفعل أثناء خطوة إنشاء الجهاز، فسيتعين عليك وضع علامة على جهازك مؤقتا بقيمة مختلفة بعد توفيره، ثم إضافة العلامة المقصودة مرة أخرى.
س: اكتمل النشر بنجاح، ولكن فشل تحديث بعض الأجهزة.
قد يكون سبب ذلك خطأ من جانب العميل على الأجهزة الفاشلة. يرجى الاطلاع على قسم فشل الجهاز في دليل استكشاف الأخطاء وإصلاحها هذا.
س: واجهت خطأ في تجربة المستخدم عند محاولة بدء عملية نشر.
قد يكون سبب ذلك خطأ في الخدمة / تجربة المستخدم ، أو بسبب مشكلة في أذونات واجهة برمجة التطبيقات. الرجاء اتباع الإرشادات الواردة في قسم الاتصال بدعم Microsoft لتقديم طلب دعم إلى Microsoft.
س: لقد بدأت عملية نشر ولكنها لم تصل إلى حالة نهائية.
قد يكون سبب ذلك مشكلة في أداء الخدمة أو خطأ في الخدمة أو خطأ في العميل. يرجى إعادة محاولة النشر بعد 10 دقائق. إذا واجهت نفس المشكلة، فيرجى سحب سجلات جهازك والرجوع إلى قسم فشل الجهاز في دليل استكشاف الأخطاء وإصلاحها هذا. إذا استمرت المشكلة نفسها، فيرجى اتباع الإرشادات الواردة في قسم الاتصال بدعم Microsoft لتقديم طلب دعم إلى Microsoft.
س: لقد انتقلت من وكيل على مستوى الجهاز إلى إضافة الوكيل كهوية وحدة نمطية على الجهاز، ويظهر التحديث الخاص بي على أنه "قيد التقدم" على الرغم من أنه تم تطبيقه على الجهاز.
قد يكون سبب _This إذا لم تقم بإزالة العامل القديم الذي كان يتصل عبر Device Twin. عند توفير عامل تحديث الجهاز كوحدة نمطية (راجع كيفية) تحدث جميع الاتصالات بين الجهاز وخدمة تحديث الجهاز عبر توأم الوحدة النمطية ، لذا تذكر وضع علامة على توأم الوحدة النمطية للجهاز عند إنشاء مجموعات ويجب أن تحدث جميع الاتصالات عبر توأم الوحدة.
تنزيل التحديثات على الأجهزة
س: كيف أعمل استئناف التنزيل عند إعادة اتصال الجهاز بعد فترة من قطع الاتصال؟
سيتم استئناف التنزيل ذاتيا عند استعادة الاتصال خلال فترة 24 ساعة. بعد 24 ساعة ، سيحتاج المستخدم إلى إعادة تشغيل التنزيل.
استخدام ذاكرة التخزين المؤقت المتصلة من Microsoft (MCC)
س: أواجه مشكلة عند محاولة نشر وحدة MCC على جهاز IoT Edge الخاص بي.
ارجع إلى وثائق IoT Edge لنشر وحدات Edge النمطية على أجهزة IoT Edge. يمكنك التحقق مما إذا كانت وحدة MCC تعمل بنجاح على جهاز IoT Edge الخاص بك من خلال الانتقال إلى http://localhost:5100/Summary.
س: يحاول أحد أجهزة إنترنت الأشياء تنزيل تحديث من خلال مركز عملائي، ولكنه يفشل.
هناك العديد من المشكلات التي قد تتسبب في فشل جهاز إنترنت الأشياء في الاتصال بمركز عملائي. لتشخيص المشكلة، يرجى جمع سجلات عميل DO وسجلات Nginx من الجهاز المعطل (راجع قسم الاتصال بدعم Microsoft للحصول على إرشادات حول جمع سجلات العميل).
قد يفشل جهازك في سحب المحتوى من الإنترنت لتمريره إلى وحدة مركز عملائي لأن عنوان URL الذي يستخدمه غير مسموح به. لتحديد ما إذا كان الأمر كذلك، ستحتاج إلى التحقق من متغيرات بيئة IoT Edge في مدخل Azure.
الاتصال بدعم Microsoft
إذا واجهت مشكلات لا يمكن حلها باستخدام الأسئلة المتداولة أعلاه، فيمكنك تقديم طلب دعم إلى دعم Microsoft من خلال واجهة مدخل Azure. استنادا إلى الفئة التي تشير إلى أن مشكلتك تنتمي إليها، قد يطلب منك جمع بيانات إضافية ومشاركتها لمساعدة دعم Microsoft في التحقيق في مشكلتك.
يرجى الاطلاع أدناه للحصول على إرشادات حول كيفية جمع كل نوع من أنواع البيانات. يمكنك استخدام getDevices للتحقق من وجود معلومات إضافية في استجابة الحمولة الصافية لواجهة برمجة التطبيقات.
بالإضافة إلى ذلك، يمكن أن تكون المعلومات التالية مفيدة لتضييق نطاق السبب الجذري لمشكلتك:
- نوع الجهاز الذي تحاول تحديثه (Azure Percept، IoT Edge Gateway، غير ذلك)
- نوع عميل "تحديث الجهاز" الذي تستخدمه (مستند إلى صورة، مستند إلى الحزمة، محاكي)
- نظام التشغيل الذي يعمل به جهازك
- التفاصيل المتعلقة ببنية جهازك
- ما إذا كنت قد استخدمت "تحديث الجهاز" بنجاح لتحديث جهاز من قبل
إذا كان لديك أي من المعلومات المذكورة أعلاه المتاحة، يرجى تضمينها في وصفك للمشكلة.
جمع سجلات العملاء
يوجد على جهاز Raspberry Pi مجموعتان من السجلات الموجودة هنا:
/adu/logs/var/cache/do-client-lite/logبالنسبة للعميل المعبأ ، يتم العثور على السجلات هنا:
/var/log/adu/var/cache/do-client-lite/logبالنسبة إلى جهاز المحاكاة، توجد السجلات هنا:
/tmp/aduc-logs
رموز الخطأ
قد يطلب منك تقديم رموز خطأ عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو فشل جهاز أو نشر تحديث.
يمكن الحصول على رموز الخطأ من خلال النظر إلى واجهة ADUCoreInterface . يرجى الرجوع إلى وثائق رموز خطأ تحديث الجهاز للحصول على معلومات حول كيفية تحليل رموز الخطأ للتشخيص الذاتي واستكشاف الأخطاء وإصلاحها.
معرف التتبع
قد يطلب منك تقديم معرف تتبع عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو نشره.
يمكن العثور على معرف التتبع لإجراء مستخدم معين ضمن استجابة واجهة برمجة التطبيقات، أو في قسم محفوظات الاستيراد في واجهة مستخدم مدخل Azure.
حاليا، لا يمكن الوصول إلى معرفات التتبع لإجراءات النشر إلا من خلال استجابة واجهة برمجة التطبيقات.
معرف التوزيع
قد يطلب منك تقديم معرف نشر عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.
يتم إنشاء معرف النشر بواسطة المستخدم عند استدعاء واجهة برمجة التطبيقات لبدء عملية نشر.
حاليا، يتم إنشاء معرفات النشر لعمليات النشر التي بدأت من واجهة مستخدم مدخل Azure تلقائيا ولا تظهر للمستخدم.
اسم مثيل IoT Hub
قد يطلب منك تقديم اسم مثيل IoT Hub عند الإبلاغ عن مشكلة تتعلق بفشل الجهاز أو نشر تحديث.
يتم اختيار اسم IoT Hub بواسطة المستخدم عند توفيره لأول مرة.
اسم حساب تحديث الجهاز
قد يطلب منك تقديم اسم حسابك في "تحديث الجهاز" عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو فشل الجهاز أو نشر تحديث.
يتم اختيار اسم حساب Device Update من قبل المستخدم عند الاشتراك لأول مرة في الخدمة. يمكن العثور على مزيد من المعلومات في وثائق موارد تحديث الجهاز .
اسم مثيل تحديث الجهاز
قد يطلب منك تقديم اسم مثيل "تحديث الجهاز" عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو فشل الجهاز أو نشر تحديث.
يتم اختيار اسم مثيل "تحديث الجهاز" بواسطة المستخدم عند توفيره لأول مرة. يمكن العثور على مزيد من المعلومات في وثائق موارد تحديث الجهاز .
معرف الجهاز
قد يطلب منك تقديم معرف جهاز عند الإبلاغ عن مشكلة تتعلق بفشل الجهاز أو نشر تحديث.
يتم تعريف معرف الجهاز من قبل العميل عند توفير الجهاز لأول مرة. يمكن أيضا استرداده من Device Twin.
تحديث المعرف
قد يطلب منك تقديم معرف تحديث عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.
يتم تعريف معرف التحديث بواسطة العميل عند بدء عملية نشر.
سجلات Nginx
قد يطلب منك تقديم سجلات Nginx عند الإبلاغ عن مشكلة تتعلق بذاكرة التخزين المؤقت المتصلة ل Microsoft.
ADU-conf.txt
قد يطلب منك تقديم ملف تكوين "تحديث الجهاز" ("adu-conf.txt") عند الإبلاغ عن مشكلة تتعلق بنشر تحديث.
ملف التكوين اختياري ويتم إنشاؤه بواسطة المستخدم باتباع الإرشادات الواردة في وثائق تكوين تحديث الجهاز .
استيراد بيان
قد يطلب منك تقديم ملف بيان الاستيراد عند الإبلاغ عن مشكلة تتعلق باستيراد تحديث أو نشره.
بيان الاستيراد هو ملف تم إنشاؤه بواسطة العميل عند استيراد محتوى التحديث إلى خدمة "تحديث الجهاز".