परफ़ॉर्मेंस डेटा इकट्ठा करना

वॉचडॉग नेटिव सेवा, सिस्टम बूट अप के दौरान शुरुआती-शुरुआत से ही I/O परफ़ॉर्मेंस डेटा रिकॉर्ड करती है. नेटिव सेवा, इकट्ठा किए गए परफ़ॉर्मेंस डेटा को गड़बड़ी की रिपोर्ट में डंप करती है. वेंडर, dumpsys के ज़रिए नेटिव सेवा से क्वेरी कर सकते हैं. इससे, वे इकट्ठा किए गए डेटा को डंप कर सकते हैं या डीबग करने के लिए कस्टम कलेक्शन सेशन शुरू कर सकते हैं.

डेटा कलेक्शन की फ़्रीक्वेंसी

परफ़ॉर्मेंस डेटा इकट्ठा करने की फ़्रीक्वेंसी, बिल्ड टाइप के हिसाब से अलग-अलग होती है.

  • userdebug या eng बिल्ड पर, Watchdog सिस्टम बूट अप के दौरान हर एक (1) सेकंड में एक बार परफ़ॉर्मेंस का डेटा इकट्ठा करता है. साथ ही, बूट अप पूरा होने के बाद हर एक (1) मिनट में एक बार डेटा इकट्ठा करता है.
  • उपयोगकर्ता के बिल्ड पर, Watchdog हर 20 सेकंड में एक बार परफ़ॉर्मेंस का डेटा इकट्ठा करता है. यह डेटा, सिस्टम बूट अप के दौरान इकट्ठा किया जाता है. बूट अप पूरा होने के बाद, यह डेटा हर दो (2) मिनट में एक बार इकट्ठा किया जाता है.

डेटा कलेक्शन के इवेंट

सैंपल के आधार पर प्रोफ़ाइलिंग, अलग-अलग सिस्टम इवेंट के दौरान की जाती है. जैसे, सिस्टम बूटअप, सिस्टम वेकअप, और उपयोगकर्ता स्विच करना. इसके अलावा, यह पिछले N मिनट की विंडो के दौरान भी की जाती है.

  • गड़बड़ी की रिपोर्ट जनरेट करने से पहले, पिछले N मिनट में हुए इवेंट: ये इवेंट, 30 मिनट की रोलिंग विंडो के दौरान जनरेट किए जाते हैं.
  • बूट टाइम इवेंट: ये इवेंट, बूट अप के बाद जनरेट होते हैं.
  • उपयोगकर्ता स्विच करने से जुड़े इवेंट: ये इवेंट, उपयोगकर्ता के स्विच करने की प्रोसेस शुरू होने के बाद जनरेट होते हैं.
  • कस्टम कलेक्शन इवेंट: इनमें पोलिंग की अवधि और ज़्यादा से ज़्यादा अवधि तय की जा सकती है. साथ ही, इन्हें पैकेज के हिसाब से फ़िल्टर किया जा सकता है.

परफ़ॉर्मेंस डेटा डंप करना

जब गड़बड़ी की रिपोर्ट कैप्चर की जाती है, तब Watchdog की नेटिव सेवा, परफ़ॉर्मेंस से जुड़ा इकट्ठा किया गया डेटा, गड़बड़ी की रिपोर्ट में डंप कर देती है. वेंडर, परफ़ॉर्मेंस से जुड़ा इकट्ठा किया गया डेटा डंप करने के लिए, नीचे दिए गए dumpsys कमांड के ज़रिए नेटिव सेवा से क्वेरी कर सकते हैं. रिपोर्ट के बारे में ज़्यादा जानकारी के लिए, परफ़ॉर्मेंस डेटा रिपोर्ट को समझना सेक्शन देखें.

adb shell dumpsys android.automotive.watchdog.ICarWatchdog/default > /tmp/carwatchdog_dump.txt

डीबग करने के लिए परफ़ॉर्मेंस डेटा इकट्ठा करना

वेंडर, Watchdog की नेटिव सेवा का इस्तेमाल करके, परफ़ॉर्मेंस डेटा को अपनी ज़रूरत के मुताबिक इकट्ठा कर सकते हैं. ऐसा डीबग करने के लिए किया जाता है. उदाहरण के लिए, किसी ऐप्लिकेशन या सेवा के I/O इस्तेमाल को समझने के लिए, वेंडर परफ़ॉर्मेंस डेटा इकट्ठा करने की कस्टम प्रोसेस कर सकते हैं. इससे पैकेज की किसी खास सूची या पूरे सिस्टम के I/O इस्तेमाल की प्रोफ़ाइल बनाई जाती है.

पसंद के मुताबिक़ बनाए गए कलेक्शन का सेशन शुरू करें

परफ़ॉर्मेंस डेटा इकट्ठा करने के लिए कस्टम सेशन शुरू करने की कमांड यहां दी गई है:

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 सेकंड, डेटा इकट्ठा करने की ज़्यादा से ज़्यादा अवधि 1 घंटा, और प्रोफ़ाइलिंग को 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

कस्टम कलेक्शन सेशन को बंद करना और डंप करना

किसी ऐप्लिकेशन या सेवा के I/O इस्तेमाल को रिकॉर्ड करने के बाद, वेंडर को परफ़ॉर्मेंस से जुड़े कस्टम डेटा को इकट्ठा करने का सेशन बंद कर देना चाहिए, ताकि इकट्ठा किए गए डेटा को डंप किया जा सके. इस कमांड से, कस्टम परफ़ॉर्मेंस डेटा इकट्ठा करने की प्रोसेस बंद हो जाती है. साथ ही, इकट्ठा किया गया डेटा /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

प्रोटो फ़ॉर्मैट में डंप करना

वैकल्पिक तौर पर, dumpsys डेटा को प्रोटो फ़ॉर्मैट में डंप किया जा सकता है:

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 मिनट की I/O परफ़ॉर्मेंस रिपोर्ट इसमें परफ़ॉर्मेंस का वह डेटा शामिल होता है जिसे रिपोर्ट जनरेट होने से पहले, पिछले N मिनट में इकट्ठा किया गया था. यह डेटा, समय-समय पर होने वाले कलेक्शन सेशन के ज़रिए इकट्ठा किया जाता है.
डेटा इकट्ठा करने की अवधि परफ़ॉर्मेंस डेटा इकट्ठा करने की कुल अवधि.
कलेक्शन की संख्या एक रिपोर्ट में बताए गए कलेक्शन की कुल संख्या.

रिपोर्ट में शामिल हर कलेक्शन में, नीचे दिए गए सभी या कुछ सेक्शन हो सकते हैं. हर कलेक्शन में रिपोर्ट किए गए आंकड़े, पिछली बार के कलेक्शन के बाद से हुए बदलाव को दिखाते हैं. हालांकि, इसमें वे आंकड़े शामिल नहीं होते जो तुरंत अपडेट होते हैं. उदाहरण के लिए, सिस्टम बूट-अप के बाद से इकट्ठा नहीं किए गए आंकड़े.

आइटम ब्यौरा
सीपीयू के I/O के लिए इंतज़ार करने का समय/प्रतिशत पिछला कलेक्शन होने के बाद से, कॉन्टेक्स्ट स्विचिंग या I/O ऑपरेशनों की वजह से इंतज़ार करने में लगा कुल सीपीयू समय और सीपीयू का प्रतिशत.
सीपीयू का कुल समय सीपीयू का कुल समय (मिलीसेकंड में).
सीपीयू (CPU) के इस्तेमाल न होने का कुल समय सीपीयू का कुल समय, जो किसी काम में इस्तेमाल नहीं हुआ.
सीपीयू के इनपुट/आउटपुट के लिए इंतज़ार का समय सीपीयू ने I/O ऑपरेशन के लिए कुल कितना समय इंतज़ार किया.
कॉन्टेक्स्ट स्विच की संख्या एक प्रोसेस या थ्रेड से दूसरी प्रोसेस या थ्रेड पर सीपीयू स्विच करने की संख्या.
I/O ब्लॉक की गई प्रोसेस की संख्या/प्रतिशत I/O के लिए इंतज़ार कर रही ब्लॉक की गई प्रोसेस की कुल संख्या और पिछली बार के कलेक्शन के बाद से, I/O के लिए इंतज़ार कर रही ब्लॉक की गई प्रोसेस का प्रतिशत.
सबसे ज़्यादा सीपीयू टाइम

ऐसे टॉप N पैकेज जिन्होंने पिछली बार के कलेक्शन के बाद से सबसे ज़्यादा सीपीयू समय लिया है:

  • टॉप-लेवल की हर लाइन में, यूज़र आईडी, पैकेज का नाम, सीपीयू का समय, सीपीयू के कुल समय का प्रतिशत, और सीपीयू साइकल शामिल होते हैं.
  • इनर-लेवल लाइनों में कमांड, सीपीयू का समय, यूआईडी के सीपीयू के समय का प्रतिशत, और सीपीयू साइकल शामिल होते हैं.
सबसे ज़्यादा स्टोरेज I/O रीड

ऐसे टॉप N पैकेज जिन्होंने पिछली बार के कलेक्शन के बाद से, डिस्क से सबसे ज़्यादा डेटा पढ़ा है.

हर लाइन में उपयोगकर्ता आईडी, पैकेज का नाम, फ़ोरग्राउंड मोड बनाम बैकग्राउंड मोड में पढ़े गए बाइट की कुल संख्या, सिस्टम में फ़ोरग्राउंड मोड बनाम बैकग्राउंड मोड में पढ़े गए बाइट का प्रतिशत, फ़ोरग्राउंड मोड बनाम बैकग्राउंड मोड में किए गए fsync कॉल की कुल संख्या, और सिस्टम में फ़ोरग्राउंड मोड बनाम बैकग्राउंड मोड में किए गए fsync कॉल का प्रतिशत शामिल होता है.fsync

सबसे ज़्यादा स्टोरेज I/O राइट करने वाले टॉप N प्रोसेस ऐसे टॉप N पैकेज जिन्होंने पिछले कलेक्शन के बाद से, डिस्क पर सबसे ज़्यादा डेटा लिखा है. हर लाइन में, सबसे ज़्यादा पढ़े गए लेखों की जानकारी देने वाले फ़ील्ड की तरह ही फ़ील्ड होते हैं.
I/O के लिए इंतज़ार कर रहे टॉप N यूआईडी

सबसे ज़्यादा I/O वेटिंग टास्क वाले टॉप N पैकेज.

  • हर टॉप-लेवल लाइन में यूज़र आईडी, पैकेज के नाम, और पैकेज के मालिकाना हक वाले उन टास्क की संख्या और प्रतिशत शामिल होता है जो I/O के लिए इंतज़ार कर रहे हैं.
  • इनर-लेवल लाइनों में, पैकेज के मालिकाना हक वाली टॉप प्रोसेस के लिए, I/O के इंतज़ार की जानकारी होती है.
सबसे ज़्यादा N पेज फ़ॉल्ट पिछले कलेक्शन के बाद से, सबसे ज़्यादा पेज फ़ॉल्ट वाले टॉप N पैकेज.