ปรับแต่งการรวมข้อมูลคำขอเครือข่าย

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

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

รวบรวมข้อมูลภายใต้รูปแบบ URL ที่กำหนดเอง

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

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

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

การจับคู่รูปแบบ URL ที่กำหนดเองทำงานอย่างไร

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

หาก URL ของคำขอตรงกับรูปแบบ URL ที่กำหนดเองมากกว่า 1 รูปแบบ Firebase จะแมป คำขอให้ตรงกับรูปแบบ URL ที่กำหนดเองที่ เฉพาะเจาะจงที่สุดเท่านั้น โดยพิจารณาตาม ลำดับความเฉพาะเจาะจงต่อไปนี้: ข้อความธรรมดา > * > ** จากซ้ายไป ขวาในเส้นทาง ตัวอย่างเช่น คำขอไปยัง example.com/books/dog จะตรงกับรูปแบบ URL ที่กำหนดเอง 2 รูปแบบ ได้แก่

  • example.com/books/*
  • example.com/*/dog

อย่างไรก็ตาม รูปแบบ example.com/books/* เป็นรูปแบบ URL ที่ตรงกันที่ เฉพาะเจาะจงที่สุด เนื่องจาก กลุ่มด้านซ้ายสุด books ใน example.com/books/* มีลำดับความสำคัญสูงกว่า กลุ่มด้านซ้ายสุด * ใน example.com/*/dog

เมื่อสร้างรูปแบบ URL ที่กำหนดเองใหม่ โปรดทราบสิ่งต่อไปนี้

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

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

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

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

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

คุณสร้างรูปแบบ URL ที่กำหนดเองทั้งหมดได้สูงสุด 400 รูปแบบต่อแอป และสร้างรูปแบบ URL ที่กำหนดเองได้สูงสุด 100 รูปแบบต่อโดเมนสำหรับแอปนั้น

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

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

ตารางต่อไปนี้อธิบายการจับคู่รูปแบบ URL ที่กำหนดเองที่อาจเกิดขึ้น

หากต้องการจับคู่... ให้สร้างรูปแบบ URL ที่กำหนดเอง เช่น... ตัวอย่างการจับคู่รูปแบบ URL นี้
URL ที่ตรงกันทุกประการ example.com/foo/baz example.com/foo/baz
กลุ่มเส้นทางเดียว (*) example.com/*/baz example.com/foo/baz
example.com/bar/baz
example.com/*/*/baz example.com/foo/bar/baz
example.com/bah/qux/baz
example.com/foo/* example.com/foo/baz
example.com/foo/bar

หมายเหตุ: รูปแบบนี้จะไม่ตรงกับ example.com/foo.
คำต่อท้ายเส้นทางที่กำหนดเอง (**) example.com/foo/** example.com/foo
example.com/foo/baz
example.com/foo/baz/more/segments
subdomain.example.com/foo.bar/** subdomain.example.com/foo.bar
subdomain.example.com/foo.bar/baz
subdomain.example.com/foo.bar/baz/more/segments
กลุ่มโดเมนย่อยกลุ่มแรก (*) *.example.com/foo bar.example.com/foo
baz.example.com/foo

ดูรูปแบบ URL ที่กำหนดเองและข้อมูลของรูปแบบ

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

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

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

นำรูปแบบ URL ที่กำหนดเองออก

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

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

  2. เลือก รูปแบบที่กำหนดเองจากเมนูแบบเลื่อนลงในแท็บย่อย คำขอเครือข่าย

  3. วางเมาส์เหนือแถวของรูปแบบ URL ที่กำหนดเองที่ต้องการนำออก

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

เมื่อนำรูปแบบ URL ที่กำหนดเองออก โปรดทราบสิ่งต่อไปนี้

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

  • การนำรูปแบบ URL ที่กำหนดเองออกจะไม่ส่งผลต่อการจับคู่และข้อมูลที่รวบรวมจากคำขอ ก่อนหน้า

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

  • แท็บย่อย คำขอเครือข่าย (โดยเลือก รูปแบบที่กำหนดเอง) จะไม่แสดงรูปแบบ URL ที่กำหนดเองที่นำออก

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

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

ปรับแต่งวิธีคำนวณอัตราความสำเร็จ

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

โดยเฉพาะอย่างยิ่ง Firebase จะนับคำขอเครือข่ายที่มีรหัสการตอบกลับในช่วง 100-399 เป็นการตอบกลับที่สำเร็จโดยอัตโนมัติ

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

ตัวอย่างเช่น หากแอปมี API ปลายทางของการค้นหา คุณสามารถนับการตอบกลับ 404 เป็น "สำเร็จ" ได้เนื่องจากคาดว่าการตอบกลับ 404 จะเกิดขึ้นสำหรับปลายทางการค้นหา สมมติว่ามีตัวอย่าง 100 รายการสำหรับปลายทางการค้นหานี้ทุกชั่วโมง โดย 60 รายการเป็นการตอบกลับ 200 และ 40 รายการเป็นการตอบกลับ 404 ก่อนที่คุณจะกำหนดค่าอัตราความสำเร็จ อัตราความสำเร็จจะเป็น 60% หลังจากที่คุณกำหนดค่าการคำนวณอัตราความสำเร็จให้นับการตอบกลับ 404 เป็นสำเร็จแล้ว อัตราความสำเร็จจะเป็น 100%

กำหนดค่าการคำนวณอัตราความสำเร็จ

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

  1. ไปที่แท็บ Performance Monitoring แดชบอร์ด ในคอนโซล Firebase แล้วเลือกแอปที่ต้องการ กำหนดค่าการคำนวณอัตราความสำเร็จ
  2. เลื่อนลงไปที่ตารางการติดตามที่ด้านล่างของหน้าจอ แล้วเลือกแท็บคำขอเครือข่าย
  3. ค้นหารูปแบบ URL ที่ต้องการกำหนดค่าการคำนวณอัตราความสำเร็จ
  4. เปิดเมนูรายการเพิ่มเติม () ที่ด้านขวาสุดของแถว แล้วเลือกกำหนดค่าอัตราความสำเร็จ
  5. ทำตามวิธีการบนหน้าจอเพื่อเลือกรหัสการตอบกลับที่ต้องการนับเป็นรหัสการตอบกลับที่สำเร็จ