เริ่มต้นใช้งานการตรวจสอบประสิทธิภาพสำหรับ Flutter

คู่มือเริ่มใช้งานฉบับย่อนี้อธิบายวิธีตั้งค่า Firebase Performance Monitoring เพื่อช่วยให้คุณได้รับข้อมูลเชิงลึกเกี่ยวกับลักษณะด้านประสิทธิภาพของแอป Flutter

ก่อนเริ่มต้น

หากยังไม่ได้ทำ ให้กำหนดค่าและเริ่มต้น Firebase ในโปรเจ็กต์ Flutter

ขั้นตอนที่ 1: เพิ่ม Performance Monitoring ลงในแอป

  1. จากไดเรกทอรีรากของโปรเจ็กต์ Flutter ให้เรียกใช้คำสั่งต่อไปนี้เพื่อติดตั้งปลั๊กอิน Flutter ของ Performance Monitoring

    flutter pub add firebase_performance

  2. เรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีรากของโปรเจ็กต์ Flutter

    flutterfire configure

    การเรียกใช้คำสั่งนี้ช่วยให้มั่นใจได้ว่าการกำหนดค่า Firebase ของแอป Flutter เป็นเวอร์ชันล่าสุด และสำหรับ Android จะเพิ่มปลั๊กอิน Gradle ของ Performance Monitoring ที่จำเป็นลงในแอป

  3. เมื่อเสร็จแล้ว ให้สร้างโปรเจ็กต์ Flutter อีกครั้งโดยทำดังนี้

    flutter run

หลังจากเพิ่ม Performance Monitoring SDK แล้ว Firebase จะเริ่มรวบรวมข้อมูลที่เกี่ยวข้องกับวงจรของแอป (เช่น เวลาเริ่มต้นของแอป) และข้อมูลสำหรับคำขอเครือข่าย HTTP/S โดยอัตโนมัติ

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

ขั้นตอนที่ 2: สร้างเหตุการณ์ด้านประสิทธิภาพสำหรับการแสดงข้อมูลเริ่มต้น

Firebase จะเริ่มประมวลผลเหตุการณ์เมื่อคุณเพิ่ม SDK ลงในแอปเรียบร้อยแล้ว หากคุณยังคงพัฒนาแอปในเครื่อง ให้โต้ตอบกับแอปเพื่อสร้างเหตุการณ์สำหรับการเก็บรวบรวมข้อมูลและการประมวลผลข้อมูลเบื้องต้น

  1. พัฒนาแอปต่อโดยใช้เครื่องจำลองหรืออุปกรณ์ทดสอบ

  2. สร้างเหตุการณ์โดยสลับแอปไปมาระหว่างเบื้องหลังและเบื้องหน้าหลายๆ ครั้ง โต้ตอบกับแอปโดยไปยังหน้าจอต่างๆ และ/หรือทริกเกอร์คำขอเครือข่าย

  3. ไปที่แดชบอร์ด Performance ของคอนโซล Firebase คุณควรเห็นข้อมูลเริ่มต้นแสดงภายในไม่กี่นาที

    หากไม่เห็นการแสดงข้อมูลเริ่มต้น โปรดอ่านเคล็ดลับการแก้ปัญหา

ขั้นตอนที่ 3: (ไม่บังคับ) ดูข้อความในบันทึกสำหรับเหตุการณ์ด้านประสิทธิภาพ

  1. ตรวจสอบข้อความในบันทึกเพื่อดูข้อความแสดงข้อผิดพลาด

    Performance Monitoring จะติดแท็กข้อความในบันทึกด้วยแท็กต่อไปนี้เพื่อให้คุณกรองข้อความในบันทึกได้

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. ตรวจสอบบันทึกประเภทต่อไปนี้ซึ่งบ่งบอกว่า Performance Monitoring กำลังบันทึกเหตุการณ์ด้านประสิทธิภาพอยู่

    • Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URL
    • Logging network request trace: URL

  3. คลิก URL เพื่อดูข้อมูลในคอนโซล Firebase ระบบอาจใช้เวลาสักครู่ในการอัปเดตข้อมูลในแดชบอร์ด

ขั้นตอนที่ 4: (ไม่บังคับ) เพิ่มการตรวจสอบที่กำหนดเองสำหรับโค้ดที่เฉพาะเจาะจง

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

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

ในโค้ด คุณจะกำหนดจุดเริ่มต้นและจุดสิ้นสุดของการติดตามโค้ดที่กำหนดเอง (และเพิ่มเมตริกที่กำหนดเองที่ต้องการ) โดยใช้ API ที่ Performance Monitoring SDK มีให้

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

ขั้นตอนที่ 5: ติดตั้งใช้งานแอปแล้วตรวจสอบผลลัพธ์

หลังจากตรวจสอบ Performance Monitoring โดยใช้โปรแกรมจำลองและอุปกรณ์ทดสอบอย่างน้อย 1 เครื่องแล้ว คุณจะทำให้แอปเวอร์ชันที่อัปเดตพร้อมใช้งานสำหรับผู้ใช้ได้

คุณสามารถตรวจสอบข้อมูลประสิทธิภาพได้ในแดชบอร์ดประสิทธิภาพของคอนโซล Firebase

ขั้นตอนถัดไป