جمع سجلات التشخيص عن بُعد من الأجهزة التي تستخدم Device Update لـ IoT Hub

تعرف على كيفية بدء تحديث الجهاز لعملية سجل IoT Hub وعرض السجلات المجمعة داخل موقع تخزين Azure Blob.

المتطلبات الأساسية

• الوصول إلى IoT Hub مع تمكين Device Update لـ IoT Hub.
• جهاز IoT (أو جهاز محاكاة) تم توفيره لتحديث الجهاز داخل IoT Hub وتنفيذ واجهة التشخيص.
• حساب موقع تخزين Azure Blob ضمن نفس الاشتراك مثل تحديث الجهاز لحساب IoT Hub.

إشعار

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

مدخل Microsoft Azure

المستعرضات المدعومة:

• Microsoft Edge
• Google Chrome

Azure CLI

بيئة Azure CLI:

• استخدم بيئة Bash في Azure Cloud Shell.

  

• أو، إذا كنت تفضل تشغيل أوامر مرجع CLI محليًا قم بتثبيت CLI Azure

  • قم بتسجيل الدخول إلى CLI Azure باستخدام az login.
  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.
  • عند المطالبة، قم بتثبيت ملحقات Azure CLI عند الاستخدام لأول مرة. تستخدم الأوامر الواردة في هذه المقالة ملحق azure-iot. قم بتشغيل az extension update --name azure-iot للتأكد من أنك تستخدم أحدث إصدار من الملحق.

تلميح

تستخدم أوامر Azure CLI في هذه المقالة حرف خط مائل \ عكسي لمتابعة السطر بحيث تكون وسيطات الأمر أسهل في القراءة. يعمل بناء الجملة هذا في بيئات Bash. إذا كنت تقوم بتشغيل هذه الأوامر في PowerShell، فاستبدل كل مائل عكسي بخلفية ''، أو قم بإزالتها بالكامل.

اربط حساب موقع تخزين Azure Blob بمثيل تحديث جهازك

لاستخدام ميزة تجميع السجل عن بُعد، يجب أولاً ربط حساب موقع تخزين Azure Blob بمثيل تحديث الجهاز. حساب موقع تخزين Azure Blob هذا هو المكان الذي ستقوم أجهزتك بتحميل سجلات التشخيص إليه.

مدخل Microsoft Azure

1. في مدخل Microsoft Azure، انتقل إلى تحديث الجهاز لحساب مركز IoT.

2. حدد مثيلات ضمن قسم إدارة المثيل في جزء التنقل.

3. حدد مثيل تحديث الجهاز الخاص بك من القائمة، ثم كوّن التشخيصات.

4. حدد علامة التبويب تشخيصات العميل، ثم حدد حساب تخزين Azure.

5. اختر حساب التخزين المطلوب من القائمة وحدد حفظ.

6. بمجرد العودة إلى قائمة المثيلات، حدد تحديث دوريا حتى تظهر حالة توفير المثيل «نجحت». تستغرق هذه العملية عادة 2-3 دقائق.

Azure CLI

استخدم الأمر az iot du instance create لتكوين التشخيصات لمثيل Device Update.

تلميح

يمكنك استخدام الأمر على az iot du instance create مثيلات تحديث الجهاز الموجودة وسيقوم بتكوين المثيل مع المعلمات المحدثة.

استبدل العناصر نائبة التالية بمعلوماتك الخاصة:

• <account_name>: اسم حساب تحديث الجهاز.
• <instance_name>: اسم مثيل تحديث الجهاز.
• <storage_id>: معرف المورد لحساب التخزين حيث سيتم تخزين سجلات التشخيص. يمكنك استرداد معرف المورد باستخدام الأمر az storage show والاستعلام عن قيمة المعرف: az storage account show -n <storage_name> --query id.

az iot du instance update --account <account_name> --instance <instance_name> --set enableDiagnostics=true diagnosticStorageProperties.resourceId=<storage_id>

تكوين مجموعة سجل

يشير عامل تحديث الجهاز إلى ملف تكوين على الجهاز، موجود في /etc/adu/du-diagnostics-config.json في العامل المرجعي.

مسارات ملفات مجموعة السجلات

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

داخل ملف التكوين، يتم تمثيل كل ملف سجل يتم تجميعه وتحميله كعنصرlogComponent مع خصائص componentName وlogPath. يمكن تعديل هذا التكوين كما هو مطلوب.

الحد الأقصى لحجم ملف السجل

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

سيتم تطبيق المعلمة ذات الصلة "maxKilobytesToUploadPerLogPath" على كل عنصر logComponent، ويمكن تعديلها حسب الرغبة.

إنشاء عملية السجل

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

مدخل Microsoft Azure

1. انتقل إلى IoT Hub وحدد علامة التبويب Updates ضمن قسم Device Management في جزء التنقل.

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

3. حدد Add log upload operation للانتقال إلى صفحة إنشاء عملية السجل.

4. أدخل اسماً (معرّفاً) ووصفاً لعملية السجل الجديدة، ثم حدد Add devices لتحديد أجهزة إنترنت الأشياء التي تريد تجميع سجلات التشخيص منها.

5. حدد إضافة.

6. بمجرد العودة إلى علامة التبويب "التشخيص"، حدد Refresh حتى ترى عملية السجل مدرجة في جدول العمليات.

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

8. في تفاصيل عملية السجل، يمكنك عرض الحالة الخاصة بالجهاز ومشاهدة مسار موقع السجل. يتوافق هذا المسار مع مسار الدليل الظاهري داخل حساب موقع تخزين Azure Blob حيث تم تحميل سجلات التشخيص.

Azure CLI

استخدم الأمر az iot du device log collect لتكوين عملية تجميع سجل التشخيص.

device log collect يأخذ الأمر الوسيطات التالية:

• --account: اسم حساب تحديث الجهاز.
• --instance: اسم مثيل تحديث الجهاز.
• --log-collection-id: اسم لعملية مجموعة السجل.
• --agent-id: أزواج المفاتيح =القيمة التي تحدد عامل تحديث الجهاز الهدف لعملية جمع السجل هذه. استخدم deviceId=<device name> إذا كان العامل لديه هوية جهاز. استخدم deviceId=<device name> moduleId=<module name> إذا كان العامل لديه هوية وحدة نمطية. يمكنك استخدام المعلمة --agent-id عدة مرات لاستهداف أجهزة متعددة.

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

az iot du device log collect \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name} \
    --agent-id deviceId=<device name> \
    --agent-id deviceId=<device name> moduleId=<module name>

استخدم az iot du device log show لعرض تفاصيل عملية مجموعة سجل تشخيص معينة.

az iot du device log show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --log-collection-id <log collection name>

عرض وتصدير سجلات التشخيص المجمعة

1. بمجرد نجاح عملية السجل، انتقل إلى حساب موقع تخزين Azure Blob.

2. حدد Containers ضمن قسم Data storage في جزء التنقل.

3. حدد الحاوية التي تحمل نفس اسم مثيل تحديث الجهاز الخاص بك.

4. استخدم مسار موقع السجل من تفاصيل عملية السجل للانتقال إلى الدليل الصحيح الذي يحتوي على السجلات. بشكل افتراضي، توجه ميزة جمع السجل عن بُعد الأجهزة المستهدفة إلى تحميل سجلات التشخيص باستخدام نموذج مسار الدليل التالي: حاوية تخزين Blob / معرف الجهاز الهدف/معرف عملية السجل/مسار السجل على الجهاز

5. إذا لم تقم بتعديل المكون التشخيصي لعامل Device Update، فسيستجيب الجهاز لأي عملية سجل عن طريق محاولة تحميل ملفي سجل نص عادي: سجل تشخيص عامل تحديث الجهاز ("aduc.log")، وسجل تشخيص عامل DO ("do-agent.log"). يمكنك معرفة المزيد حول ملفات السجل التي يجمعها عامل مرجع تحديث الجهاز من خلال قراءة صفحة مفهوم تشخيص تحديث الجهاز.

6. يمكنك عرض محتويات ملف السجل عن طريق تحديد اسم الملف، ثم تحديد عنصر القائمة (علامة القطع) والنقر على عرض/تعديل. يمكنك أيضاً تنزيل ملف السجل أو حذفه عن طريق تحديد الخيارات المصنفة على التوالي.

   

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

لمعرفة المزيد حول قدرات تشخيص تحديث الجهاز، راجع نظرة عامة على ميزة تشخيص تحديث الجهاز