Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

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

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

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

อย่างไรก็ตาม บางครั้ง คุณต้องปรับแต่งวิธีที่ Firebase รวบรวมข้อมูลคำขอเครือข่ายเฉพาะเพื่อรองรับกรณีการใช้งานของแอปของคุณได้ดียิ่งขึ้น เรามีสองวิธีให้คุณปรับแต่งการรวมข้อมูลสำหรับคำขอของเครือข่าย: รวบรวมข้อมูลภายใต้รูปแบบ 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 ที่กำหนดเองมากกว่าหนึ่งรูปแบบ Firebase จะจับคู่คำขอกับรูปแบบ URL ที่กำหนดเองที่ เจาะจงที่สุด เท่านั้น ตามลำดับความเฉพาะเจาะจงต่อไปนี้: ข้อความธรรมดา > * > ** จากซ้ายไปขวาในเส้นทาง ตัวอย่างเช่น คำขอที่ example.com/books/dog ตรงกับรูปแบบ URL ที่กำหนดเองสองรูปแบบ:

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

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

เมื่อคุณสร้างรูปแบบ URL ที่กำหนดเองใหม่ โปรดระวังสิ่งต่อไปนี้:

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

  • เฉพาะคำขอ ในอนาคต เท่านั้นที่ได้รับผลกระทบจากการสร้างรูปแบบ URL ที่กำหนดเองใหม่ คุณอาจต้องรอถึง 12 ชั่วโมงเพื่อให้การตรวจสอบประสิทธิภาพรวบรวมและรวบรวมข้อมูลภายใต้รูปแบบ 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. คลิก ที่ด้านขวาสุดของแถว เลือก Remove custom pattern จากนั้นยืนยันการลบในกล่องโต้ตอบ

เมื่อคุณลบรูปแบบ 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 Admin , Firebase Quality Admin , Firebase Admin และ Project Owner or Editor

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