บันทึกการติดตามของระบบในอุปกรณ์

อุปกรณ์ที่ใช้ Android 9 (API ระดับ 28) ขึ้นไปมีแอประดับระบบที่เรียกว่าการติดตามระบบ แอปนี้คล้ายกับยูทิลิตีบรรทัดคำสั่ง systrace แต่แอปนี้ให้คุณบันทึกร่องรอยจากอุปกรณ์ทดสอบได้โดยตรงโดยไม่ต้องเสียบปลั๊กอุปกรณ์และเชื่อมต่อผ่าน adb จากนั้นคุณสามารถใช้ เพื่อแชร์ผลลัพธ์จากการติดตามเหล่านี้กับทีมพัฒนาของคุณ

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

ซึ่งช่วยบันทึกร่องรอยเมื่อจัดการกับข้อบกพร่องที่เกี่ยวข้องกับประสิทธิภาพในแอป เช่น การเริ่มต้นช้า การเปลี่ยนเฟรมช้า หรือ UI กระตุก

บันทึกการติดตามของระบบ

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

หมายเหตุ: คุณอาจส่งข้อบกพร่องในอุปกรณ์ ซึ่งเป็นส่วนหนึ่งของเวิร์กโฟลว์การพัฒนา รายงาน คุณควรส่งรายงานข้อบกพร่องประเภทนี้หลังจากบันทึกการติดตามระบบเสร็จแล้ว วิธีนี้จะทำให้กระบวนการรายงานข้อบกพร่องไม่รวมอยู่ในการติดตามที่บันทึกไว้

บันทึกโดยใช้การ์ดการตั้งค่าด่วน

การ์ดการตั้งค่าด่วนมักเป็นวิธีที่สะดวกกว่าในการดําเนินการติดตามระบบในอุปกรณ์ให้เสร็จสมบูรณ์

ตั้งค่าการ์ด

หากคุณใช้การติดตามระบบเป็นครั้งแรกในอุปกรณ์ทดสอบ หรือหากไม่เห็นการ์ดการติดตามระบบในแผงการตั้งค่าด่วนของอุปกรณ์ ดังที่แสดงในรูปที่ 2 ให้ทำตามขั้นตอนการตั้งค่าต่อไปนี้

1. เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอป
2. เปิดหน้าจอการตั้งค่าตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์
3. ในส่วนการแก้ไขข้อบกพร่อง ให้เลือกการติดตามระบบ แอปการติดตามระบบจะเปิดขึ้นพร้อมแสดงเมนูแอป

4. จากเมนูแอป ให้เปิดใช้แสดงการ์ดการตั้งค่าด่วนดังที่แสดงในรูปที่ 1 ระบบจะเพิ่มการ์ดการติดตามระบบลงในแผงการตั้งค่าด่วน ดังที่แสดงในรูปที่ 2

   

   รูปที่ 1 ให้เปลี่ยนแสดงการ์ดการตั้งค่าด่วนเข้า แอป System Tracing

   

   รูปที่ 2 การ์ดการติดตามระบบในแผงการตั้งค่าด่วน

   หมายเหตุ: โดยค่าเริ่มต้น ระบบจะ เพิ่มการ์ด System Tracing เป็นไทล์แรกใน Quick ด่วน การตั้งค่า หากต้องการให้การ์ดปรากฏในตําแหน่งอื่น ให้ใช้โหมดแก้ไขของแผงเพื่อย้ายการ์ด

บันทึกการติดตามระบบให้เสร็จสมบูรณ์

หากต้องการบันทึกการติดตามของระบบโดยใช้แผงการตั้งค่าด่วน ให้ทำตามขั้นตอนต่อไปนี้

1. แตะการ์ดการติดตามระบบซึ่งมีป้ายกำกับว่าบันทึกการติดตาม ไทล์จะเปิดใช้ และการแจ้งเตือนแบบถาวรจะปรากฏขึ้นเพื่อแจ้งให้ทราบว่าระบบกำลังบันทึกร่องรอย ดังที่แสดงในรูปที่ 3

   

   รูปที่ 3 การแจ้งเตือนที่แสดงอยู่เรื่อยๆ ซึ่งปรากฏหลังจาก เริ่มการติดตามระบบในอุปกรณ์

2. ดําเนินการในแอปที่คุณต้องการให้ระบบตรวจสอบ

   หมายเหตุ: คุณบันทึกข้อบกพร่องที่ทำซ้ำได้ยากได้โดยออกจากระบบ การติดตามกำลังทำงานในเบื้องหลังแล้วหยุด System Tracing เร็วๆ นี้ หลังข้อบกพร่องเกิดขึ้น System Tracing จะบันทึกกิจกรรมของอุปกรณ์เป็นการเล่นต่อเนื่อง ซึ่งจะเก็บเหตุการณ์ได้ 10-30 วินาที

3. หยุดการติดตามโดยแตะการ์ด System Tracing ใน Quick ด่วน แผงการตั้งค่าหรือในการแจ้งเตือน System Tracing

   ระบบจะแสดงการแจ้งเตือนใหม่ที่มีข้อความ "กำลังบันทึก การติดตาม" เมื่อบันทึกเสร็จแล้ว ระบบจะปิดการแจ้งเตือนและแสดงการแจ้งเตือนครั้งที่ 3 เพื่อยืนยันว่าบันทึกการติดตามแล้วและคุณพร้อมที่จะแชร์การติดตามระบบดังที่แสดงในรูปภาพ 4

   

   รูปที่ 4 การแจ้งเตือนที่แสดงอยู่เรื่อยๆ ซึ่งปรากฏหลังจาก จากนั้นระบบจะบันทึกการติดตามที่บันทึกไว้จนเสร็จสิ้น

บันทึกโดยใช้เมนูแอป

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

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

1. เปิดใช้ตัวเลือกสำหรับนักพัฒนาแอป

2. เปิดหน้าจอการตั้งค่าตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ ในส่วนการแก้ไขข้อบกพร่อง เลือก System Tracing แอป System Tracing จะเปิดขึ้น

   หรือหากตั้งค่าการ์ด System Tracing ไว้แล้ว ให้แตะการ์ดค้างไว้เพื่อเข้าสู่แอป System Tracing

3. ตรวจสอบว่าได้เลือกติดตามแอปพลิเคชันที่แก้ไขข้อบกพร่องได้เพื่อรวมแอปที่ เปิดใช้การแก้ไขข้อบกพร่องในการติดตามระบบแล้ว

4. (ไม่บังคับ) เลือกหมวดหมู่การเรียกระบบและเซ็นเซอร์เพื่อติดตาม และเลือกขนาดบัฟเฟอร์ต่อ CPU เป็น KB เลือกหมวดหมู่ที่สอดคล้องกัน กับกรณีการใช้งานที่คุณกำลังทดสอบ เช่น หมวดหมู่เสียงสำหรับ การทดสอบการดำเนินการของบลูทูธหรือหมวดหมู่หน่วยความจำสำหรับการจัดสรรฮีป

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

5. (ไม่บังคับ) เลือกการติดตามแบบยาวเพื่อเปิดใช้การติดตามที่บันทึกไว้อย่างต่อเนื่องในพื้นที่เก็บข้อมูลของอุปกรณ์ สําหรับตัวเลือกนี้ ให้กําหนดขีดจํากัดสําหรับขนาดการติดตามแบบยาวสูงสุดและระยะเวลาการติดตามแบบยาวสูงสุด

6. เปิดใช้สวิตช์บันทึกการติดตามที่ไฮไลต์ในรูปที่ 5 ไทล์จะเปิดใช้ และการแจ้งเตือนแบบถาวรจะปรากฏขึ้นเพื่อแจ้งให้ทราบว่าระบบกําลังบันทึกร่องรอย ดังที่แสดงในรูปที่ 3

   

   รูปที่ 5 สวิตช์บันทึกการติดตามในการตั้งค่าการติดตามของระบบ

7. ดำเนินการในแอปที่คุณต้องการให้ระบบตรวจสอบ

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

8. หยุดการติดตามโดยปิดใช้สวิตช์บันทึกการติดตาม

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

แชร์การติดตามระบบ

แอปการติดตามระบบช่วยให้คุณแชร์ผลลัพธ์การติดตามระบบเป็นส่วนหนึ่งของเวิร์กโฟลว์ต่างๆ ได้ ในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป ระบบจะบันทึกไฟล์ติดตามด้วย.perfetto-traceนามสกุลไฟล์ และสามารถเปิดไฟล์ใน Perfetto UI ในอุปกรณ์ที่ใช้ Android เวอร์ชันเก่า ระบบจะบันทึกไฟล์ติดตามที่มีนามสกุลไฟล์ .ctrace ซึ่งแสดงถึงรูปแบบ Systrace

แชร์เป็นข้อความ

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

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

แชร์จากแอป Files

สำหรับอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ขึ้นไป การติดตามจะแสดงใน แอป Files คุณแชร์การติดตามจากแอปนี้ได้

ดาวน์โหลดรายงานโดยใช้ ADB

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

cd /path-to-traces-on-my-dev-machine && \
  adb pull /data/local/traces/ .

แปลงรูปแบบการติดตาม

คุณสามารถแปลงไฟล์การติดตามของ Perfetto เป็นรูปแบบ Systrace ได้ ดูการแปลง ระหว่างรูปแบบการติดตาม เพื่อดูข้อมูลเพิ่มเติม

สร้างรายงาน HTML

เมื่อแชร์การติดตาม รายงานจะอยู่ในไฟล์ .perfetto-trace บน อุปกรณ์ที่ใช้ Android 10 หรือมากกว่า หรือไฟล์ .ctrace สำหรับเวอร์ชันอื่นทั้งหมด

สร้างรายงาน HTML จากไฟล์การติดตามโดยใช้ UI บนเว็บหรือจากบรรทัดคำสั่ง

UI บนเว็บ

ใช้ Perfetto UI เพื่อเปิดไฟล์การติดตามและสร้างรายงาน

สำหรับไฟล์ Perfetto ให้คลิกเปิดไฟล์การติดตาม สำหรับไฟล์ Systrace ให้คลิก เปิดด้วย UI เดิม UI แบบเดิมมีรูปลักษณ์แบบเดียวกับ รายงาน Systrace

บรรทัดคำสั่ง

เรียกใช้คำสั่งต่อไปนี้ในหน้าต่างเทอร์มินัลเพื่อสร้างรายงาน HTML จากไฟล์การติดตาม

cd /path-to-traces-on-my-dev-machine && \
  systrace --from-file trace-file-name{.ctrace | .perfetto-trace}

หากยังไม่มีsystraceโปรแกรมบรรทัดคำสั่ง คุณสามารถดาวน์โหลดได้จากโปรเจ็กต์ Catapult ใน GitHub หรือจาก โปรเจ็กต์โอเพนซอร์ส Android โดยตรง