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

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

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

สิ่งใดที่ทริกเกอร์การแจ้งเตือน

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. ในคอนโซล Firebase ที่มุมขวาบน ให้ไปที่ การแจ้งเตือน Firebase
  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 จะตรวจสอบการแจ้งเตือนเพื่อให้แน่ใจว่าข้อมูลถูกต้องและมีการใช้งานการแจ้งเตือนอยู่ การแจ้งเตือนจะถือว่าถูกต้องหากเป็นไปตามเงื่อนไขข้อใดข้อหนึ่งต่อไปนี้

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

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

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

หากต้องการกำหนดค่าการแจ้งเตือน Performance Monitoring คุณต้องมีสิทธิ์ firebaseperformance.config.update บทบาทต่อไปนี้มีสิทธิ์ที่จำเป็นนี้โดยค่าเริ่มต้น ได้แก่ ผู้ดูแลระบบ Firebase Performance, ผู้ดูแลระบบ Firebase Quality, ผู้ดูแลระบบ 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