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

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. ทำตามวิธีการบนหน้าจอเพื่อเลือกรหัสการตอบกลับที่ต้องการ นับเป็นรหัสการตอบกลับที่สำเร็จ