Khắc phục sự cố và câu hỏi thường gặp về tính năng Giám sát hiệu suất

Cách xem thông điệp nhật ký cho các sự kiện hiệu suất

1. Mở công cụ dành cho nhà phát triển của trình duyệt (ví dụ: thẻ Mạng cho Công cụ dành cho nhà phát triển Chrome hoặc trong Trình giám sát mạng cho Firefox).

2. Làm mới ứng dụng web của bạn trong trình duyệt.

3. Kiểm tra thông điệp nhật ký của bạn để xem có thông báo lỗi nào không.

4. Sau vài giây, hãy tìm cuộc gọi mạng đến firebaselogging.googleapis.com trong công cụ cho nhà phát triển của trình duyệt. Chiến lược phát hành đĩa đơn sự hiện diện của lệnh gọi mạng đó cho thấy trình duyệt đang gửi hiệu suất dữ liệu sang Firebase.

Nếu ứng dụng của bạn không ghi lại các sự kiện về hiệu suất, hãy xem phần khắc phục sự cố .

Thêm SDK vào ứng dụng nhưng thêm vào bảng điều khiển vẫn nói là 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 hay chưa khi ứng dụng nhận được thông tin sự kiện (như lượt tương tác với ứng dụng) từ ứng dụng của bạn. Thường trong vòng 10 phút sau khi khởi động ứng dụng, Hiệu suất trang tổng quan trên bảng điều khiển Firebase 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 đã quá 10 phút kể từ khi bạn thêm phiên bản SDK mới nhất vào ứng dụng của bạn mà bạn vẫn không thấy bất kỳ thay đổi nào, hãy kiểm tra nhật ký messages để đảm bảo rằng Performance Monitoring đang ghi nhật ký sự kiện. Hãy thử các bước khắc phục sự cố phù hợp như mô tả dưới đây để khắc phục sự cố thông báo phát hiện SDK bị trì hoãn.

Bảng điều khiển cho biết SDK là đã phát hiện, nhưng không có dữ liệu nào được hiển thị

Performance Monitoring xử lý dữ liệu sự kiện hiệu suất trước khi hiển thị dữ liệu đó trong Trang tổng quan về Hiệu suất.

Nếu đã hơn 24 giờ kể từ khi thông báo "Đã phát hiện SDK" xuất hiện mà bạn vẫn không thấy dữ liệu, hãy kiểm tra Trang tổng quan trạng thái Firebase trong trường hợp có sự cố đã biết. Nếu không có sự cố ngừng hoạt động, hãy liên hệ với Nhóm hỗ trợ Firebase.

Ứng dụng không ghi nhật ký sự kiện hiệu suất

Nếu bạn không thấy thông báo nhật ký về hiệu suất sự kiện, hãy thử các bước khắc phục sự cố sau đây:

1. Đảm bảo rằng SDK Performance Monitoring đang hoạt động đúng cách đã khởi chạy trong .

2. Đảm bảo rằng SDK Performance Monitoring không bị tắt thông qua cờ sau:

   • performance.instrumentationEnabled

3. Hãy đảm bảo rằng bạn đã tắt tính năng lưu vào bộ nhớ đệm của trình duyệt, nếu không thì trình duyệt có thể không chọn bất kỳ chế độ cài đặt đo lường mới nào.

4. Đóng rồi mở lại thẻ trang web. Hãy kiểm tra lại để tìm nhật ký.

   Nếu vừa thêm SDK Performance Monitoring vào ứng dụng, bạn có thể phải cập nhật đầy đủ khởi động lại ứng dụng để SDK bắt đầu làm việc.

5. Nếu bạn không tìm thấy tính năng nào bị tắt trong ứng dụng của mình, liên hệ với Bộ phận hỗ trợ Firebase.

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 độ trễ đầu vào lần đầu , hãy thử các bước khắc phục sự cố sau đây:

1. Xin lưu ý rằng Performance Monitoring chỉ ghi lại chỉ số độ trễ đầu vào đầu tiên khi một người dùng nhấp vào trang web trong vòng 5 giây đầu tiên sau khi tải trang.

2. Đảm bảo rằng bạn đã thiết lập ứng dụng để đo lường chỉ số này. Chiến lược phát hành đĩa đơn chỉ số độ trễ nhập đầu tiên yêu cầu thủ công thiết lập. Cụ thể, bạn cần thêm thư viện polyfill cho chỉ số này. Để hướng dẫn cài đặt, hãy tham khảo hướng dẫn của thư viện tài liệu.

   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 về ứng dụng web.

Trang tổng quan về hiệu suất là 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 đây:

1. Kiểm tra việc thiết lập dấu vết mã tuỳ chỉnh được đo lường qua Trace API, đặc biệt là những tính năng sau:

   • Tên cho dấu vết mã và chỉ số tuỳ chỉnh phải đáp ứng các yêu cầu sau yêu cầu: không có khoảng trắng ở đầu hoặc ở cuối, không có dấu gạch dưới ở đầu (_) ký tự và độ 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 chưa bắt đầu đã dừng hoặc đã ngừng trước khi bắt đầu sẽ không được ghi nhật ký.

   Xin lưu ý rằng nếu bạn đang sử dụng record() thì bạn không cần bắt đầu hoặc dừng dấu vết của mình một cách rõ ràng.

2. Đảm bảo rằng Performance Monitoring thu thập dữ liệu không bị vô hiệu hoá thông qua cờ sau:

   • performance.dataCollectionEnabled

     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).

3. 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.

4. Nếu Performance Monitoring đang ghi nhật ký sự kiện, nhưng không có dữ liệu nào hiển thị sau 24 giờ, 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 bị thiếu dữ liệu về yêu cầu mạng, hãy lưu ý những điều sau:

• Performance Monitoring tự động thu thập chỉ số cho các yêu cầu mạng được báo cáo bởi API trình duyệt. Những báo cáo này không bao gồm các yêu cầu mạng không thực hiện được.

• 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ể sẽ không được báo cáo.

Dữ liệu về yêu cầu mạng không tổng hợp như dự kiến

Tìm hiểu thêm về cách Performance Monitoring tổng hợp yêu cầu mạng trong mẫu URL.

Bạn cũng có thể thử mẫu URL tuỳ chỉnh!

Điều gì đã xảy ra với 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ế Các vấn đề hàng đầu bằng Cảnh báo gần đây để cập nhật thông tin cho gần đây là các cảnh báo tự động thông báo cho bạn khi ngưỡng bạn đặt ra đã vượt qua. 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ảnh báo mục nhập trong Cảnh báo gần đây. Chỉ ba cảnh báo gần đây nhất cho (các) ứng dụng đã chọn sẽ được hiển thị.

Để tìm hiểu thêm 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.

Khả năng đặt ngưỡng cho các vấn đề trong bảng điều khiển đã bị gì?

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 chúng tôi đã xóa 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 mới được thiết kế lại, tập trung ở giao diện người dùng (UI) để cải thiện cách bạn khắc phục sự cố. Thông tin mới này Giao diện người dùng khắc phục sự cố cung cấp chức năng cốt lõi giống với tính năng Chi tiết và Chỉ số được cung cấp. Để tìm hiểu thêm về cách khắc phục sự cố, hãy xem Xem thêm dữ liệu về một dấu vết cụ thể.

Tại sao số lượng mẫu không phải là số lượng tôi mong đợi?

Performance Monitoring thu thập dữ liệu hiệu suất từ các thiết bị của người dùng trong ứng dụng của bạn. 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 phản ánh trải nghiệm ứng dụng của người dùng.

Để quản lý lượng dữ liệu chúng tôi thu thập, Performance Monitoring sử dụng các phương thức sau tuỳ chọn lấy mẫu:

• Giới hạn tốc độ trên thiết bị: Để ngăn một thiết bị gửi các cụm từ đột ngột chúng tôi sẽ giới hạn số lượng mã và dấu vết yêu cầu mạng được gửi từ thiết bị của bạn lên 300 sự kiện cứ 10 phút một lần. Phương pháp này bảo vệ thiết bị khỏi những thiết bị đo lường theo vòng lặp có thể gửi một lượng lớn dữ liệu về hiệu suất, và giúp 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 giới hạn khoảng 100 triệu các sự kiện đối với dấu vết mã và 100 triệu sự kiện đối với dấu vết yêu cầu mạng cho mỗi ứng dụng mỗi ngày cho tất cả người dùng ứng dụng. Tốc độ lấy mẫu động được tìm nạp trên 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. 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ỷ lệ lấy mẫu động là tuỳ theo ứng dụng và điều chỉnh thành đảm bảo rằng tổng lượng dữ liệu được thu thập vẫn ở dưới giới hạn.

  Phiên hoạt động của người dùng sẽ gửi dữ liệu bổ sung, chi tiết từ thiết bị của người dùng và yêu cầu 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 người dùng thì Performance Monitoring cũng có thể hạn chế số phiên.

• Giới hạn số lượng yêu cầu phía máy chủ: Để đảm bảo rằng các ứng dụng không vượt quá tần suất lấy mẫu hạn mức, Performance Monitoring có thể sử dụng phương thức lấy mẫu phía máy chủ để bỏ một số sự kiện nhận được từ các thiết bị. Mặc dù loại giới hạn này không thay đổi mức độ hiệu quả của các chỉ số, điều đó có thể gây ra những thay đổi nhỏ về mẫu hình, bao gồm sau:

  • 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 kết hợp chặt chẽ trong mã, mỗi dấu vết có thể có số lượng mẫu.

Điều gì đã xảy ra 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 thủ công bảng điều khiển Firebase để xác định trạng thái của ngưỡng. Để tìm hiểu về Cảnh báo, hãy xem Thiết lập cảnh báo cho các vấn đề về hiệu suất.

Điều gì đã xảy ra 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 cho thấy các chỉ số chính và tất cả dấu vết của bạn trong cùng một không gian. Như trong thiết kế mới, chúng tôi đã xoá trang Trên thiết bị và Mạng.

Bảng dấu vết ở cuối thẻ Trang tổng quan có toàn bộ thông tin thông tin mà thẻ Trên thiết bị và Mạng hiển thị, nhưng kèm theo một số các tính năng đã thêm, bao gồm khả năng sắp xếp dấu vết của bạn theo tỷ lệ phần trăm thay đổi đối với một chỉ số cụ thể. Để xem tất cả chỉ số và dữ liệu cho một dấu vết, hãy nhấp vào tên dấu vết trong bảng dấu vết.

Xem dấu vết của bạn trong các thẻ phụ sau của bảng dấu vết:

• Dấu vết yêu cầu mạng (cả ngay lập tức và tùy chỉnh) — phụ Yêu cầu mạng
• Dấu vết mã tùy chỉnh — tab phụ Dấu vết tùy chỉnh
• Bắt đầu ứng dụng, trong nền trước ứng dụng, dấu vết trong nền ứng dụng — thẻ phụ 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ẻ phụ Tải trang

Để biết chi tiết về bảng theo dõi cũng như xem số liệu và dữ liệu, hãy truy cập vào trang tổng quan của bảng điều khiển (iOS+ | Android | Web).

Tại sao số 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, mỗi khung hình sẽ có thời gian kết xuất chậm hơn vì có ít khung hình hơn được kết xuất trên mỗi giây. Thời gian kết xuất chậm hơn có thể khiến nhiều khung hình chậm hoặc bị treo được báo cáo vì có nhiều khung hình hơn sẽ kết xuất chậm hơn hoặc sẽ 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. Việc này có thể khiến báo cáo ít khung hình chậm hoặc bị treo hơn. Đây là một giới hạn 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 của bạn, bạn có thể sử dụng phương thức 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:

• dùng một thư viện 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 khi trang của bạn tải

Để đưa SDK Performance Monitoring độc lập vào ứng dụng của bạn và trì hoãn SDK đó sau khi trang của bạn tải:

1. Thêm tập lệnh sau vào tiêu đề của tệp chỉ mục.
2. Hãy nhớ thêm Đối tượng cấu hình dự án 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);

ở đâu,

• performance_standalone là 'https://www.gstatic.com/firebasejs/10.13.1/firebase-performance.js'
• firebaseConfig là đối tượng cấu hình Firebase của ứng dụng

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 sẽ giảm tác động của SDK đối với chỉ số tải trang vì trình duyệt đã đã báo cáo chỉ số tải khi bạn khởi chạy 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);

"Gần thời gian thực" có nghĩa là gì dữ liệu hiệu suất có nghĩa là gì?

Firebase Performance Monitoring xử lý dữ liệu hiệu suất đã thu thập ngay khi có dữ liệu 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".

Để tận dụng quy trình xử lý dữ liệu gần như theo thời gian thực, hãy đảm bảo ứng dụng của bạn sử dụng SDK tương thích theo thời gian thực phiên bản.

Làm cách nào để nhận dữ liệu hiệu suất gần với thời gian thực cho ứng dụng của tôi?

Để tận dụng khả năng xử lý dữ liệu gần như theo thời gian thực, bạn chỉ cần đảm bảo ứng dụng của bạn sử dụng phiên bản SDK Performance Monitoring tương thích với ứng dụng theo thời gian thực xử lý dữ liệu.

Dưới đây là các phiên bản SDK tương thích với 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.

Những phiên bản nào của SDK Performance Monitoring đượ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 nên sử dụng phiên bản SDK mới nhất, nhưng bất kỳ phiên bản nêu trên sẽ cho phép Performance Monitoring xử lý dữ liệu của bạn gần như bất cứ lúc nào.

Nếu tôi không cập nhật ứng dụng để dùng phiên bản SDK tương thích theo thời gian thực thì sao?

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, 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, màn hình dữ liệu hiệu suất sẽ bị trễ khoảng 36 giờ kể từ thời điểm bộ sưu tập.

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 của tôi trên các phiên bản cũ của ứng dụng. Tôi có tiếp tục thấy hiệu suất của chúng không trong bảng điều khiển Firebase?

Có! Bất kể phiên bản SDK nào sử dụng, bạn đều thấy rằng 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 (cách đây chưa đầy 36 giờ), thì dữ liệu hiển thị là dữ liệu từ người dùng của các phiên bản ứng dụng theo thời gian thực phiên bản SDK tương thích. Tuy nhiên, dữ liệu không gần đây bao gồm cả dữ liệu hiệu suất từ mọi phiên bản ứng dụng.