Perfetto

perfetto เป็นเครื่องมือที่ช่วยให้คุณรวบรวมข้อมูลประสิทธิภาพจากอุปกรณ์ Android ผ่าน Android Debug Bridge (ADB) เรียกใช้เครื่องมือ perfetto โดยใช้คำสั่ง adb shell perfetto ... perfetto ใช้แหล่งข้อมูลต่างๆ เพื่อรวบรวมการติดตามประสิทธิภาพจากอุปกรณ์ของคุณ เช่น

  • ftrace สำหรับข้อมูลจากเคอร์เนล
  • atrace สำหรับคำอธิบายประกอบพื้นที่ผู้ใช้ในบริการและแอป
  • heapprofd สำหรับข้อมูลการใช้งานหน่วยความจำแบบเนทีฟของบริการและแอป

หน้านี้จะอธิบายวิธีเรียกใช้ perfetto และกำหนดค่าเพื่อสร้างเอาต์พุตที่ต้องการ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ perfetto

ไวยากรณ์

ส่วนนี้จะอธิบายวิธีใช้ ADB เพื่อเรียกใช้ perfetto สำหรับโหมดต่างๆ และสร้างการติดตาม

การเลือกแหล่งข้อมูล

perfetto มี 2 โหมดต่อไปนี้ซึ่งจะกำหนดแหล่งข้อมูลที่ใช้ในการบันทึกการติดตาม

  • โหมดสว่าง: เลือกได้เฉพาะชุดย่อยของแหล่งข้อมูล โดยเฉพาะ atrace และ ftrace อย่างไรก็ตาม โหมดนี้มีอินเทอร์เฟซคล้ายกับ systrace
  • โหมดปกติ: รับการกำหนดค่าในบัฟเฟอร์โปรโตคอลและช่วยให้คุณใช้ประโยชน์จากฟังก์ชันการทำงานของ perfetto ได้มากขึ้นโดยใช้แหล่งข้อมูลที่แตกต่างจาก atrace และ ftrace

ตัวเลือกทั่วไป

ตารางต่อไปนี้แสดงตัวเลือกที่มีเมื่อใช้ perfetto ในโหมดใดโหมดหนึ่ง

ตารางที่ 1 รายการตัวเลือกเครื่องมือ Perfetto ทั่วไปที่ใช้ได้

ตัวเลือก คำอธิบาย
--background |
-d
perfetto จะออกจากอินเทอร์เฟซบรรทัดคำสั่งทันทีและบันทึกการติดตามในเบื้องหลังต่อไป
--background-wait | -D เหมือนกับ --background แต่จะรอ (สูงสุด 30 วินาที) ให้แหล่งข้อมูลทั้งหมดเริ่มทำงานก่อนที่จะออก รหัสออกจะเป็น 0 หากได้รับการรับทราบที่สำเร็จ และไม่ใช่ 0 หากไม่สำเร็จ (ข้อผิดพลาดหรือหมดเวลา)
--alert-id รหัสของการแจ้งเตือนที่ทริกเกอร์การติดตามนี้
--config-id รหัสของการกำหนดค่าที่ทริกเกอร์
--config-uid UID ของแอปที่ลงทะเบียนการกำหนดค่า
--subscription-id รหัสของการสมัครใช้บริการที่ทริกเกอร์การติดตามนี้
--out OUT_FILE |
-o OUT_FILE

ระบุเส้นทางที่ต้องการไปยังไฟล์การย้ายข้อมูลเอาต์พุตหรือ - สำหรับ stdout perfetto จะเขียนเอาต์พุตลงในไฟล์ที่อธิบายไว้ในแฟล็กก่อนหน้า รูปแบบเอาต์พุตจะคอมไพล์ด้วยรูปแบบที่กำหนดไว้ใน AOSP trace.proto

หมายเหตุ: คุณต้องระบุชื่อเส้นทางแบบเต็มของไฟล์เอาต์พุต โดยปกติแล้ว ไฟล์ควรเขียนลงในโฟลเดอร์ /data/misc/perfetto-traces

--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] |
-t TIME[s|m|h]
ระบุระยะเวลาการติดตามเป็นวินาที นาที หรือชั่วโมง เช่น --time 1m ระบุระยะเวลาการติดตามเป็น 1 นาที ระยะเวลาเริ่มต้นคือ 10 วินาที
--buffer SIZE[mb|gb] |
-b SIZE[mb|gb]
ระบุขนาดบัฟเฟอร์แบบวงกลมในหน่วยเมกะไบต์ (MB) หรือกิกะไบต์ (GB) พารามิเตอร์เริ่มต้นคือ --buffer 32mb
--size SIZE[mb|gb] |
-s SIZE[mb|gb]
ระบุขนาดไฟล์สูงสุดเป็นเมกะไบต์ (MB) หรือกิกะไบต์ (GB) โดยค่าเริ่มต้น perfetto จะใช้เฉพาะบัฟเฟอร์แบบวงแหวนในหน่วยความจำเท่านั้น
--app | -a ชื่อแอป Android (atrace)

ตัวเลือกเหล่านี้จะตามด้วยรายการตัวระบุเหตุการณ์ ดังนี้

ตารางที่ 3 รายการตัวระบุเหตุการณ์สำหรับโหมดสว่าง

กิจกรรม คำอธิบาย
ATRACE_CAT ระบุหมวดหมู่ atrace ที่คุณต้องการบันทึกการติดตาม ตัวอย่างเช่น คำสั่งต่อไปนี้จะติดตาม Window Manager โดยใช้ atrace
    adb shell perfetto --out FILE wm
    

หากต้องการบันทึกหมวดหมู่อื่นๆ โปรดดูรายการหมวดหมู่ atrace นี้

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

เลือกและกำหนดค่าแหล่งข้อมูลโดยใช้สมาชิก DataSourceConfig ของ TraceConfig ตามที่กำหนดไว้ใน AOSP data_source_config.proto

--txt สั่งให้ perfetto แยกวิเคราะห์ไฟล์การกำหนดค่าเป็น pbtxt แฟล็กนี้มีไว้สำหรับการทดสอบในเครื่องเท่านั้น และเราไม่แนะนำให้เปิดใช้สำหรับการใช้งานจริง

แหล่งข้อมูลที่รองรับ

ส่วนนี้จะอธิบายแหล่งที่มาต่างๆ ที่ perfetto ใช้เพื่อสร้างการติดตาม

ftrace

แหล่งข้อมูล ftrace ช่วยให้ perfetto รับเหตุการณ์จากเคอร์เนลได้

เปิดใช้แหล่งที่มานี้โดยตั้งค่า ftrace_config ใน DataSourceConfig

เหตุการณ์ที่เปิดใช้ได้มีดังนี้

ทั้งนี้อาจมีเหตุการณ์อื่นๆ เพิ่มเติม ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ หรือเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่ config protos

สถิติกระบวนการ

แหล่งข้อมูลสถิติกระบวนการช่วยให้คุณได้รับตัวนับที่สำรวจเกี่ยวกับระบบและกระบวนการแต่ละรายการ

เปิดใช้แหล่งที่มานี้โดยตั้งค่า process_stats_config และ sys_stats_config ใน DataSourceConfig

ข้อมูลที่ perfetto สร้างขึ้นประกอบด้วยข้อมูลต่อไปนี้

คุณอาจเห็นเหตุการณ์อื่นๆ เพิ่มเติม ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ และเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่โปรโตคอลการกำหนดค่าสำหรับ sys_stats และ process_stats

heapprofd

heapprofd ช่วยให้คุณสุ่มตัวอย่างสาเหตุของการใช้หน่วยความจำแบบเนทีฟได้

เปิดใช้แหล่งที่มานี้โดยตั้งค่า heapprofd_config ใน DataSourceConfig การตั้งค่านี้จะสร้าง ProfilePackets ซึ่งรวมถึงเฟรม Java ของ Call Stack

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ heapprofd ได้ที่ perfetto.dev

แหล่งที่มาอื่นๆ

แหล่งข้อมูลอื่นๆ อาจพร้อมใช้งาน ทั้งนี้ขึ้นอยู่กับอุปกรณ์ เวอร์ชันระบบปฏิบัติการ และเคอร์เนล ดูข้อมูลเพิ่มเติมได้ที่โปรโตคอลการกำหนดค่าแหล่งข้อมูล

ดูข้อมูลเพิ่มเติมเกี่ยวกับ perfetto ได้ที่ perfetto.dev