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

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

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

การแจ้งเตือนคืออะไร

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

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

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

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

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

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

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

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

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

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

การแสดงภาพหน้าจอ

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

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

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

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

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

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

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

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

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

โดยค่าเริ่มต้น Firebase จะส่งการแจ้งเตือนการตรวจสอบประสิทธิภาพทางอีเมลได้

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

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

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

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

หากต้องการเปิดหรือปิดการแจ้งเตือนการตรวจสอบประสิทธิภาพ ให้ทําตามขั้นตอนต่อไปนี้

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

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

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

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

  1. ตั้งค่า Cloud Functions สำหรับ Firebase ซึ่งมีงานต่อไปนี้

    1. ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์สำหรับ Node.js หรือ Python
    2. ติดตั้งและลงชื่อเข้าใช้ Firebase CLI
    3. เริ่มต้น Cloud Functions for Firebase โดยใช้ Firebase CLI
  2. เขียนและทำให้ฟังก์ชันใช้งานได้ที่ บันทึกเหตุการณ์การแจ้งเตือนจากการตรวจสอบประสิทธิภาพและจัดการเหตุการณ์ เพย์โหลด (เช่น โพสต์ข้อมูลการแจ้งเตือนในข้อความใน Discord)

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

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

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

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

หากไม่เป็นไปตามเงื่อนไขข้อใดข้อหนึ่งเหล่านี้ การตรวจสอบประสิทธิภาพจะนำการแจ้งเตือนออก

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

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

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

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

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

  1. ไปที่แดชบอร์ดของการตรวจสอบประสิทธิภาพ แท็บ ในคอนโซล Firebase แล้วเลือกแอปที่ต้องการ กำหนดค่าการแจ้งเตือน

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

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

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

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

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

  1. ไปที่แดชบอร์ดของการตรวจสอบประสิทธิภาพ แท็บ ในคอนโซล Firebase แล้วเลือกแอปที่ต้องการ กำหนดค่าการแจ้งเตือน

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

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

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

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

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

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

  • รูปแบบที่ผู้ใช้กำหนด ซึ่งเรียกว่า รูปแบบ URL ที่กำหนดเอง

  • รูปแบบที่มาจาก Firebase ซึ่งเรียกว่า รูปแบบ URL อัตโนมัติ
    รูปแบบเหล่านี้อาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไปตามการใช้งานล่าสุดของแอป พฤติกรรมของคุณ

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

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

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

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

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

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

การแสดงภาพหน้าจอ

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