perfetto เป็นเครื่องมือที่ช่วยให้คุณรวบรวมข้อมูลประสิทธิภาพจากอุปกรณ์ Android ผ่าน Android Debug Bridge (ADB) เรียกใช้เครื่องมือ perfetto โดยใช้คำสั่ง adb shell perfetto ...
perfetto ใช้แหล่งข้อมูลต่างๆ เพื่อรวบรวมการติดตามประสิทธิภาพจากอุปกรณ์ของคุณ เช่น
ftraceสำหรับข้อมูลจากเคอร์เนลatraceสำหรับคำอธิบายประกอบพื้นที่ผู้ใช้ในบริการและแอปheapprofdสำหรับข้อมูลการใช้งานหน่วยความจำแบบเนทีฟของบริการและแอป
หน้านี้จะอธิบายวิธีเรียกใช้ perfetto และกำหนดค่าเพื่อสร้างเอาต์พุตที่ต้องการ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ perfetto
ทักษะ Android
ดูใน GitHubเครื่องมือสร้างโปรไฟล์ Android
android skills add android-profilerไวยากรณ์
ส่วนนี้จะอธิบายวิธีใช้ ADB เพื่อเรียกใช้ perfetto สำหรับโหมดต่างๆ และสร้างการติดตาม
การเลือกแหล่งข้อมูล
perfetto มี 2 โหมดต่อไปนี้ซึ่งจะกำหนดแหล่งข้อมูลที่ใช้ในการบันทึกการติดตาม
- โหมดสว่าง: เลือกได้เฉพาะชุดย่อยของแหล่งข้อมูล โดยเฉพาะ
atraceและftraceอย่างไรก็ตาม โหมดนี้มีอินเทอร์เฟซคล้ายกับsystrace - โหมดปกติ: รับการกำหนดค่าในบัฟเฟอร์โปรโตคอลและช่วยให้คุณใช้ประโยชน์จากฟังก์ชันการทำงานของ
perfettoได้มากขึ้นโดยใช้แหล่งข้อมูลที่แตกต่างจากatraceและftrace
ตัวเลือกทั่วไป
ตารางต่อไปนี้แสดงตัวเลือกที่มีเมื่อใช้ perfetto ในโหมดใดโหมดหนึ่ง
ตารางที่ 1 รายการตัวเลือกเครื่องมือ Perfetto ทั่วไปที่ใช้ได้
| ตัวเลือก | คำอธิบาย |
|---|---|
--background |
|
perfetto จะออกจากอินเทอร์เฟซบรรทัดคำสั่งทันทีและบันทึกการติดตามในเบื้องหลังต่อไป |
--background-wait | -D
|
เหมือนกับ --background แต่จะรอ (สูงสุด 30 วินาที) ให้แหล่งข้อมูลทั้งหมดเริ่มทำงานก่อนที่จะออก รหัสออกจะเป็น 0 หากได้รับการรับทราบที่สำเร็จ และไม่ใช่ 0 หากไม่สำเร็จ (ข้อผิดพลาดหรือหมดเวลา)
|
--alert-id
|
รหัสของการแจ้งเตือนที่ทริกเกอร์การติดตามนี้ |
--config-id
|
รหัสของการกำหนดค่าที่ทริกเกอร์ |
--config-uid
|
UID ของแอปที่ลงทะเบียนการกำหนดค่า |
--subscription-id
|
รหัสของการสมัครใช้บริการที่ทริกเกอร์การติดตามนี้ |
--out OUT_FILE |
|
ระบุเส้นทางที่ต้องการไปยังไฟล์การย้ายข้อมูลเอาต์พุตหรือ หมายเหตุ: คุณต้องระบุชื่อเส้นทางแบบเต็มของไฟล์เอาต์พุต โดยปกติแล้ว ไฟล์ควรเขียนลงในโฟลเดอร์ |
--upload
|
เมื่อเสร็จสมบูรณ์แล้ว ระบบจะส่งการติดตามไปยังแพ็กเกจที่ระบุโดยข้อความ IncidentReportConfig ในการกำหนดค่าการติดตามโปรโต |
--no-guardrails
|
ปิดใช้การป้องกันการใช้ทรัพยากรมากเกินไปเมื่อเปิดใช้แฟล็ก --upload ในระหว่างการทดสอบ |
--reset-guardrails
|
รีเซ็ตสถานะถาวรของ Guardrail และออกจากการทดสอบ |
--rsave-for-bugreport
|
หากมีการติดตามที่ bugreport_score > 0 กำลังทำงานอยู่ ให้บันทึกการติดตามลงในไฟล์ แสดงผลเส้นทางเมื่อเสร็จแล้ว
|
--query
|
ค้นหาสถานะบริการและพิมพ์เป็นข้อความที่มนุษย์อ่านได้ |
--query-raw
|
คล้ายกับ --query แต่พิมพ์ไบต์ที่เข้ารหัสโปรโตดิบของ tracing_service_state.proto. |
--help | -h
|
พิมพ์ข้อความช่วยเหลือสำหรับเครื่องมือ perfetto
|
โหมดสว่าง
ไวยากรณ์ทั่วไปสำหรับการใช้ perfetto ในโหมดสว่างมีดังนี้
adb shell perfetto [ --time TIMESPEC ] [ --buffer SIZE ] [ --size SIZE ]
[ ATRACE_CAT | FTRACE_GROUP/FTRACE_NAME | FTRACE_GROUP/* ]...
--out FILE
ตารางต่อไปนี้แสดงตัวเลือกที่ใช้ได้เมื่อใช้ perfetto ในโหมดสว่าง
ตารางที่ 2 รายการตัวเลือกเครื่องมือ perfetto ที่ใช้ได้เมื่อใช้โหมดสว่าง
| ตัวเลือก | คำอธิบาย |
|---|---|
--time TIME[s|m|h] |
|
ระบุระยะเวลาการติดตามเป็นวินาที นาที หรือชั่วโมง
เช่น --time 1m ระบุระยะเวลาการติดตามเป็น 1 นาที
ระยะเวลาเริ่มต้นคือ 10 วินาที
|
--buffer SIZE[mb|gb] |
|
ระบุขนาดบัฟเฟอร์แบบวงกลมในหน่วยเมกะไบต์ (MB) หรือกิกะไบต์ (GB)
พารามิเตอร์เริ่มต้นคือ --buffer 32mb
|
--size SIZE[mb|gb] |
|
ระบุขนาดไฟล์สูงสุดเป็นเมกะไบต์ (MB) หรือกิกะไบต์ (GB) โดยค่าเริ่มต้น perfetto จะใช้เฉพาะบัฟเฟอร์แบบวงแหวนในหน่วยความจำเท่านั้น
|
--app | -a
|
ชื่อแอป Android (atrace) |
ตัวเลือกเหล่านี้จะตามด้วยรายการตัวระบุเหตุการณ์ ดังนี้
ตารางที่ 3 รายการตัวระบุเหตุการณ์สำหรับโหมดสว่าง
| กิจกรรม | คำอธิบาย |
|---|---|
| ATRACE_CAT |
ระบุหมวดหมู่ atrace ที่คุณต้องการบันทึกการติดตาม
ตัวอย่างเช่น คำสั่งต่อไปนี้จะติดตาม Window Manager โดยใช้ atrace
adb shell perfetto --out FILE wm
หากต้องการบันทึกหมวดหมู่อื่นๆ โปรดดูรายการหมวดหมู่ |
| FTRACE_GROUP/FTRACE_NAME |
ระบุเหตุการณ์ ftrace ที่คุณต้องการบันทึกการติดตาม
ตัวอย่างเช่น คำสั่งต่อไปนี้จะติดตามเหตุการณ์ sched/sched_switch รายการ
adb shell perfetto --out FILE sched/sched_switch
|
โหมดปกติ
ไวยากรณ์ทั่วไปสำหรับการใช้ perfetto ในโหมดปกติมีดังนี้
adb shell perfetto [ --txt ] --config CONFIG_FILE --out FILE
ตารางต่อไปนี้แสดงตัวเลือกที่มีเมื่อใช้ perfetto ในโหมดปกติ
ตารางที่ 4 รายการตัวเลือกเครื่องมือ perfetto ที่ใช้ได้เมื่อใช้โหมดปกติ
| ตัวเลือก | คำอธิบาย |
|---|---|
--config CONFIG_FILE | -c CONFIG_FILE
|
ระบุเส้นทางไปยังไฟล์การกำหนดค่า ในโหมดปกติ การกำหนดค่าบางอย่างอาจเข้ารหัสในบัฟเฟอร์โปรโตคอลการกำหนดค่า ไฟล์นี้ต้องเป็นไปตามสคีมาบัฟเฟอร์โปรโตคอลที่กำหนดไว้ใน AOSP trace_config.proto
เลือกและกำหนดค่าแหล่งข้อมูลโดยใช้สมาชิก |
--txt
|
สั่งให้ perfetto แยกวิเคราะห์ไฟล์การกำหนดค่าเป็น pbtxt แฟล็กนี้มีไว้สำหรับการทดสอบในเครื่องเท่านั้น และเราไม่แนะนำให้เปิดใช้สำหรับการใช้งานจริง |
แหล่งข้อมูลที่รองรับ
ส่วนนี้จะอธิบายแหล่งที่มาต่างๆ ที่ perfetto ใช้เพื่อสร้างการติดตาม
ftrace
แหล่งข้อมูล ftrace ช่วยให้ perfetto รับเหตุการณ์จากเคอร์เนลได้
เปิดใช้แหล่งที่มานี้โดยตั้งค่า
ftrace_config
ใน DataSourceConfig
เหตุการณ์ที่เปิดใช้ได้มีดังนี้
-
sched/sched_switchsched/sched_wakeupsched/sched_wakeup_newsched/sched_process_execsched/sched_process_exitsched/sched_process_forksched/sched_process_freesched/sched_process_hangsched/sched_process_wait
เหตุการณ์ในระบบไฟล์:
ทั้งนี้อาจมีเหตุการณ์อื่นๆ เพิ่มเติม ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ หรือเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่ config protos
สถิติกระบวนการ
แหล่งข้อมูลสถิติกระบวนการช่วยให้คุณได้รับตัวนับที่สำรวจเกี่ยวกับระบบและกระบวนการแต่ละรายการ
เปิดใช้แหล่งที่มานี้โดยตั้งค่า process_stats_config และ sys_stats_config ใน DataSourceConfig
ข้อมูลที่ perfetto สร้างขึ้นประกอบด้วยข้อมูลต่อไปนี้
-
/proc/meminfo/proc/vmstat/proc/stat
-
/proc/\<pid\>/status/proc/\<pid\>/oom_score_adj
คุณอาจเห็นเหตุการณ์อื่นๆ เพิ่มเติม ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ และเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่โปรโตคอลการกำหนดค่าสำหรับ sys_stats และ process_stats
heapprofd
heapprofd ช่วยให้คุณสุ่มตัวอย่างสาเหตุของการใช้หน่วยความจำแบบเนทีฟได้
เปิดใช้แหล่งที่มานี้โดยตั้งค่า heapprofd_config ใน DataSourceConfig การตั้งค่านี้จะสร้าง ProfilePackets ซึ่งรวมถึงเฟรม Java ของ Call Stack
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ heapprofd ได้ที่ perfetto.dev
แหล่งที่มาอื่นๆ
แหล่งข้อมูลอื่นๆ อาจพร้อมใช้งาน ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ และเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่โปรโตคอลการกำหนดค่าแหล่งข้อมูล
ดูข้อมูลเพิ่มเติมเกี่ยวกับ perfetto ได้ที่ perfetto.dev