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

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

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

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

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