Kiểm tra thông điệp nhật ký để xem có thông báo lỗi nào không.
Sau vài giây, hãy tìm lệnh gọi mạng đến firebaselogging.googleapis.com trong công cụ dành cho nhà phát triển của trình duyệt. Sự hiện diện của lệnh gọi mạng đó cho biết trình duyệt đang gửi dữ liệu hiệu suất đến Firebase.
Nếu bạn đang bắt đầu sử dụng Performance Monitoring (iOS trở lên | Android | Web), các mẹo khắc phục sự cố sau đây có thể giúp bạn giải quyết các vấn đề liên quan đến việc Firebase phát hiện SDK hoặc hiển thị dữ liệu hiệu suất đầu tiên trong bảng điều khiển Firebase.
Đã thêm SDK vào ứng dụng, nhưng bảng điều khiển vẫn yêu cầu thêm SDK
Firebase có thể phát hiện xem bạn đã thêm thành công SDK Performance Monitoring vào ứng dụng của mình hay chưa khi nhận được thông tin sự kiện (chẳng hạn như lượt tương tác với ứng dụng) từ ứng dụng. Thông thường, trong vòng 10 phút kể từ khi khởi động ứng dụng, Bảng điều khiển
về hiệu suất
của bảng điều khiển Firebase sẽ hiển thị thông báo "Phát hiện SDK". Sau đó, trong vòng 30 phút, trang tổng quan sẽ hiển thị dữ liệu đã xử lý ban đầu.
Nếu đã hơn 10 phút kể từ khi bạn thêm phiên bản SDK mới nhất vào ứng dụng và bạn vẫn không thấy thay đổi nào, hãy kiểm tra thông điệp nhật ký để đảm bảo rằng Performance Monitoring đang ghi nhật ký các sự kiện. Hãy thử các bước khắc phục sự cố thích hợp như mô tả bên dưới để khắc phục thông báo phát hiện SDK bị trễ.
Ứng dụng đang ghi nhật ký sự kiện: các bước khắc phục sự cố
Nếu bạn vẫn đang phát triển cục bộ, hãy thử tạo thêm sự kiện để thu thập dữ liệu:
Phân phát và xem ứng dụng web trong môi trường cục bộ.
Tạo sự kiện bằng cách tải các trang con cho trang web, tương tác với ứng dụng và/hoặc kích hoạt các yêu cầu mạng. Hãy nhớ mở thẻ trình duyệt trong ít nhất 10 giây sau khi trang tải.
Đảm bảo rằng đối tượng cấu hình Firebase được thêm chính xác vào ứng dụng và bạn chưa sửa đổi đối tượng đó. Cụ thể, hãy kiểm tra những vấn đề sau:
Mã ứng dụng web Firebase (appId) trong đối tượng cấu hình là chính xác cho ứng dụng của bạn. Tìm mã ứng dụng Firebase trong thẻ Ứng dụng của bạn của Cài đặt dự ánsettings.
Nếu có điều gì đó không ổn với đối tượng cấu hình trong ứng dụng, hãy thử làm như sau:
Xoá đối tượng cấu hình mà bạn hiện có trong ứng dụng.
Làm theo hướng dẫn này để lấy một đối tượng cấu hình mới và thêm đối tượng đó vào ứng dụng web.
Nếu SDK đang ghi lại sự kiện và mọi thứ có vẻ như đã được thiết lập đúng cách, nhưng bạn vẫn không thấy thông báo phát hiện SDK hoặc dữ liệu đã xử lý (sau 2 giờ), hãy liên hệ với Nhóm hỗ trợ Firebase.
Ứng dụng không ghi nhật ký sự kiện:
các bước khắc phục sự cố
Đảm bảo rằng SDK Performance Monitoring được khởi chạy chính xác trong ứng dụng.
Đảm bảo rằng SDK Performance Monitoringkhông bị tắt thông qua cờ sau:
performance.instrumentationEnabled
Đảm bảo rằng tính năng lưu vào bộ nhớ đệm của trình duyệt đã tắt, nếu không, trình duyệt có thể không nhận được bất kỳ chế độ cài đặt đo lường mới nào.
Đóng rồi mở lại thẻ trang web. Kiểm tra lại việc ghi nhật ký.
Nếu mới thêm SDK Performance Monitoring vào ứng dụng, bạn có thể cần khởi động lại hoàn toàn ứng dụng để SDK bắt đầu hoạt động.
Nếu bạn đã thêm thành công SDK và đang sử dụng Performance Monitoring trong ứng dụng, thì các mẹo khắc phục sự cố sau đây có thể giúp bạn giải quyết các vấn đề chung liên quan đến tính năng và công cụ Performance Monitoring.
Đảm bảo rằng SDK Performance Monitoring được khởi chạy chính xác trong ứng dụng.
Đảm bảo rằng SDK Performance Monitoringkhông bị tắt thông qua cờ sau:
performance.instrumentationEnabled
Đảm bảo rằng tính năng lưu vào bộ nhớ đệm của trình duyệt đã tắt, nếu không, trình duyệt có thể không nhận được bất kỳ chế độ cài đặt đo lường mới nào.
Đóng rồi mở lại thẻ trang web. Kiểm tra lại việc ghi nhật ký.
Nếu mới thêm SDK Performance Monitoring vào ứng dụng, bạn có thể cần khởi động lại hoàn toàn ứng dụng để SDK bắt đầu hoạt động.
Trang tổng quan về hiệu suất thiếu dữ liệu về độ trễ đầu vào đầu tiên
Nếu bạn không thấy dữ liệu cho chỉ số độ trễ đầu vào đầu tiên, hãy thử các bước khắc phục sự cố sau:
Xin lưu ý rằng Performance Monitoring chỉ ghi lại chỉ số độ trễ đầu vào đầu tiên khi người dùng nhấp vào trang web trong vòng 5 giây đầu tiên sau khi tải trang.
Hãy đảm bảo rằng bạn đã thiết lập ứng dụng để đo lường chỉ số này. Bạn cần thiết lập thủ công để sử dụng chỉ số thời gian phản hồi lần tương tác đầu tiên.
Cụ thể, bạn cần thêm thư viện polyfill cho chỉ số này. Để biết hướng dẫn cài đặt, hãy tham khảo tài liệu của thư viện.
Xin lưu ý rằng bạn không bắt buộc phải thêm thư viện polyfill này để Performance Monitoring báo cáo các chỉ số khác của ứng dụng web.
Trang tổng quan về hiệu suất bị thiếu dữ liệu theo dõi tuỳ chỉnh
Bạn có thấy dữ liệu hiệu suất cho các dấu vết được thu thập tự động nhưng không thấy dữ liệu hiệu suất cho các dấu vết mã tuỳ chỉnh không? Hãy thử các bước khắc phục sự cố sau:
Kiểm tra chế độ thiết lập dấu vết mã tuỳ chỉnh được đo lường thông qua Trace API, đặc biệt là những thông tin sau:
Tên của dấu vết mã tuỳ chỉnh và chỉ số tuỳ chỉnh phải đáp ứng các yêu cầu sau: không có dấu cách ở đầu hoặc cuối, không có ký tự dấu gạch dưới (_) ở đầu và có độ dài tối đa là 32 ký tự.
Tất cả dấu vết phải được bắt đầu và dừng. Mọi dấu vết không bắt đầu, không dừng hoặc dừng trước khi bắt đầu sẽ không được ghi lại.
Xin lưu ý rằng nếu đang sử dụng phương thức record(), bạn không cần phải bắt đầu hoặc dừng dấu vết một cách rõ ràng.
Cờ này chỉ kiểm soát việc thu thập dữ liệu cho các dấu vết mã tuỳ chỉnh (không phải tất cả dữ liệu).
Kiểm tra thông điệp nhật ký để đảm bảo rằng Performance Monitoring đang ghi lại dấu vết mã tuỳ chỉnh dự kiến.
Nếu Performance Monitoring đang ghi lại sự kiện nhưng không có dữ liệu nào hiển thị sau 24 giờ, hãy liên hệ với Nhóm hỗ trợ Firebase.
Trang tổng quan về hiệu suất thiếu dữ liệu yêu cầu mạng
Nếu bạn thiếu dữ liệu yêu cầu mạng, hãy lưu ý những điều sau:
Performance Monitoring tự động thu thập các chỉ số cho các yêu cầu mạng do API trình duyệt báo cáo. Những báo cáo này không bao gồm các yêu cầu mạng không thành công.
Tuỳ thuộc vào hành vi của mã và thư viện kết nối mạng mà mã sử dụng, Performance Monitoring có thể chỉ báo cáo về các yêu cầu mạng đã hoàn tất.
Điều này có nghĩa là các kết nối HTTP/S đang mở có thể không được báo cáo.
Điều gì đã xảy ra với thẻ Các vấn đề hàng đầu trong thẻ Hiệu suất trên Trang chủ dự án?
Chúng tôi đã thay thế mục Các vấn đề hàng đầu bằng mục Cảnh báo gần đây để tiếp nối việc ra mắt tính năng cảnh báo gần đây. Tính năng này sẽ tự động thông báo cho bạn khi các ngưỡng mà bạn đặt bị vượt quá. Chúng tôi hiện không còn sử dụng vấn đề mà thay vào đó là cảnh báo.
Bộ chọn ứng dụng ở đầu thẻ Hiệu suất sẽ lọc các mục nhập cảnh báo trong phần Thông báo gần đây. Chỉ hiển thị 3 cảnh báo gần đây nhất cho(các) ứng dụng đã chọn.
Khả năng đặt ngưỡng cho các vấn đề trong bảng điều khiển đã bị gì vậy?
Performance Monitoring hỗ trợ cảnh báo cho các chỉ số vượt quá ngưỡng đã xác định. Để tránh nhầm lẫn với các ngưỡng có thể định cấu hình này cho các chỉ số hiệu suất, chúng tôi đã xoá khả năng định cấu hình ngưỡng cho vấn đề.
Điều gì đã xảy ra với thông tin Chi tiết và Chỉ số trong bảng điều khiển Firebase?
Chúng tôi đã thay thế các trang Chi tiết và Chỉ số bằng một giao diện người dùng (UI) tập trung, được thiết kế lại để cải thiện cách bạn khắc phục sự cố. Giao diện người dùng khắc phục sự cố mới này cung cấp chức năng cốt lõi giống như Thông tin chi tiết và Chỉ số. Để tìm hiểu thêm về cách khắc phục sự cố, hãy xem phần Xem thêm dữ liệu cho một dấu vết cụ thể.
Tại sao số lượng mẫu không như tôi mong đợi?
Performance Monitoring thu thập dữ liệu hiệu suất từ thiết bị của người dùng ứng dụng. Nếu ứng dụng của bạn có nhiều người dùng hoặc nếu ứng dụng tạo ra một lượng lớn hoạt động hiệu suất, thì Performance Monitoring có thể giới hạn việc thu thập dữ liệu ở một số thiết bị để giảm số lượng sự kiện được xử lý. Các hạn mức này đủ cao để ngay cả khi có ít sự kiện hơn, các giá trị chỉ số vẫn thể hiện trải nghiệm ứng dụng của người dùng.
Để quản lý lượng dữ liệu mà chúng tôi thu thập, Performance Monitoring sử dụng các tuỳ chọn lấy mẫu sau:
Giới hạn tốc độ trên thiết bị: Để ngăn thiết bị gửi các dấu vết đột ngột, chúng tôi giới hạn số lượng dấu vết yêu cầu mạng và mã được gửi từ thiết bị ở mức 300 sự kiện mỗi 10 phút. Phương pháp này bảo vệ thiết bị khỏi các thiết bị đo lường lặp lại có thể gửi một lượng lớn dữ liệu hiệu suất, đồng thời ngăn một thiết bị làm sai lệch kết quả đo lường hiệu suất.
Lấy mẫu động: Performance Monitoring thu thập một số lượng hạn chế dấu vết mã và dấu vết yêu cầu mạng trên mỗi ứng dụng hằng ngày trên tất cả người dùng ứng dụng. Tốc độ lấy mẫu động được tìm nạp trên các thiết bị (sử dụng Firebase Remote Config) để xác định xem một thiết bị ngẫu nhiên có nên thu thập và gửi dấu vết hay không. Thiết bị không được chọn để lấy mẫu sẽ không gửi bất kỳ sự kiện nào. Tốc độ lấy mẫu động là dành riêng cho ứng dụng và điều chỉnh để đảm bảo tổng dung lượng dữ liệu được thu thập vẫn nằm dưới giới hạn.
Phiên người dùng gửi thêm dữ liệu chi tiết từ thiết bị của người dùng, đòi hỏi nhiều tài nguyên hơn để thu thập và gửi dữ liệu. Để giảm thiểu tác động của các phiên người dùng, Performance Monitoring cũng có thể hạn chế số lượng phiên.
Giới hạn tốc độ phía máy chủ: Để đảm bảo rằng ứng dụng không vượt quá giới hạn lấy mẫu, Performance Monitoring có thể sử dụng tính năng lấy mẫu phía máy chủ để loại bỏ một số sự kiện nhận được từ thiết bị. Mặc dù loại giới hạn này không làm thay đổi hiệu quả của các chỉ số, nhưng có thể gây ra một số thay đổi nhỏ về mẫu, bao gồm:
Số lượng dấu vết có thể khác với số lần một đoạn mã được thực thi.
Các dấu vết được ghép nối chặt chẽ trong mã có thể có số lượng mẫu khác nhau.
Đã xảy ra chuyện gì với thẻ Vấn đề trong bảng điều khiển?
Chúng tôi đã thay thế thẻ Vấn đề bằng thẻ Cảnh báo. Thẻ này sẽ tự động thông báo cho bạn khi bạn vượt quá ngưỡng đã đặt. Bạn không cần phải kiểm tra bảng điều khiển Firebase theo cách thủ công để xác định trạng thái của ngưỡng nữa. Để tìm hiểu về Cảnh báo, hãy xem bài viết Thiết lập cảnh báo cho các vấn đề về hiệu suất.
Đã xảy ra chuyện gì với thẻ Trên thiết bị và Mạng trong bảng điều khiển?
Làm cách nào để xem dấu vết trên các trang đó?
Chúng tôi đã thiết kế lại phần Performance Monitoring của bảng điều khiển Firebase để thẻ Trang tổng quan hiển thị các chỉ số chính và tất cả dấu vết của bạn trong một không gian. Trong quá trình thiết kế lại, chúng tôi đã xoá các trang Trên thiết bị và Mạng.
Bảng dấu vết ở cuối thẻ Trang tổng quan có tất cả thông tin giống như các thẻ Trên thiết bị và Mạng hiển thị, nhưng có thêm một số tính năng, bao gồm cả khả năng sắp xếp dấu vết theo tỷ lệ phần trăm thay đổi cho một chỉ số cụ thể. Để xem tất cả chỉ số và dữ liệu cho một dấu vết cụ thể, hãy nhấp vào tên dấu vết trong bảng dấu vết.
Xem dấu vết trong các thẻ con sau đây của bảng dấu vết:
Dấu vết yêu cầu mạng (cả sẵn có và tuỳ chỉnh) — Thẻ con Yêu cầu mạng
Dấu vết mã tuỳ chỉnh — Thẻ con Dấu vết tuỳ chỉnh
Dấu vết khởi động ứng dụng, dấu vết ứng dụng ở nền trước, dấu vết ứng dụng ở chế độ nền — thẻ con Dấu vết tuỳ chỉnh
Dấu vết kết xuất màn hình — Thẻ con Kết xuất màn hình
Dấu vết tải trang — Thẻ con Tải trang
Để biết thông tin chi tiết về bảng dấu vết và xem các chỉ số cũng như dữ liệu, hãy truy cập vào trang tổng quan về bảng điều khiển (iOS trở lên | Android | Web).
Tại sao số lượng khung hình chậm và bị treo không như tôi mong đợi?
Khung hình kết xuất chậm và khung hình bị treo được tính toán với tốc độ làm mới thiết bị giả định là 60Hz. Nếu tốc độ làm mới của thiết bị thấp hơn 60 Hz, thì mỗi khung hình sẽ có thời gian kết xuất chậm hơn vì số khung hình được kết xuất mỗi giây ít hơn.
Thời gian kết xuất chậm hơn có thể khiến nhiều khung hình bị chậm hoặc bị treo hơn được báo cáo vì nhiều khung hình sẽ được kết xuất chậm hơn hoặc bị treo. Tuy nhiên, nếu tốc độ làm mới của thiết bị cao hơn 60 Hz, thì mỗi khung hình sẽ có thời gian kết xuất nhanh hơn.
Điều này có thể khiến ít khung hình bị chậm hoặc bị treo hơn được báo cáo. Đây là hạn chế hiện tại trong SDK Performance Monitoring.
Làm cách nào để thêm SDK JS Performance Monitoring nhỏ hơn, có không gian tên (SDK "độc lập") vào ứng dụng web của tôi?
Nếu Performance Monitoring là sản phẩm Firebase duy nhất trong ứng dụng, bạn có thể sử dụng SDK Performance Monitoring độc lập (và tập lệnh tiêu đề được đề xuất bên dưới) nếu bạn quan tâm đến:
sử dụng thư viện có không gian tên
giảm kích thước gói SDK
trì hoãn việc khởi chạy SDK cho đến sau khi trang tải
Để đưa SDK Performance Monitoring độc lập vào ứng dụng và trì hoãn việc khởi chạy SDK này sau khi trang tải:
Tập lệnh ở trên tải không đồng bộ SDK độc lập, sau đó khởi chạy Firebase sau khi sự kiện onload của cửa sổ kích hoạt. Chiến thuật này làm giảm tác động mà SDK có thể gây ra đối với các chỉ số tải trang vì trình duyệt đã báo cáo các chỉ số tải của trình duyệt khi bạn khởi chạy SDK.
Tìm hiểu về SDK Performance Monitoring độc lập và tập lệnh tiêu đề
SDK độc lập này được tối ưu hoá về kích thước; nén bằng Gzip, kích thước khoảng 10kb. Thư viện này có tất cả chức năng của Firebase Performance Monitoring cùng với một bộ chức năng tối thiểu của SDK lõi Firebase.
Firebase Performance Monitoring sử dụng các API fetch và Promise không có trên các trình duyệt cũ. Các polyfill cho các API này được đưa vào SDK JS Firebase Performance Monitoring tiêu chuẩn, nhưng bị bỏ qua khỏi SDK độc lập để giảm kích thước.
SDK Performance Monitoring một phần dựa vào API Thời gian tài nguyên để lấy các chỉ số tải trang từ trình duyệt.
Đoạn mã sau đây phân tích tập lệnh tiêu đề bao gồm sau đó trì hoãn việc khởi chạy SDK:
(function(sdkSource,firebaseConfigObject){functionload(f,c){//CreatesascripttagtoloadthestandaloneSDKvarsdkScript=document.createElement('script');//Setsittoanasyncscriptsothatitdoesn't interfere with page loadsdkScript.async=1;//SetsthesourceofthescriptsdkScript.src=f;//Insertsthescriptintotheheadofthepagevars=document.getElementsByTagName('script')[0];s.parentNode.insertBefore(sdkScript,s);}//Callstheloadmethodload(sdkSource);//InitializestheSDKonlywhentheonloadmethodiscalledwindow.addEventListener('load',function(){firebase.initializeApp(firebaseConfigObject).performance();});})(performance_standalone,firebaseConfig);
trong đó,
performance_standalone là 'https://www.gstatic.com/firebasejs/11.0.2/firebase-performance-standalone.js'
Xử lý và hiển thị dữ liệu gần như theo thời gian thực
Dữ liệu hiệu suất "gần như theo thời gian thực" có nghĩa là gì?
Firebase Performance Monitoring xử lý dữ liệu hiệu suất đã thu thập khi dữ liệu đó đến, dẫn đến việc hiển thị dữ liệu gần như theo thời gian thực trong bảng điều khiển Firebase. Dữ liệu đã xử lý sẽ hiển thị trong bảng điều khiển trong vòng vài phút sau khi thu thập, do đó có thuật ngữ "gần như theo thời gian thực".
Làm cách nào để lấy dữ liệu hiệu suất gần như theo thời gian thực cho ứng dụng của tôi?
Để tận dụng tính năng xử lý dữ liệu gần như theo thời gian thực, bạn chỉ cần đảm bảo rằng ứng dụng của mình sử dụng phiên bản SDK Performance Monitoring tương thích với tính năng xử lý dữ liệu theo thời gian thực.
Sau đây là các phiên bản SDK tương thích theo thời gian thực:
iOS – Phiên bản 7.3.0 trở lên
tvOS – Phiên bản 8.9.0 trở lên
Android – Phiên bản 19.0.10 trở lên (hoặc Firebase Android BoM phiên bản 26.1.0 trở lên)
Web – Phiên bản 7.14.0 trở lên
Xin lưu ý rằng bạn luôn nên sử dụng phiên bản SDK mới nhất, nhưng mọi phiên bản nêu trên đều cho phép Performance Monitoring xử lý dữ liệu của bạn gần như theo thời gian thực.
Phiên bản SDK Performance Monitoring nào được coi là tương thích theo thời gian thực?
Sau đây là các phiên bản SDK tương thích với tính năng xử lý dữ liệu theo thời gian thực:
iOS – Phiên bản 7.3.0 trở lên
tvOS – Phiên bản 8.9.0 trở lên
Android – Phiên bản 19.0.10 trở lên (hoặc Firebase Android BoM phiên bản 26.1.0 trở lên)
Web – Phiên bản 7.14.0 trở lên
Xin lưu ý rằng bạn luôn nên sử dụng phiên bản SDK mới nhất, nhưng mọi phiên bản nêu trên đều cho phép Performance Monitoring xử lý dữ liệu của bạn gần như theo thời gian thực.
Điều gì sẽ xảy ra nếu tôi không cập nhật ứng dụng để sử dụng phiên bản SDK tương thích theo thời gian thực?
Nếu ứng dụng của bạn không sử dụng phiên bản SDK tương thích theo thời gian thực, thì bạn vẫn sẽ thấy tất cả dữ liệu hiệu suất của ứng dụng trong bảng điều khiển Firebase. Tuy nhiên, việc hiển thị dữ liệu hiệu suất sẽ bị trễ khoảng 36 giờ kể từ thời điểm thu thập dữ liệu.
Tôi đã cập nhật lên phiên bản SDK tương thích theo thời gian thực, nhưng một số người dùng vẫn đang sử dụng các phiên bản cũ của ứng dụng. Tôi có tiếp tục thấy dữ liệu hiệu suất của họ trong bảng điều khiển Firebase không?
Có! Bất kể phiên bản SDK nào mà một thực thể ứng dụng sử dụng, bạn sẽ thấy dữ liệu hiệu suất của tất cả người dùng.
Tuy nhiên, nếu bạn đang xem dữ liệu gần đây (dưới khoảng 36 giờ), thì dữ liệu hiển thị là của người dùng các phiên bản ứng dụng sử dụng phiên bản SDK tương thích theo thời gian thực. Tuy nhiên, dữ liệu không phải gần đây bao gồm dữ liệu hiệu suất từ tất cả phiên bản ứng dụng.