ใช้การแจ้งเตือน Performance Monitoring เพื่อแจ้งให้สมาชิกโปรเจ็กต์ทราบหากการเปลี่ยนแปลงโค้ดหรือคำขอเครือข่ายทำให้ประสิทธิภาพของแอปลดลง
คุณสามารถตั้งค่าและปรับแต่งการแจ้งเตือนสําหรับแอป ซึ่งจะแจ้งให้คุณทราบเมื่อประสิทธิภาพของเหตุการณ์สูงกว่าเกณฑ์ที่ตั้งไว้
อะไรทริกเกอร์การแจ้งเตือน
การแจ้งเตือนจะทริกเกอร์เมื่อเมตริกสําหรับแอปของคุณสูงกว่าเกณฑ์ที่คุณกําหนดไว้สําหรับเปอร์เซ็นต์ที่ระบุ (หากมี) ในคอนโซล Firebase ระบบจะส่งการแจ้งเตือนก็ต่อเมื่อแอปใช้SDK เวอร์ชันที่ใช้งานร่วมกันได้แบบเรียลไทม์เท่านั้น
เวลาเริ่มต้นของแอป
เมื่อคุณกําหนดค่าการแจ้งเตือนสําหรับเวลาเริ่มต้นแอป ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง
- Firebase บันทึก
_app_start
การติดตามของแอปเวอร์ชันล่าสุดเป็นตัวอย่าง 100 รายการ เป็นอย่างน้อยในชั่วโมงที่ผ่านมา - ระยะเวลาของการติดตาม
_app_start
นานเกินเกณฑ์ที่แอปกําหนดไว้ในช่วง 1 ชั่วโมงที่ผ่านมาและสำหรับเปอร์เซ็นต์ที่กำหนดค่าไว้ - ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันนี้ในแอปเวอร์ชันล่าสุด
การติดตามโค้ดที่กำหนดเอง
เมื่อคุณกําหนดค่าการแจ้งเตือนสําหรับเมตริกการติดตามโค้ดที่กําหนดเอง ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขทั้งหมดต่อไปนี้เป็นจริง
- Firebase บันทึกการติดตามโค้ดที่กําหนดเองอย่างน้อย
100 รายการ สําหรับแอปเวอร์ชันล่าสุดในชั่วโมงที่ผ่านมา - ระยะเวลาของการติดตามนานเกินเกณฑ์ที่แอปกําหนดไว้ในช่วง 1 ชั่วโมงที่ผ่านมาและสำหรับเปอร์เซ็นต์ที่กำหนดค่าไว้
- (สำหรับ iOS ขึ้นไปและ Android เท่านั้น) ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในแอปเวอร์ชันล่าสุด
- (สําหรับเว็บเท่านั้น) ไม่มีการแจ้งเตือนก่อนหน้านี้สําหรับเกณฑ์เดียวกันในช่วง
3 วัน ที่ผ่านมา
คำขอเครือข่าย
เมื่อคุณกําหนดค่าการแจ้งเตือนสําหรับเมตริกคําขอเครือข่าย ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง
- Firebase บันทึกตัวอย่างที่ตรงกับรูปแบบ URL อย่างน้อย
100 รายการ ในแอปทุกเวอร์ชันในช่วง 1 ชั่วโมงที่ผ่านมา - ค่ารวมของเมตริกสูงกว่าเกณฑ์ที่กําหนดในช่วง 1 ชม. ที่ผ่านมา
- เวลาในการตอบสนอง: ค่ารวมเกินเกณฑ์ที่ตั้งไว้สําหรับเปอร์เซ็นต์ไทล์ที่กําหนดค่าไว้
- อัตราความสําเร็จ: (สําหรับ iOS+/Android เท่านั้น) ค่ารวมลดลงต่ำกว่าเกณฑ์ที่ตั้งไว้สําหรับผู้ใช้ทั้งหมด
- ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในช่วงที่ผ่านมา
3 วัน
การแสดงภาพหน้าจอ
เมื่อคุณกําหนดค่าการแจ้งเตือนสําหรับเมตริกการแสดงผลหน้าจอ ระบบจะทริกเกอร์การแจ้งเตือนหากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง
- Firebase บันทึกตัวอย่างการแสดงผลหน้าจอของแอปเวอร์ชันล่าสุดเป็นจำนวนอย่างน้อย
100 รายการ ในชั่วโมงที่ผ่านมา - ค่ารวมของเมตริกสูงกว่าเกณฑ์ที่กําหนดไว้ในช่วง 1 ชั่โมงที่ผ่านมา
- เฟรมค้าง: ค่ารวมเกินเกณฑ์ที่ตั้งไว้
- เฟรมที่ช้า: ค่ารวมเกินเกณฑ์ที่ตั้งไว้
- ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในแอปเวอร์ชันล่าสุด
การโหลดหน้าเว็บ
เมื่อคุณกําหนดค่าการแจ้งเตือนสําหรับเมตริกการโหลดหน้าเว็บ การแจ้งเตือนจะทริกเกอร์หากเงื่อนไขต่อไปนี้ทั้งหมดเป็นจริง
- Firebase บันทึกการโหลดหน้าเว็บของแอปคุณอย่างน้อย
100 รายการ ในช่วง 1 ชั่วโมงที่ผ่านมา - ค่ารวมของเมตริกสูงกว่าเกณฑ์ที่กําหนดในช่วง 1 ชั่โมงที่ผ่านมาและสำหรับเปอร์เซ็นต์ไทล์ที่กําหนดค่าไว้
- ความล่าช้าในการอินพุตครั้งแรก: ค่ารวมเกินเกณฑ์ที่ตั้งไว้และเปอร์เซ็นต์ไทล์ที่กำหนดค่าไว้
- First Contentful Paint: ค่ารวมเกินเกณฑ์ที่ตั้งไว้และเปอร์เซ็นต์ไทล์ที่กำหนดค่าไว้
- การวาดภาพครั้งแรก: ค่ารวมเกินเกณฑ์ที่ตั้งไว้และเปอร์เซ็นต์ไทล์ที่กําหนดค่าไว้
- ก่อนหน้านี้ไม่มีการแจ้งเตือนสำหรับเกณฑ์เดียวกันในช่วงที่ผ่านมา
3 วัน
ดูข้อมูลเพิ่มเติมเกี่ยวกับการกําหนดค่าการแจ้งเตือน เปอร์เซ็นต์เริ่มต้น และแนวทางปฏิบัติแนะนําในการตั้งค่าการแจ้งเตือนสําหรับการติดตามและเมตริกบางประเภท
การแจ้งเตือนสําหรับเมตริกประสิทธิภาพอื่นๆ หรือการผสานรวม Firebase ในตัวกับ Slack, Jira และ PagerDuty จะใช้ไม่ได้กับการแจ้งเตือน Performance Monitoring
รับการแจ้งเตือน
รับการแจ้งเตือนเริ่มต้น
โดยค่าเริ่มต้น Firebase สามารถส่งการแจ้งเตือน Performance Monitoring ทางอีเมลได้
หากต้องการรับการแจ้งเตือน Performance Monitoring ผ่านกลไกเริ่มต้นนี้ คุณต้องมีสิทธิ์
firebaseperformance.config.update
บทบาทต่อไปนี้จะมีสิทธิ์ที่จําเป็นนี้โดยค่าเริ่มต้น
- ผู้ดูแลระบบประสิทธิภาพ Firebase
- ผู้ดูแลระบบคุณภาพ Firebase
- ผู้ดูแลระบบ Firebase
- เจ้าของหรือเอดิเตอร์โปรเจ็กต์
การแจ้งเตือนและการตั้งค่าการแจ้งเตือนจะมีผลกับทั้งโปรเจ็กต์ ซึ่งหมายความว่าโดยค่าเริ่มต้น สมาชิกทุกคนในโปรเจ็กต์จะได้รับอีเมลเมื่อมีการทริกเกอร์การแจ้งเตือนประสิทธิภาพ ระบบจะส่งการแจ้งเตือนไปยังสมาชิกโปรเจ็กต์ที่มีสิทธิ์ที่จำเป็นในการรับการแจ้งเตือนและไปยังอีเมลของบุคคลเท่านั้น (ไม่ใช่กลุ่มบัญชี เช่น Google Groups หรือบัญชี Google Workspace)
เปิด/ปิดการแจ้งเตือนสําหรับบัญชีของคุณเอง
สำหรับบัญชีของคุณเอง คุณสามารถเปิด/ปิดการแจ้งเตือน Performance Monitoring ได้โดยไม่ส่งผลต่อสมาชิกโปรเจ็กต์คนอื่นๆ โปรดทราบว่าคุณยังคงต้องมีสิทธิ์ที่จําเป็นเพื่อรับการแจ้งเตือน
หากต้องการเปิดหรือปิดการแจ้งเตือน Performance Monitoring ให้ทำตามขั้นตอนต่อไปนี้
- ในคอนโซล Firebase ให้ไปที่
ที่มุมขวาบน การแจ้งเตือน Firebase - จากนั้นไปที่
แล้วตั้งค่ากำหนดบัญชีสำหรับ การตั้งค่าPerformance Monitoring การแจ้งเตือน
ตั้งค่าการแจ้งเตือนขั้นสูงไปยังบริการของบุคคลที่สาม
นอกจากนี้ คุณยังส่งPerformance Monitoringการแจ้งเตือนไปยังช่องทางการแจ้งเตือนที่ต้องการของทีมได้โดยใช้ Cloud Functions for Firebase เช่น คุณสามารถเขียนฟังก์ชันที่บันทึกเหตุการณ์การแจ้งเตือนสําหรับเวลาที่แอปเริ่มทํางานช้า และโพสต์ข้อมูลการแจ้งเตือนไปยังบริการของบุคคลที่สาม เช่น Discord, Slack หรือ Jira
หากต้องการตั้งค่าความสามารถในการแจ้งเตือนขั้นสูงโดยใช้ Cloud Functions for Firebase ให้ทําตามขั้นตอนต่อไปนี้
ตั้งค่า Cloud Functions for Firebase ซึ่งประกอบด้วยงานต่อไปนี้
- ตั้งค่าสภาพแวดล้อมการพัฒนาสําหรับ Node.js หรือ Python
- ติดตั้งและลงชื่อเข้าใช้ Firebase CLI
- เริ่มต้น Cloud Functions for Firebase โดยใช้ Firebase CLI
เขียนและติดตั้งใช้งานฟังก์ชันที่บันทึกเหตุการณ์การแจ้งเตือนจาก 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 และเจ้าของหรือผู้แก้ไขโปรเจ็กต์
หากยังไม่ได้ดำเนินการ ให้เพิ่ม Performance Monitoring SDK เวอร์ชันล่าสุดลงในแอป ดูข้อมูลเพิ่มเติมได้ที่คู่มือเริ่มต้นใช้งานสำหรับแพลตฟอร์ม เว็บ, Android, Apple และ Flutter
ในแอปที่ลงทะเบียนแต่ละแอป ให้ใช้ตารางการติดตามหรือการ์ดรายงานแดชบอร์ดเพื่อกําหนดค่าการแจ้งเตือนสําหรับเมตริกแต่ละรายการที่คุณต้องการตรวจสอบ แอปแต่ละแอปอาจมีชุดการแจ้งเตือนที่แตกต่างกัน โดยแต่ละชุดจะมีเกณฑ์ที่แตกต่างกัน (หรือไม่มีการแจ้งเตือนเลยก็ได้)
กำหนดค่าการแจ้งเตือนในตารางร่องรอย
ไปที่แท็บPerformance Monitoring หน้าแดชบอร์ด ในคอนโซล Firebase จากนั้นเลือกแอปที่ต้องการกำหนดค่าการแจ้งเตือน
เลื่อนลงไปที่ตารางการติดตามที่ด้านล่างของหน้าจอ
เลือกแท็บของประเภทการติดตามที่ต้องการตั้งการแจ้งเตือน แล้วค้นหาแถวที่เกี่ยวข้อง
ที่ด้านขวาสุดของแถว ให้เปิดเมนูรายการเพิ่มเติม (
) แล้วเลือกการตั้งค่าการแจ้งเตือนทำตามวิธีการบนหน้าจอเพื่อตั้งค่าเกณฑ์การแจ้งเตือนและเปอร์เซ็นต์ไทล์ (หากมี) สำหรับแอป หรือเพื่อเปิด/ปิดการแจ้งเตือน เปอร์เซ็นต์ไทล์เริ่มต้นคือ 90 สำหรับ Android และ iOS และ 75 สำหรับเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับเปอร์เซ็นต์ไทล์เริ่มต้นได้ที่ติดตามเมตริกที่สําคัญในหน้าแดชบอร์ด
กำหนดค่าการแจ้งเตือนในการ์ดรายงานแดชบอร์ด
ไปที่แท็บPerformance Monitoring หน้าแดชบอร์ด ในคอนโซล Firebase จากนั้นเลือกแอปที่ต้องการกำหนดค่าการแจ้งเตือน
ในแท็บการ์ดรายงาน ให้ค้นหาการ์ดเมตริกที่ต้องการกำหนดค่าการแจ้งเตือน
ในการ์ดเมตริกที่ต้องการ ให้เปิดเมนูรายการเพิ่มเติม (
) แล้วเลือกการตั้งค่าการแจ้งเตือนทำตามวิธีการบนหน้าจอเพื่อตั้งค่าเกณฑ์การแจ้งเตือนและเปอร์เซ็นต์ไทล์ (หากมี) สำหรับแอป หรือเพื่อเปิด/ปิดการแจ้งเตือน เปอร์เซ็นต์ไทล์เริ่มต้นคือ 90 สำหรับ Android และ iOS และ 75 สำหรับเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับเปอร์เซ็นต์ไทล์เริ่มต้นได้ที่ติดตามเมตริกที่สําคัญในหน้าแดชบอร์ด
แนวทางปฏิบัติแนะนำสำหรับการตั้งค่าการแจ้งเตือนประสิทธิภาพ
คำขอเครือข่าย
Firebase จะรวบรวมข้อมูลจากคําขอเครือข่ายที่คล้ายกันภายใต้รูปแบบ URL ซึ่งอาจเป็นรูปแบบใดรูปแบบหนึ่งต่อไปนี้
รูปแบบที่ผู้ใช้กําหนด ซึ่งเรียกว่ารูปแบบ URL ที่กําหนดเอง
รูปแบบที่มาจาก 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