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

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

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

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

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

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

Firebase จะแสดงรูปแบบ URL ทั้งหมด (รวมถึงรูปแบบ 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

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

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

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

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

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

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

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

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

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

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

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

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