การแก้ไขปัญหาการตรวจสอบประสิทธิภาพและคำถามที่พบบ่อย

วิธีดูข้อความบันทึกสำหรับกิจกรรมด้านประสิทธิภาพ

1. เปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ (เช่น แท็บเครือข่ายสำหรับเครื่องมือ Chrome Dev หรือใน Network Monitor สำหรับ Firefox )

2. รีเฟรชเว็บแอปของคุณในเบราว์เซอร์

3. ตรวจสอบข้อความบันทึกเพื่อหาข้อความแสดงข้อผิดพลาด

4. หลังจากนั้นไม่กี่วินาที ให้มองหาการเรียกเครือข่ายไป firebaselogging.googleapis.com ในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์ของคุณ การมีอยู่ของการโทรเครือข่ายนั้นแสดงว่าเบราว์เซอร์กำลังส่งข้อมูลประสิทธิภาพไปยัง Firebase

หากแอปของคุณไม่บันทึกกิจกรรมด้านประสิทธิภาพ ให้อ่าน เคล็ดลับการแก้ปัญหา

เพิ่ม SDK ลงในแอปแล้ว แต่คอนโซลยังคงบอกว่าจะเพิ่ม SDK

Firebase ตรวจพบว่าคุณได้เพิ่ม SDK การตรวจสอบประสิทธิภาพไปยังแอปของคุณสำเร็จหรือไม่ เมื่อได้รับข้อมูลเหตุการณ์ (เช่น การโต้ตอบของแอป) จากแอปของคุณ โดยปกติภายใน 10 นาทีหลังจากเริ่มต้นแอปของคุณ แดชบอร์ด ประสิทธิภาพ ของคอนโซล Firebase จะแสดงข้อความ "ตรวจพบ SDK" จากนั้น ภายใน 30 นาที แดชบอร์ดจะแสดงข้อมูลที่ประมวลผลเบื้องต้น

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

คอนโซลแจ้งว่าตรวจพบ SDK แต่ไม่มีข้อมูลแสดงขึ้น

การตรวจสอบประสิทธิภาพจะประมวลผลข้อมูลเหตุการณ์ประสิทธิภาพก่อนที่จะแสดงใน แดชบอร์ด ประสิทธิภาพ

หาก เกิน 24 ชั่วโมงแล้วตั้งแต่ที่ข้อความ "ตรวจพบ SDK" ปรากฏขึ้น และคุณยังคงไม่เห็นข้อมูล ให้ตรวจสอบ แดชบอร์ดสถานะ Firebase ในกรณีที่ทราบว่ามีการหยุดทำงาน หากไม่มีเหตุขัดข้อง โปรด ติดต่อฝ่ายสนับสนุนของ Firebase

แอพไม่ได้บันทึกกิจกรรมประสิทธิภาพ

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

1. ตรวจสอบให้แน่ใจว่า Performance Monitoring SDK เริ่มต้น อย่างถูกต้องในแอปของคุณ

2. ตรวจสอบให้แน่ใจ ว่าไม่ได้ ปิดใช้งาน Performance Monitoring SDK ผ่านแฟล็กต่อไปนี้:

   • performance.instrumentationEnabled

3. ตรวจสอบให้แน่ใจว่าการแคชเบราว์เซอร์ของคุณ ถูก ปิดใช้งาน มิฉะนั้น เบราว์เซอร์อาจไม่รับการตั้งค่าเครื่องมือใหม่

4. ปิด แล้วเปิดแท็บหน้าเว็บขึ้นมาใหม่ ตรวจสอบการเข้าสู่ระบบอีกครั้ง

   หากคุณเพิ่งเพิ่ม Performance Monitoring SDK ในแอปของคุณ คุณอาจต้องรีสตาร์ทแอปโดยสมบูรณ์เพื่อให้ SDK เริ่มทำงาน

5. หากคุณไม่พบสิ่งใดที่ปิดใช้งานในแอปของคุณ โปรด ติดต่อฝ่ายสนับสนุนของ Firebase

แดชบอร์ดประสิทธิภาพไม่มีข้อมูลการหน่วงเวลาอินพุตครั้งแรก

หากคุณไม่เห็นข้อมูลสำหรับ เมตริก การหน่วงเวลาอินพุตแรก ให้ลองทำตามขั้นตอนการแก้ปัญหาต่อไปนี้:

1. โปรดทราบว่าการตรวจสอบประสิทธิภาพจะบันทึกเฉพาะเมตริก การหน่วงเวลาอินพุตแรก เมื่อผู้ใช้คลิกบนหน้าเว็บภายใน 5 วินาทีแรกหลังจากการโหลดหน้าเว็บ

2. ตรวจสอบให้แน่ใจว่าคุณได้ตั้งค่าแอปเพื่อวัดเมตริกนี้ เมตริก การหน่วงเวลาอินพุตแรก ต้องมี การตั้งค่า ด้วยตนเอง โดยเฉพาะอย่างยิ่ง คุณต้องเพิ่มไลบรารี polyfill สำหรับเมตริกนี้ สำหรับคำแนะนำในการติดตั้ง โปรดดู เอกสารประกอบ ของไลบรารี

   โปรดทราบว่าการเพิ่มไลบรารี polyfill นี้ไม่จำเป็นสำหรับการตรวจสอบประสิทธิภาพในการรายงานตัววัดเว็บแอปอื่นๆ

แดชบอร์ดประสิทธิภาพไม่มีข้อมูลการติดตามที่กำหนดเอง

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

1. ตรวจสอบการตั้งค่าการติดตามโค้ดแบบกำหนดเองที่ใช้เครื่องมือผ่าน Trace API โดยเฉพาะสิ่งต่อไปนี้:

   • ชื่อสำหรับการติดตามโค้ดที่กำหนดเองและเมตริกที่กำหนดเองต้องเป็นไปตามข้อกำหนดต่อไปนี้: ไม่มีช่องว่างนำหน้าหรือต่อท้าย ไม่มีอักขระขีดล่างนำหน้า ( _ ) และความยาวสูงสุดคือ 32 อักขระ
   • การติดตามทั้งหมดจะต้องเริ่มต้นและหยุด การติดตามใดๆ ที่ไม่ได้เริ่มต้น ไม่หยุด หรือหยุดก่อนที่จะเริ่ม จะไม่ถูกบันทึก

   โปรดทราบว่าหากคุณใช้เมธอด record() คุณไม่จำเป็นต้องเริ่มหรือหยุดการติดตามของคุณอย่างชัดแจ้ง

2. ตรวจสอบให้แน่ใจว่า การรวบรวมข้อมูล Performance Monitoring ไม่ได้ ปิดใช้งาน ผ่านแฟล็กต่อไปนี้:

   • performance.dataCollectionEnabled

     แฟล็กนี้ควบคุมการรวบรวมข้อมูลสำหรับการติดตามโค้ดที่กำหนดเองเท่านั้น (ไม่ใช่ข้อมูลทั้งหมด)

3. ตรวจสอบข้อความบันทึก เพื่อให้แน่ใจว่าการตรวจสอบประสิทธิภาพกำลังบันทึกการติดตามรหัสที่กำหนดเองที่คาดไว้

4. หากการตรวจสอบประสิทธิภาพกำลังบันทึกเหตุการณ์ แต่ไม่มีข้อมูลแสดงหลังจาก 24 ชั่วโมง โปรด ติดต่อฝ่ายสนับสนุนของ Firebase

แดชบอร์ดประสิทธิภาพไม่มีข้อมูลคำขอเครือข่าย

หากคุณไม่มีข้อมูลคำขอเครือข่าย โปรดทราบสิ่งต่อไปนี้:

• การตรวจสอบประสิทธิภาพจะรวบรวมเมตริกสำหรับคำขอเครือข่ายที่รายงานโดย API ของเบราว์เซอร์โดยอัตโนมัติ รายงานเหล่านี้ไม่รวมคำขอเครือข่ายที่ล้มเหลว

• ขึ้นอยู่กับลักษณะการทำงานของโค้ดและไลบรารีเครือข่ายของคุณที่ใช้โดยโค้ดของคุณ การตรวจสอบประสิทธิภาพอาจรายงานเฉพาะคำขอของเครือข่ายที่เสร็จสมบูรณ์เท่านั้น ซึ่งหมายความว่าระบบจะไม่รายงานการเชื่อมต่อ HTTP/S ที่เปิดทิ้งไว้

ข้อมูลคำขอเครือข่ายไม่ได้รวบรวมตามที่คาดไว้

เรียนรู้เพิ่มเติมเกี่ยวกับ วิธีที่การตรวจสอบประสิทธิภาพรวบรวมข้อมูลคำขอเครือข่าย ภายใต้รูปแบบ URL

คุณยังสามารถลองใช้ รูปแบบ URL ที่กำหนดเอง ได้ !

เหตุใดจำนวนตัวอย่างจึงไม่เป็นอย่างที่ฉันคาดหวัง

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

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

• การจำกัดอัตราในอุปกรณ์ : เพื่อป้องกันไม่ให้อุปกรณ์ส่งการสืบค้นกลับอย่างกะทันหัน เราจำกัดจำนวนโค้ดและการติดตามคำขอเครือข่ายที่ส่งจากอุปกรณ์เป็น 300 เหตุการณ์ทุก 10 นาที แนวทางนี้ปกป้องอุปกรณ์จากเครื่องมือวัดแบบวนซ้ำซึ่งสามารถส่งข้อมูลประสิทธิภาพจำนวนมากได้ และป้องกันอุปกรณ์เดียวจากการบิดเบือนการวัดประสิทธิภาพ

• การสุ่มตัวอย่างแบบไดนามิก : การตรวจสอบประสิทธิภาพจะรวบรวมเหตุการณ์ประมาณ 100 ล้านเหตุการณ์สำหรับการติดตามโค้ด และ 100 ล้านรายการสำหรับการติดตามคำขอเครือข่ายต่อแอปสำหรับผู้ใช้แอปทั้งหมด อุปกรณ์จะดึงอัตราการสุ่มตัวอย่างแบบไดนามิก (โดยใช้การกำหนดค่าระยะไกลของ Firebase) เพื่อกำหนดว่าอุปกรณ์สุ่มควรบันทึกและส่งการติดตามหรือไม่ อุปกรณ์ที่ไม่ได้เลือกสำหรับการสุ่มตัวอย่างจะไม่ส่งเหตุการณ์ใดๆ อัตราการสุ่มตัวอย่างแบบไดนามิกเป็นแบบเฉพาะแอปและปรับเพื่อให้แน่ใจว่าปริมาณโดยรวมของข้อมูลที่รวบรวมยังคงต่ำกว่าขีดจำกัด

  เซสชันผู้ใช้ส่งข้อมูลรายละเอียดเพิ่มเติมจากอุปกรณ์ของผู้ใช้ ซึ่งต้องใช้ทรัพยากรมากขึ้นในการเก็บและส่งข้อมูล เพื่อลดผลกระทบของเซสชันผู้ใช้ การตรวจสอบประสิทธิภาพอาจจำกัดจำนวนเซสชันด้วย

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

  • จำนวนการติดตามอาจแตกต่างจากจำนวนครั้งที่เรียกใช้โค้ด
  • ร่องรอยที่เชื่อมโยงอย่างใกล้ชิดในโค้ดแต่ละอันอาจมีจำนวนตัวอย่างต่างกัน

เกิดอะไรขึ้นกับแท็บ ปัญหา ในคอนโซล

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

เกิดอะไรขึ้นกับแท็บ บนอุปกรณ์ และ เครือข่าย ในคอนโซล ฉันจะดูร่องรอยที่อยู่ในหน้าเหล่านั้นได้อย่างไร

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

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

ดูการติดตามของคุณในแท็บย่อยต่อไปนี้ของตารางการติดตาม:

• การติดตามคำขอเครือข่าย (ทั้งแบบสำเร็จรูปและแบบกำหนดเอง) — แท็บย่อย คำขอเครือข่าย
• การติดตามโค้ดที่กำหนดเอง — แท็บย่อยการ ติดตามแบบกำหนดเอง
• การเริ่มแอพ, แอพในเบื้องหน้า, การติดตามแอพในพื้นหลัง — แท็บย่อยการ ติดตามแบบกำหนดเอง
• การติดตามการเรนเดอร์ หน้าจอ — แท็บย่อยการเรนเดอร์หน้าจอ
• การติดตามการโหลด หน้า — แท็บย่อยการโหลดหน้า

สำหรับรายละเอียดเกี่ยวกับตารางการติดตามและการดูตัวชี้วัดและข้อมูล ไปที่หน้าภาพรวมคอนโซล ( iOS+ | Android | เว็บ )

เกิดอะไรขึ้นกับความสามารถในการกำหนดขีดจำกัดสำหรับปัญหาในคอนโซล

การมอนิเตอร์ประสิทธิภาพรองรับการ แจ้งเตือน สำหรับเมทริกที่เกินขีดจำกัดที่กำหนดไว้ เพื่อหลีกเลี่ยงความสับสนกับเกณฑ์ที่กำหนดค่าได้สำหรับเมตริกประสิทธิภาพ เราจึงลบความสามารถในการกำหนดค่าเกณฑ์สำหรับ ปัญหา

ฉันจะเพิ่ม JS SDK ที่มีขนาดเล็กกว่าและมีเนมสเปซ Performance Monitoring (SDK แบบ "สแตนด์อโลน") ให้กับเว็บแอปของฉันได้อย่างไร

หากการตรวจสอบประสิทธิภาพเป็นผลิตภัณฑ์ Firebase เพียงผลิตภัณฑ์เดียวในแอป คุณสามารถใช้ SDK การตรวจสอบประสิทธิภาพแบบสแตนด์อโลน (และสคริปต์ส่วนหัวที่แนะนำด้านล่าง) หากคุณสนใจ:

• โดยใช้ไลบรารีเนมสเปซ
• ลดขนาดแพ็คเกจ SDK ของคุณ
• ชะลอการเริ่มต้นของ SDK จนกว่าจะโหลดหน้าเว็บของคุณ

ในการรวม SDK การมอนิเตอร์ประสิทธิภาพแบบสแตนด์อโลนในแอปของคุณ และชะลอการเริ่มต้นไปเป็นหลังจากโหลดเพจของคุณ:

1. เพิ่มสคริปต์ต่อไปนี้ในส่วนหัวของไฟล์ดัชนีของคุณ
2. อย่าลืมเพิ่ม ออบเจ็กต์การกำหนดค่าโปรเจ็กต์ Firebase ของแอป

(function(sa,fbc){function load(f,c){var a=document.createElement('script');
a.async=1;a.src=f;var s=document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(a,s);}load(sa);
window.addEventListener('load',function(){firebase.initializeApp(fbc).performance()});
})(performance_standalone, firebaseConfig);

ที่ไหน,

• performance_standalone คือ 'https://www.gstatic.com/firebasejs/9.8.1/firebase-performance-standalone.js'
• firebaseConfig คือ ออบเจกต์ Firebase config ของแอปของคุณ

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

(function(sdkSource, firebaseConfigObject) {
   function load(f, c) {
       // Creates a script tag to load the standalone SDK
       var sdkScript = document.createElement('script');

       // Sets it to an async script so that it doesn't interfere with page load
       sdkScript.async = 1;

       // Sets the source of the script
       sdkScript.src = f;

       // Inserts the script into the head of the page
       var s = document.getElementsByTagName('script')[0];
       s.parentNode.insertBefore(sdkScript, s);
   }

   // Calls the load method
   load(sdkSource);

   // Initializes the SDK only when the onload method is called
   window.addEventListener('load', function() {
       firebase.initializeApp(firebaseConfigObject).performance();
   });
})(performance_standalone, firebaseConfig);

ข้อมูลประสิทธิภาพ "ใกล้เรียลไทม์" หมายถึงอะไร

กระบวนการตรวจสอบประสิทธิภาพของ Firebase รวบรวมข้อมูลประสิทธิภาพเมื่อมีเข้ามา ซึ่งส่งผลให้มีการแสดงข้อมูลแบบเกือบเรียลไทม์ในคอนโซล Firebase ข้อมูลที่ประมวลผลจะแสดงในคอนโซลภายในไม่กี่นาทีหลังจากรวบรวม ดังนั้นจึงมีคำว่า "ใกล้เรียลไทม์"

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

ฉันจะรับข้อมูลประสิทธิภาพที่ใกล้เคียงแบบเรียลไทม์สำหรับแอปของฉันได้อย่างไร

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

นี่คือเวอร์ชัน SDK ที่เข้ากันได้แบบเรียลไทม์:

• iOS — v7.3.0 หรือใหม่กว่า
• tvOS — v8.9.0 หรือใหม่กว่า
• Android — v19.0.10 หรือใหม่กว่า (หรือ Firebase Android BoM v26.1.0 หรือใหม่กว่า)
• เว็บ — v7.14.0 หรือใหม่กว่า

โปรดทราบว่าเราแนะนำให้ใช้ SDK เวอร์ชันล่าสุดเสมอ แต่เวอร์ชันใดๆ ที่ระบุไว้ข้างต้นจะเปิดใช้งานการตรวจสอบประสิทธิภาพเพื่อประมวลผลข้อมูลของคุณแบบเกือบเรียลไทม์

Performance Monitoring SDK เวอร์ชันใดที่ถือว่าเข้ากันได้แบบเรียลไทม์

เหล่านี้เป็นเวอร์ชัน SDK ที่เข้ากันได้กับการประมวลผลข้อมูลแบบเรียลไทม์:

• iOS — v7.3.0 หรือใหม่กว่า
• tvOS — v8.9.0 หรือใหม่กว่า
• Android — v19.0.10 หรือใหม่กว่า (หรือ Firebase Android BoM v26.1.0 หรือใหม่กว่า)
• เว็บ — v7.14.0 หรือใหม่กว่า

โปรดทราบว่าเราแนะนำให้ใช้ SDK เวอร์ชันล่าสุดเสมอ แต่เวอร์ชันใดๆ ที่ระบุไว้ข้างต้นจะเปิดใช้งานการตรวจสอบประสิทธิภาพเพื่อประมวลผลข้อมูลของคุณแบบเกือบเรียลไทม์

จะเกิดอะไรขึ้นหากฉันไม่อัปเดตแอปเพื่อใช้เวอร์ชัน SDK ที่เข้ากันได้แบบเรียลไทม์

หากแอปของคุณไม่ได้ใช้เวอร์ชัน SDK ที่เข้ากันได้แบบเรียลไทม์ คุณจะยังคงเห็นข้อมูลประสิทธิภาพของแอปทั้งหมดในคอนโซล Firebase อย่างไรก็ตาม การแสดงข้อมูลประสิทธิภาพจะล่าช้าประมาณ 36 ชั่วโมงนับจากเวลาที่รวบรวม

I've updated to a real-time compatible SDK version, but some of my users are still on old versions of my app. Do I continue to see their performance data in the Firebase console?

Yes! Regardless of which SDK version an app instance uses, you'll see performance data from all your users.

However, if you're looking at recent data (less than roughly 36 hours old), then the displayed data is from users of app instances using a real-time compatible SDK version. The non-recent data, though, includes performance data from all versions of your app.