تسجّل خدمة Watchdog الأصلية بيانات أداء الإدخال/الإخراج منذ مرحلة early-init أثناء بدء تشغيل النظام. تتخلص الخدمة الأصلية من بيانات الأداء التي تم جمعها في تقرير الأخطاء. يمكن للمورّدين طلب البحث من الخدمة الأصلية عبر dumpsys إما لتفريغ البيانات التي تم جمعها أو لبدء جلسة جمع مخصّصة لتصحيح الأخطاء.
معدّل تكرار جمع البيانات
يختلف معدّل تكرار جمع بيانات الأداء حسب نوع الإصدار.
- في إصدارات userdebug أو eng، يجمع Watchdog بيانات الأداء مرة واحدة كل ثانية واحدة أثناء بدء تشغيل النظام، ومرة واحدة كل دقيقة واحدة بعد اكتمال عملية بدء التشغيل.
- في إصدارات المستخدمين، يجمع Watchdog بيانات الأداء مرة واحدة كل 20 ثانية أثناء بدء تشغيل النظام ومرة واحدة كل دقيقتَين (2) بعد اكتمال عملية بدء التشغيل.
أحداث جمع البيانات
يتم إجراء إنشاء الملفات الشخصية المستندة إلى العيّنات أثناء أحداث النظام المختلفة (مثل بدء تشغيل النظام، وتنشيط النظام، وتبديل المستخدم) وخلال آخر "ن" دقيقة.
- آخر N دقيقة من الأحداث قبل إنشاء تقرير الخطأ: يتم إنشاؤها خلال فترة زمنية متواصلة مدتها 30 دقيقة.
- أحداث وقت التشغيل: يتم إنشاؤها بعد بدء التشغيل.
- أحداث تبديل المستخدم: يتم إنشاؤها بعد بدء عملية تبديل المستخدم.
- أحداث التجميع المخصّصة: يمكن تحديد فترة الاقتراع والمدة القصوى، ويمكن الفلترة حسب الحِزم.
تفريغ بيانات الأداء
عند تسجيل تقرير أخطاء، تعمل خدمة Watchdog الأصلية على تفريغ بيانات الأداء التي تم جمعها في تقرير الأخطاء. يمكن للمورّدين طلب البحث من الخدمة الأصلية باستخدام الأمر dumpsys أدناه لعرض بيانات الأداء التي تم جمعها. يمكنك الاطّلاع على قسم التعرّف على تقرير بيانات الأداء لمعرفة تفاصيل حول التقرير.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt
جمع بيانات الأداء لتصحيح الأخطاء
يمكن للمورّدين استخدام خدمة Watchdog الأصلية لجمع بيانات الأداء بشكل مخصّص لأغراض تصحيح الأخطاء. على سبيل المثال، لفهم استخدام عمليات الإدخال/الإخراج في تطبيق أو خدمة، يمكن للمورّدين تنفيذ عملية جمع مخصّصة لبيانات الأداء، وتحديد استخدام عمليات الإدخال/الإخراج إما لقائمة محدّدة من الحِزم أو للنظام بأكمله.
بدء جلسة مجموعة مخصّصة
في ما يلي الأمر لبدء جلسة مخصّصة لجمع بيانات الأداء:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf [--interval <seconds>] [--max_duration <seconds>] [--filter_packages <package_name>,<package_name>,...]
--start_perf
تبدأ هذه السمة جلسة مخصّصة لجمع بيانات الأداء.--interval <seconds>
تحدّد هذه السمة الفاصل الزمني لإنشاء الملفات الشخصية. الفاصل الزمني التلقائي هو 30 ثانية.--max_duration <seconds>
تحدّد هذه السمة الحد الأقصى لمدة جلسة جمع بيانات الأداء المخصّصة. إذا لم يتم إيقاف الجلسة يدويًا، سيتم إيقافها وتجاهل البيانات التي تم جمعها بعد هذه المدة. تبلغ المدة القصوى تلقائيًا 30 دقيقة.--filter_packages <package_name>,<package_name>...
تحدّد هذه السمة قائمة بأسماء الحِزم مفصولة بفواصل لتحديد الملف الشخصي. عند توفيرها، يقتصر جمع بيانات الأداء على هذه الحِزم. بخلاف ذلك، يتم جمع بيانات الأداء لجميع الحِزم في النظام.
على سبيل المثال، يبدأ الأمر أدناه عملية جمع مخصّصة لبيانات الأداء
بفاصل زمني للتسجيل يبلغ 10 ثوانٍ، وبحد أقصى لمدة التسجيل
يبلغ ساعة واحدة، ويقتصر التسجيل على الحزمتين
com.google.android.car.kitchensink
وcom.google.android.apps.maps
.
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --start_perf --interval 10 --max_duration 3600 --filter_packages com.google.android.car.kitchensink,com.google.android.apps.maps
إيقاف جلسة المجموعة المخصّصة وإلغاؤها
بعد تسجيل استخدام الإدخال/الإخراج لتطبيق أو خدمة معيّنة، على المورّدين إيقاف جلسة جمع بيانات الأداء المخصّصة لتفريغ البيانات التي تم جمعها. يوقف هذا الأمر عملية جمع بيانات الأداء المخصّصة، ويُفرغ البيانات التي تم جمعها في /tmp/carwatchdog_dump.txt
:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --stop-perf > /tmp/carwatchdog_custom_dump.txt
مساعدة بشأن Dumpsys
للحصول على مساعدة بشأن أداة dumpsys، اتّبِع الخطوات التالية:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --help
تفريغ إلى تنسيق proto
يمكنك اختياريًا تفريغ بيانات dumpsys بتنسيق proto:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --proto
التعرّف على تقرير بيانات الأداء
لمزيد من المعلومات، اطّلِع على نموذج تقرير بيانات الأداء التالي:
adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default --------------------------------- WatchdogPerfService report: --------------------------------- Boot-time collection information: ================================= Event polling interval: 1 second Wake-up collection information: =============================== Event polling interval: 1 second User-switch collection information: =================================== Event polling interval: 1 second Periodic collection information: ================================ Event polling interval: 60 seconds --------------------------------------------------------------------------- Boot-time performance report: ================================= No collection recorded --------------------------------------------------------------------------- Wake-up performance report: =========================== No collection recorded --------------------------------------------------------------------------- User-switch events performance report: ====================================== No collection recorded --------------------------------------------------------------------------- Last N minutes performance report: ====================================== Collection duration: 10800 seconds Number of collections: 181 Collection 0: <Mon Oct 2 18:36:06 2023 GMT> ============================================= Total CPU time (ms): 473210 Total CPU cycles: 39553152000 Total idle CPU time (ms)/percent: 435860 / 92.11% CPU I/O wait time (ms)/percent: 0 / 0.00% Number of context switches: 13723415093 Number of I/O blocked processes/percent: 0 / 0.00% Top N CPU Times: ---------------- Android User ID, Package Name, CPU Time (ms), Percentage of total CPU time, CPU Cycles Command, CPU Time (ms), Percentage of UID's CPU Time, CPU Cycles 10, com.google.android.carassistant, 13357, 2.82%, 16409088000 assistant:interactor, 13360, 100.02%, 16409088000 0, system, 9097, 1.92%, 9640512000 sensors@1.0-ser, 3790, 41.66%, 3773184000 system_server, 2760, 30.34%, 3135936000 com.android.car, 1150, 12.64%, 1099584000 binder:621_4, 1000, 10.99%, 1281024000 surfaceflinger, 230, 2.53%, 245376000 0, audioserver, 4383, 0.93%, 4597248000 Main, 2690, 61.37%, 2980416000 binder:916_2, 950, 21.67%, 925056000 audioserver, 720, 16.43%, 691776000 0, root, 4357, 0.92%, 3727872000 irq/311-iam2068, 2630, 60.36%, 2471616000 irq/26-90b6400., 370, 8.49%, 561024000 kworker/u16:4-bwmon_wq, 290, 6.66%, 48960000 kworker/u16:1-memlat_wq, 270, 6.20%, 0 ipcdaemon, 220, 5.05%, 218304000 10, com.google.android.apps.geo.automotive.adas, 1509, 0.32%, 1756416000 adas:publishing, 1490, 98.74%, 1735680000 as:clientparams, 10, 0.66%, 20736000 0, com.android.vending, 796, 0.17%, 765504000 android.vending, 790, 99.25%, 765504000 0, shared:com.google.uid.shared, 581, 0.12%, 481152000 google.android.gms, 340, 58.52%, 237312000 .gms.persistent, 190, 32.70%, 184512000 process.gservices, 50, 8.61%, 59328000 0, gps, 507, 0.11%, 659136000 binder:920_2, 500, 98.62%, 659136000 10, com.android.vending, 489, 0.10%, 372288000 android.vending, 480, 98.16%, 372288000 0, shared:android.uid.systemui, 438, 0.09%, 449856000 android.systemui, 440, 100.46%, 449856000 Top N Storage I/O Reads: ------------- Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync % 0, root, 56123392, 81.95%, 1, 100.00%, 0, 0.00%, 0, 0.00% 0, system, 12333056, 18.01%, 0, 0.00%, 0, 0.00%, 0, 0.00% Top N Storage I/O Writes: ------------------------- Android User ID, Package Name, Foreground Bytes, Foreground Bytes %, Foreground Fsync, Foreground Fsync %, Background Bytes, Background Bytes %, Background Fsync, Background Fsync % 0, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62% 10, com.android.vending, 0, 0.00%, 0, 0.00%, 520192, 46.35%, 20, 47.62% 10, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 45056, 4.01%, 0, 0.00% 0, shared:com.google.uid.shared, 0, 0.00%, 0, 0.00%, 36864, 3.28%, 2, 4.76% 0, logd, 24576, 40.00%, 0, 0.00%, 0, 0.00%, 0, 0.00% 0, root, 20480, 33.33%, 0, 0.00%, 0, 0.00%, 0, 0.00% 0, system, 16384, 26.67%, 0, 0.00%, 0, 0.00%, 0, 0.00% Top N I/O waiting UIDs: ----------------------- Android User ID, Package Name, Number of owned tasks waiting for I/O, Percentage of owned tasks waiting for I/O Command, Number of I/O waiting tasks, Percentage of UID's tasks waiting for I/O 0, root, 2, 0.39% dp_hdcp2p2, 1, 50.00% hdcp_2x, 1, 50.00% Top N major page faults: ------------------------ Android User ID, Package Name, Number of major page faults, Percentage of total major page faults Command, Number of major page faults, Percentage of UID's major page faults 0, com.android.vending, 104, 48.83% android.vending, 104, 100.00% 10, com.android.vending, 104, 48.83% android.vending, 104, 100.00% 0, shared:com.google.uid.shared, 4, 1.88% .gms.persistent, 4, 100.00% 10, shared:com.google.uid.shared, 1, 0.47% .gms.persistent, 1, 100.00% Number of major page faults since last collection: 213 Percentage of change in major page faults since last collection: 0.00%
عند تسجيل تقرير أخطاء، أو تنفيذ أمر Watchdog dumpsys بدون أي وسيطات أو إيقاف جلسة جمع مخصّصة، فإنّ خدمة Watchdog الأصلية تنشئ تقرير بيانات أداء مشابهًا للتقرير أعلاه.
يحتوي التقرير على البيانات التي تم جمعها أثناء تشغيل النظام وآخر N دقيقة قبل إنشاء التقرير.
اسم | الوصف |
---|---|
معلومات حول جمع البيانات عند بدء التشغيل | توفّر هذه السمة معلومات حول جلسة جمع بيانات الأداء أثناء وقت التشغيل. |
معلومات حول عملية جمع البيانات عند التنشيط | تقدّم هذه السمة معلومات عن جلسة جمع بيانات الأداء عند التنشيط عندما يستأنف النظام العمل بعد تعليقه. |
معلومات جمع بيانات تبديل المستخدم | توفّر هذه السمة معلومات عن جلسة جمع بيانات الأداء عند تبديل المستخدمين. |
معلومات حول عملية الجمع الدورية | تقدّم هذه السمة معلومات حول جلسة جمع بيانات الأداء الدورية التي تبدأ بعد اكتمال عملية التشغيل. |
تقرير أداء وقت التشغيل | يحتوي على بيانات الأداء التي تم جمعها أثناء تشغيل النظام. تظل هذه البيانات محفوظة في الذاكرة إلى أن يتم إيقاف تشغيل النظام، لذا يتم تفريغ البيانات في جميع التقارير. |
تقرير أداء ميزة "الاستيقاظ" | يحتوي على بيانات الأداء التي تم جمعها أثناء التنشيط. تظل هذه البيانات في الذاكرة إلى أن يتم إيقاف النظام، وبالتالي يتم تفريغ البيانات في جميع التقارير. |
تقرير أداء تبديل المستخدم | يحتوي على بيانات الأداء التي تم جمعها أثناء التبديل بين المستخدمين. تظل هذه البيانات في الذاكرة إلى أن يتم إيقاف تشغيل النظام، لذا يتم تفريغ البيانات في جميع التقارير. |
تقرير أداء عمليات الإدخال والإخراج خلال آخر N دقيقة | يحتوي على بيانات الأداء التي تم جمعها (من خلال جلسة الجمع الدورية) خلال آخر N دقيقة قبل إنشاء التقرير. |
مدة جمع البيانات | إجمالي مدة جمع بيانات الأداء |
عدد المجموعات | إجمالي عدد المجموعات التي تم الإبلاغ عنها في تقرير واحد. |
قد تحتوي كل مجموعة تمّ الإبلاغ عنها في التقرير على كل أو بعض الأقسام أدناه. الإحصاءات التي يتم تسجيلها في كل عملية جمع هي الفرق منذ آخر عملية جمع، باستثناء الإحصاءات الفورية (على سبيل المثال، التي لم يتم تجميعها منذ بدء تشغيل النظام).
اسم | الوصف |
---|---|
وقت انتظار الإدخال/الإخراج لوحدة المعالجة المركزية (CPU) أو النسبة المئوية | تمثّل هذه السمة الوقت المطلق لوحدة المعالجة المركزية والنسبة المئوية لإجمالي الوقت الذي استغرقته وحدة المعالجة المركزية في تبديل السياق أو الانتظار بسبب عمليات الإدخال/الإخراج منذ آخر عملية جمع. |
إجمالي وقت وحدة المعالجة المركزية | إجمالي وقت وحدة المعالجة المركزية بالمللي ثانية |
إجمالي وقت عدم نشاط وحدة المعالجة المركزية | إجمالي الوقت الذي استغرقته وحدة المعالجة المركزية في وضع الخمول |
وقت انتظار إدخال/إخراج وحدة المعالجة المركزية | إجمالي الوقت الذي استغرقه المعالج في انتظار عمليات الإدخال/الإخراج |
عدد عمليات تبديل السياق | عدد عمليات تبديل وحدة المعالجة المركزية من عملية أو سلسلة محادثات إلى أخرى |
عدد العمليات المحظورة بسبب الإدخال/الإخراج/النسبة المئوية | إجمالي عدد العمليات المحظورة التي تنتظر عمليات الإدخال/الإخراج ونسبة العمليات المحظورة التي تنتظر عمليات الإدخال/الإخراج منذ آخر عملية جمع |
أعلى N من أوقات وحدة المعالجة المركزية |
أهم N حزمة استهلكت أكبر قدر من وقت وحدة المعالجة المركزية منذ آخر عملية جمع:
|
عمليات قراءة الإدخال/الإخراج لأعلى N مساحة تخزين |
أهم N حزمة قرأت أكبر قدر من البيانات من القرص منذ آخر عملية جمع. يحتوي كل سطر على معرّف المستخدم واسم الحزمة وإجمالي عدد وحدات البايت التي تمت قراءتها في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية، ونسبة وحدات البايت في جميع عمليات القراءة في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية في النظام، وإجمالي عدد طلبات |
عمليات الكتابة في وحدة الإدخال/الإخراج لأعلى N مساحة تخزين | أهم N حزمة كتبت معظم البيانات على القرص منذ آخر عملية جمع. يحتوي كل سطر على حقول مشابهة لحقول "أهم N قراءة". |
أهم N معرّفات فريدة في انتظار عمليات الإدخال/الإخراج | أفضل N حزمة تحتوي على أكبر عدد من مهام انتظار الإدخال/الإخراج
|
أهم N أخطاء رئيسية في الصفحات | أهم N حزمة تتضمّن أكبر عدد من أخطاء الصفحة الرئيسية منذ آخر عملية جمع. |