جمع بيانات الأداء

تسجّل خدمة 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 حزمة استهلكت أكبر قدر من وقت وحدة المعالجة المركزية منذ آخر عملية جمع:

  • يحتوي كل سطر من المستوى الأعلى على معرّف المستخدم واسم الحزمة ووقت وحدة المعالجة المركزية ونسبة إجمالي وقت وحدة المعالجة المركزية ودورات وحدة المعالجة المركزية.
  • تحتوي الأسطر ذات المستوى الداخلي على الأمر ووقت وحدة المعالجة المركزية ونسبة وقت وحدة المعالجة المركزية الخاص بمعرّف المستخدم (UID) ودورات وحدة المعالجة المركزية.
عمليات قراءة الإدخال/الإخراج لأعلى N مساحة تخزين

أهم N حزمة قرأت أكبر قدر من البيانات من القرص منذ آخر عملية جمع.

يحتوي كل سطر على معرّف المستخدم واسم الحزمة وإجمالي عدد وحدات البايت التي تمت قراءتها في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية، ونسبة وحدات البايت في جميع عمليات القراءة في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية في النظام، وإجمالي عدد طلبات fsync التي تم إجراؤها في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية، ونسبة طلبات fsync في جميع طلبات fsync التي تم إجراؤها في وضع التشغيل في المقدّمة مقارنةً بوضع التشغيل في الخلفية في النظام.

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

أفضل N حزمة تحتوي على أكبر عدد من مهام انتظار الإدخال/الإخراج

  • يحتوي كل سطر من المستوى الأعلى على رقم تعريف المستخدم وأسماء الحِزم وعدد المهام التي تملكها الحزمة والتي تنتظر إدخال/إخراج البيانات ونسبتها المئوية.
  • تحتوي الأسطر على مستوى الداخل على معلومات انتظار الإدخال/الإخراج لأهم العمليات التي تملكها الحزمة.
أهم N أخطاء رئيسية في الصفحات أهم N حزمة تتضمّن أكبر عدد من أخطاء الصفحة الرئيسية منذ آخر عملية جمع.