Watchdog की नेटिव सेवा, सिस्टम बूट अप के दौरान, शुरुआती प्रोसेस से ही I/O परफ़ॉर्मेंस का डेटा रिकॉर्ड करती है. नेटिव सेवा, इकट्ठा किए गए परफ़ॉर्मेंस डेटा को गड़बड़ी की रिपोर्ट में डंप करती है. वेंडर, dumpsys के ज़रिए नेटिव सेवा से क्वेरी करके, इकट्ठा किए गए डेटा को डंप कर सकते हैं या डीबग करने के लिए, कस्टम कलेक्शन सेशन शुरू कर सकते हैं.
डेटा कलेक्शन की फ़्रीक्वेंसी
परफ़ॉर्मेंस डेटा कलेक्शन की फ़्रीक्वेंसी, बिल्ड टाइप के हिसाब से अलग-अलग होती है.
- userdebug या eng बिल्ड पर, Watchdog सिस्टम बूट अप के दौरान हर एक (1) सेकंड में एक बार और बूट पूरा होने के बाद हर एक (1) मिनट में एक बार, परफ़ॉर्मेंस डेटा इकट्ठा करता है.
- user बिल्ड पर, 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 सेकंड और कलेक्शन की ज़्यादा से ज़्यादा अवधि एक घंटा होती है. साथ ही, प्रोफ़ाइलिंग को 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.txtDumpsys की मदद पाना
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 मिनट में इकट्ठा किया गया परफ़ॉर्मेंस डेटा शामिल होता है. यह डेटा, समय-समय पर होने वाले कलेक्शन सेशन से इकट्ठा किया जाता है. |
| कलेक्शन की अवधि | परफ़ॉर्मेंस डेटा कलेक्शन की कुल अवधि. |
| कलेक्शन की संख्या | एक रिपोर्ट में बताए गए कलेक्शन की कुल संख्या. |
रिपोर्ट में बताए गए हर कलेक्शन में, नीचे दिए गए सभी सेक्शन या इनमें से कुछ सेक्शन शामिल हो सकते हैं. हर कलेक्शन में बताई गई estadísticas, पिछले कलेक्शन के बाद से डेल्टा होती हैं. हालांकि, वे estadísticas इसमें शामिल नहीं होती हैं जो तुरंत मिलती हैं. जैसे, सिस्टम बूट-अप के बाद से एग्रीगेट नहीं की गई estadísticas.
| आइटम | ब्यौरा |
|---|---|
| सीपीयू का I/O इंतज़ार का समय/प्रतिशत | पिछले कलेक्शन के बाद से, कॉन्टेक्स्ट स्विच करने या इंतज़ार करने में बिताया गया सीपीयू का कुल समय और सीपीयू के कुल समय का प्रतिशत. |
| सीपीयू का कुल समय | मिलीसेकंड में सीपीयू का कुल समय. |
| सीपीयू का कुल आइडल टाइम | सीपीयू का कुल समय जो आइडल रहने में बिताया गया. |
| सीपीयू का I/O इंतज़ार का समय | सीपीयू का कुल समय जो I/O कार्रवाइयों के लिए इंतज़ार करने में बिताया गया. |
| कॉन्टेक्स्ट स्विच की संख्या | सीपीयू के एक प्रोसेस या थ्रेड से दूसरे प्रोसेस या थ्रेड पर स्विच करने की संख्या. |
| I/O ब्लॉक किए गए प्रोसेस की संख्या/प्रतिशत | I/O के लिए इंतज़ार करते हुए ब्लॉक किए गए प्रोसेस की कुल संख्या और पिछले कलेक्शन के बाद से, I/O के लिए इंतज़ार करते हुए ब्लॉक किए गए प्रोसेस का प्रतिशत. |
| सीपीयू के टॉप N समय |
पिछले कलेक्शन के बाद से, सीपीयू का सबसे ज़्यादा समय इस्तेमाल करने वाले टॉप N पैकेज:
|
| स्टोरेज I/O के टॉप N रीड |
पिछले कलेक्शन के बाद से, डिस्क से सबसे ज़्यादा डेटा पढ़ने वाले टॉप N पैकेज. हर लाइन में, यूज़र आईडी, पैकेज का नाम, फ़ोरग्राउंड
मोड बनाम बैकग्राउंड मोड में पढ़े गए बाइट की कुल संख्या, सिस्टम में फ़ोरग्राउंड मोड बनाम
बैकग्राउंड मोड में पढ़े गए बाइट का प्रतिशत, फ़ोरग्राउंड मोड बनाम बैकग्राउंड मोड में किए गए |
| स्टोरेज I/O के टॉप N राइट | पिछले कलेक्शन के बाद से, डिस्क में सबसे ज़्यादा डेटा लिखने वाले टॉप N पैकेज. हर लाइन में, टॉप N रीड के जैसे फ़ील्ड शामिल होते हैं. |
| I/O के लिए इंतज़ार करने वाले टॉप N यूआईडी | I/O के लिए इंतज़ार करने वाले सबसे ज़्यादा टास्क वाले टॉप N पैकेज.
|
| मेजर पेज फ़ॉल्ट के टॉप N | पिछले कलेक्शन के बाद से, मेजर पेज फ़ॉल्ट वाले टॉप N पैकेज. |