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

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

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