Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

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

การตรวจสอบประสิทธิภาพของ 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 ที่กำหนดเอง 2 รูปแบบ:

  • 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. ทำตามคำแนะนำบนหน้าจอเพื่อเลือกรหัสตอบกลับที่คุณต้องการนับเป็นรหัสตอบกลับที่สำเร็จ