ตั้งค่าการแจ้งเตือนปัญหาด้านประสิทธิภาพ

ใช้Performance Monitoringการแจ้งเตือนเพื่อแจ้งให้สมาชิกในโปรเจ็กต์ทราบหากการเปลี่ยนแปลงโค้ดหรือคำขอเครือข่าย ทำให้ประสิทธิภาพของแอปแย่ลง

คุณสามารถตั้งค่าและปรับแต่งการแจ้งเตือนสำหรับแอป ซึ่งจะแจ้งให้คุณทราบเมื่อ ประสิทธิภาพของเหตุการณ์เกินเกณฑ์ที่ตั้งไว้

อะไรเป็นตัวกระตุ้นการแจ้งเตือน

ระบบจะทริกเกอร์การแจ้งเตือนเมื่อเมตริกของแอปข้ามเกณฑ์ที่คุณ กำหนดสำหรับเปอร์เซ็นไทล์ที่ระบุ (หากมี) ในFirebaseคอนโซล การแจ้งเตือนจะทริกเกอร์เฉพาะในกรณีที่แอปใช้ SDK เวอร์ชันที่ใช้งานร่วมกันได้แบบเรียลไทม์

เวลาเริ่มต้นของแอป

เมื่อกำหนดค่าการแจ้งเตือนสำหรับเวลาเริ่มต้นแอป ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง

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

การติดตามโค้ดที่กำหนดเอง

เมื่อกำหนดค่าการแจ้งเตือนสำหรับเมตริกการติดตามโค้ดที่กำหนดเอง ระบบจะทริกเกอร์การแจ้งเตือน หากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง

  • Firebase บันทึกตัวอย่างการติดตามโค้ดที่กำหนดเองอย่างน้อย 100 รายการ สำหรับแอปเวอร์ชันล่าสุดในชั่วโมงที่ผ่านมา
  • ระยะเวลาของการติดตามเกินเกณฑ์ที่กำหนดของแอปในช่วง ชั่วโมงที่ผ่านมาและเปอร์เซ็นไทล์ที่กำหนดค่าไว้
  • (สำหรับ iOS+ และ Android เท่านั้น) ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในแอปเวอร์ชันล่าสุด
  • (สำหรับเว็บเท่านั้น) ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกัน ในช่วง 3 วันที่ผ่านมา

คำขอเครือข่าย

เมื่อกำหนดค่าการแจ้งเตือนสำหรับเมตริกคำขอเครือข่าย ระบบจะทริกเกอร์การแจ้งเตือน หากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง

  • Firebase บันทึกตัวอย่างอย่างน้อย 100 รายการที่ตรงกับรูปแบบ URL ในแอปทุกเวอร์ชันในช่วงชั่วโมงที่ผ่านมา
  • ค่ารวมของเมตริกเกินเกณฑ์ที่กำหนดในช่วงชั่วโมงที่ผ่านมา
    • เวลาตอบสนอง: ค่ารวมเกินเกณฑ์ที่ตั้งไว้สำหรับ เปอร์เซ็นไทล์ที่กำหนดค่า
    • อัตราความสำเร็จ: (สำหรับ iOS+/Android เท่านั้น) ค่ารวมต่ำกว่า เกณฑ์ที่ตั้งไว้ในผู้ใช้ทั้งหมด
  • ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในช่วง 3 วันที่ผ่านมา

การแสดงผลหน้าจอ

เมื่อกำหนดค่าการแจ้งเตือนสำหรับเมตริกการแสดงผลหน้าจอ ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง

  • Firebase บันทึกตัวอย่างการแสดงผลหน้าจออย่างน้อย 100 ตัวอย่างสำหรับแอปเวอร์ชันล่าสุดในชั่วโมงที่ผ่านมา
  • ค่ารวมของเมตริกเกินเกณฑ์ที่กำหนดในช่วง ชั่วโมงที่ผ่านมา
    • เฟรมค้าง: ค่ารวมเกินเกณฑ์ที่ตั้งไว้
    • เฟรมที่ช้า: ค่ารวมเกินเกณฑ์ที่ตั้งไว้
  • ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในแอปเวอร์ชันล่าสุด

การโหลดหน้าเว็บ

เมื่อกำหนดค่าการแจ้งเตือนสำหรับเมตริกการโหลดหน้าเว็บ ระบบจะทริกเกอร์การแจ้งเตือนหาก เงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง

  • Firebase บันทึกตัวอย่างการโหลดหน้าเว็บของแอปอย่างน้อย 100 รายการในชั่วโมงที่ผ่านมา
  • ค่ารวมของเมตริกเกินเกณฑ์ที่กำหนดในช่วงชั่วโมงที่ผ่านมาและเปอร์เซ็นไทล์ที่กำหนดค่าไว้
    • ความล่าช้าในการอินพุตครั้งแรก: ค่ารวมเกินเกณฑ์ที่ตั้งไว้ และเปอร์เซ็นไทล์ที่กำหนดค่าไว้
    • First Contentful Paint: ค่ารวมเกินเกณฑ์ที่ตั้งไว้ และเปอร์เซ็นไทล์ที่กำหนดค่าไว้
    • การแสดงผลแรก: ค่ารวมเกินเกณฑ์ที่ตั้งไว้ และเปอร์เซ็นไทล์ที่กำหนดค่าไว้
  • ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในช่วง 3 วันที่ผ่านมา

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

การแจ้งเตือนสำหรับเมตริกประสิทธิภาพอื่นๆ หรือการผสานรวม Firebase ในตัวกับ Slack, Jira และ PagerDuty จะใช้ไม่ได้กับการแจ้งเตือน Performance Monitoring

รับการแจ้งเตือน

รับการแจ้งเตือนเริ่มต้น

โดยค่าเริ่มต้น Firebase จะส่งการแจ้งเตือน Performance Monitoring ทางอีเมลได้

หากต้องการรับการแจ้งเตือนเกี่ยวกับPerformance Monitoringผ่านกลไกเริ่มต้นนี้ คุณต้องมีfirebaseperformance.config.updateสิทธิ์ บทบาทต่อไปนี้มีสิทธิ์ที่จำเป็นนี้โดยค่าเริ่มต้น

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

เปิด/ปิดการแจ้งเตือนสำหรับบัญชีของคุณเอง

สำหรับบัญชีของคุณเอง คุณสามารถเปิด/ปิดPerformance Monitoringการแจ้งเตือนได้โดยไม่ส่งผลกระทบต่อสมาชิกคนอื่นๆ ในโปรเจ็กต์ โปรดทราบว่าคุณยังคงต้องมีสิทธิ์ที่จำเป็น เพื่อรับการแจ้งเตือน

หากต้องการเปิดหรือปิดPerformance Monitoringการแจ้งเตือน ให้ทำตามขั้นตอนต่อไปนี้

  1. ในFirebaseคอนโซล ให้ไปที่ Firebase alerts ที่มุมขวาบน
  2. จากนั้นไปที่ การตั้งค่า แล้วตั้งค่ากำหนดบัญชีสำหรับการแจ้งเตือนPerformance Monitoring

ตั้งค่าการแจ้งเตือนขั้นสูงไปยังบริการของบุคคลที่สาม

นอกจากนี้ คุณยังส่งการแจ้งเตือน Performance Monitoring ไปยังช่องทางการแจ้งเตือนที่ทีมต้องการได้ด้วยโดยใช้ Cloud Functions for Firebase เช่น คุณสามารถเขียนฟังก์ชันที่บันทึกเหตุการณ์การแจ้งเตือนสำหรับเวลาเริ่มต้นแอปที่ช้าและโพสต์ข้อมูลการแจ้งเตือนไปยังบริการของบุคคลที่สาม เช่น Discord, Slack หรือ Jira

หากต้องการตั้งค่าความสามารถในการแจ้งเตือนขั้นสูงโดยใช้ Cloud Functions for Firebase ให้ทำตามขั้นตอนต่อไปนี้

  1. ตั้งค่า Cloud Functions for Firebase ซึ่งรวมถึงงานต่อไปนี้

    1. ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์สำหรับ Node.js หรือ Python
    2. ติดตั้งและลงชื่อเข้าใช้ Firebase CLI
    3. เริ่มต้น Cloud Functions for Firebase โดยใช้ Firebase CLI

  2. เขียนและติดตั้งใช้งานฟังก์ชันที่ บันทึกเหตุการณ์การแจ้งเตือนจาก Performance Monitoring และจัดการเพย์โหลดของเหตุการณ์ (เช่น โพสต์ข้อมูลการแจ้งเตือนในข้อความบน Discord)

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

การนำการแจ้งเตือนที่ไม่ถูกต้องออกโดยอัตโนมัติ

Performance Monitoring จะตรวจสอบการแจ้งเตือนเพื่อให้แน่ใจว่าข้อมูลถูกต้องและการแจ้งเตือน ยังคงใช้งานอยู่ ระบบจะถือว่าการแจ้งเตือนถูกต้องหากเป็นไปตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้

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

หากไม่เป็นไปตามเงื่อนไขข้างต้น Performance Monitoring จะนำการแจ้งเตือนออก

กำหนดค่าการแจ้งเตือน

หากต้องการกำหนดค่าการแจ้งเตือน Performance Monitoring คุณต้องมีสิทธิ์ firebaseperformance.config.update บทบาทต่อไปนี้มีสิทธิ์ที่จำเป็นนี้โดยค่าเริ่มต้น ผู้ดูแลระบบประสิทธิภาพ Firebase ผู้ดูแลระบบคุณภาพ Firebase ผู้ดูแลระบบ Firebase และเจ้าของหรือผู้แก้ไขโปรเจ็กต์

หากยังไม่ได้ดำเนินการ ให้เพิ่ม SDK Performance Monitoring ล่าสุดลงในแอปของคุณ ดูข้อมูลเพิ่มเติมได้ที่คู่มือการเริ่มต้นใช้งานสำหรับแพลตฟอร์มเว็บ Android Apple และ Flutter

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

กำหนดค่าการแจ้งเตือนในตารางการติดตาม

  1. ไปที่แท็บPerformance Monitoring แดชบอร์ด ในคอนโซล Firebase แล้วเลือกแอปที่ต้องการ กำหนดค่าการแจ้งเตือน

  2. เลื่อนลงไปที่ตารางการติดตามที่ด้านล่างของหน้าจอ

  3. เลือกแท็บประเภทการติดตามที่คุณต้องการตั้งค่าการแจ้งเตือน แล้ว ค้นหาแถวที่เกี่ยวข้อง

  4. ที่ด้านขวาสุดของแถว ให้เปิดเมนูแบบเลื่อนลง () แล้วเลือก การตั้งค่าการแจ้งเตือน

  5. ทำตามวิธีการบนหน้าจอเพื่อตั้งค่าเกณฑ์การแจ้งเตือนและเปอร์เซ็นไทล์ (หากมี) สำหรับแอป หรือเพื่อเปิด/ปิดการแจ้งเตือน เปอร์เซ็นไทล์เริ่มต้นคือ 90 สำหรับ Android และ iOS และ 75 สำหรับเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับเปอร์เซ็นไทล์เริ่มต้นได้ที่ติดตามเมตริกที่สำคัญในแดชบอร์ด

กำหนดค่าการแจ้งเตือนในการ์ดรายงานแดชบอร์ด

  1. ไปที่แท็บPerformance Monitoring แดชบอร์ด ในคอนโซล Firebase แล้วเลือกแอปที่ต้องการ กำหนดค่าการแจ้งเตือน

  2. ในแท็บการ์ดรายงาน ให้ค้นหาการ์ดเมตริกที่ต้องการ กำหนดค่าการแจ้งเตือน

  3. ในการ์ดเมตริกที่ต้องการ ให้เปิดเมนูรายการเพิ่มเติม () แล้วเลือกการตั้งค่าการแจ้งเตือน

  4. ทำตามวิธีการบนหน้าจอเพื่อตั้งค่าเกณฑ์การแจ้งเตือนและเปอร์เซ็นไทล์ (หากมี) สำหรับแอป หรือเพื่อเปิด/ปิดการแจ้งเตือน เปอร์เซ็นไทล์เริ่มต้นคือ 90 สำหรับ Android และ iOS และ 75 สำหรับเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับเปอร์เซ็นไทล์เริ่มต้นได้ที่ติดตามเมตริกที่สำคัญในแดชบอร์ด

แนวทางปฏิบัติแนะนำในการตั้งค่าการแจ้งเตือนประสิทธิภาพ

คำขอเครือข่าย

Firebase จะรวบรวมข้อมูลจากคำขอเครือข่ายที่คล้ายกันภายใต้รูปแบบ URL ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

ตั้งค่าการแจ้งเตือนสำหรับรูปแบบ URL ที่กำหนดเอง

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

ตั้งค่าการแจ้งเตือนสำหรับรูปแบบ URL อัตโนมัติ

เมื่อตั้งค่าการแจ้งเตือนสำหรับรูปแบบ URL อัตโนมัติ ให้ตรวจสอบว่ารูปแบบ URL อัตโนมัติ มีเสถียรภาพเป็นเวลา 2-3 วัน โปรดทราบว่ารูปแบบ URL อัตโนมัติอาจเปลี่ยนแปลงไปเมื่อเวลาผ่านไป และการกำหนดค่าการแจ้งเตือนจะไม่โอนไปยังรูปแบบ URL ใหม่ ซึ่งอาจส่งผลให้การแจ้งเตือนสำหรับรูปแบบที่คุณสนใจไม่ถูกต้องหรือขาดหายไป นอกจากนี้ คุณยังอาจพิจารณาสร้างรูปแบบ URL ที่กำหนดเองเพื่อให้มั่นใจว่ารูปแบบนี้จะเสถียร

การโหลดหน้าเว็บ

ดูเกณฑ์ที่แนะนำสำหรับการวัดเมตริกเว็บได้ในเอกสารประกอบของ Core Web Vitals

การแสดงผลหน้าจอ

เซสชันของผู้ใช้ควรไม่มีเฟรมที่ช้าและหยุดนิ่งเพื่อให้มั่นใจว่าแอปจะมอบประสบการณ์การใช้งานที่ดีที่สุด Performance Monitoring ขอแนะนำให้คุณตั้งค่าการแจ้งเตือนสำหรับเฟรมค้างที่มากกว่า 1% และตั้งค่าการแจ้งเตือนสำหรับเฟรมช้าที่เกิน 5% คุณจะเห็นว่าค่าเหล่านี้เป็นการตั้งค่าเริ่มต้นในระหว่างการกำหนดค่าการแจ้งเตือนประสิทธิภาพ ดูข้อมูลเพิ่มเติมเกี่ยวกับเฟรมที่ช้าหรือค้างมากเกินไปและแนวทางปฏิบัติแนะนำอื่นๆ เกี่ยวกับประสิทธิภาพของแอปได้ที่คำแนะนำของ Google Play