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

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

เมื่อคุณลบรูปแบบ 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 , ผู้ดูแลระบบคุณภาพ Firebase , ผู้ดูแลระบบ Firebase และ เจ้าของหรือผู้แก้ไข โปรเจ็กต์

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