Câu hỏi thường gặp và khắc phục sự cố Giám sát hiệu suất

Cách xem thông điệp bản ghi cho các sự kiện hiệu suất

1. Bật ghi nhật ký gỡ lỗi, như sau:

   1. Trong Xcode (tối thiểu v14.1), chọn Sản phẩm > Lược đồ > Chỉnh sửa lược đồ .
   2. Chọn Chạy từ menu bên trái, sau đó chọn tab Đối số .
   3. Trong phần Đối số được truyền khi khởi chạy , hãy thêm -FIRDebugEnabled .

2. Kiểm tra thông báo nhật ký của bạn để biết bất kỳ thông báo lỗi nào.

3. Giám sát hiệu suất gắn thẻ thông điệp tường trình của nó với Firebase/Performance để bạn có thể lọc thông điệp tường trình của mình.

4. Kiểm tra các loại nhật ký sau đây cho biết Giám sát hiệu suất đang ghi nhật ký các sự kiện hiệu suất:

   • Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
   • Logging network request trace: URL

5. Nhấp vào URL để xem dữ liệu của bạn trong bảng điều khiển Firebase. Có thể mất vài phút để cập nhật dữ liệu trong trang tổng quan.

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

Đã thêm SDK vào ứng dụng nhưng bảng điều khiển vẫn báo thêm SDK

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

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

Giám sát hiệu suất xử lý dữ liệu sự kiện hiệu suất trước khi hiển thị nó trong bảng điều khiển 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, thì hãy kiểm tra Trang tổng quan trạng thái Firebase trong trường hợp có sự cố ngừng hoạt động đã biết. Nếu không có sự cố ngừng hoạt động, hãy liên hệ với Bộ phận hỗ trợ của Firebase .

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

Nếu bạn không nhìn thấy thông báo bản ghi cho các sự kiện hiệu suất , hãy thử các bước khắc phục sự cố sau:

1. Đảm bảo rằng SDK giám sát hiệu suất không bị vô hiệu hóa thông qua một trong các cờ sau trong tệp Info.plist của bạn:

   • firebase_performance_collection_enabled
   • firebase_performance_collection_deactivated

2. Đảm bảo rằng Giám sát hiệu suất không bị tắt khi chạy ( Swift | Obj-C ).

3. Nếu bạn không thể tìm thấy bất kỳ thứ gì bị vô hiệu hóa trong ứng dụng của mình, hãy liên hệ với Bộ phận hỗ trợ của Firebase .

Bảng điều khiển hiệu suất thiếu dữ liệu theo dõi màn hình

Nếu bạn đang thiếu dữ liệu cho dấu vết kết xuất màn hình, hãy thử các bước khắc phục sự cố sau:

Bảng điều khiển hiệu suất thiếu dữ liệu theo dõi tùy chỉnh

Bạn có thấy dữ liệu hiệu suất cho dấu vết được thu thập tự động nhưng không phải cho dấu vết mã tùy chỉnh không ? Hãy thử các bước khắc phục sự cố sau:

1. Kiểm tra việc thiết lập các dấu vết mã tùy chỉnh được cung cấp thông qua Trace API , đặc biệt là các dấu vết sau:

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

2. Kiểm tra thông báo nhật ký của bạn để đảm bảo rằng Giám sát hiệu suất đang ghi lại các dấu vết mã tùy chỉnh dự kiến.

3. Nếu Giám sát hiệu suất đang ghi nhật ký 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 Bộ phận hỗ trợ của Firebase .

Bảng điều khiển 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 thử các bước khắc phục sự cố sau:

1. Kiểm tra sự không tương thích của thư viện mạng. Giám sát hiệu suất tự động thu thập số liệu cho các yêu cầu mạng sử dụng các thư viện mạng sau:

   • Đối với Swift: URLSession và URLConnection
   • Đối với Mục tiêu-C: NSURLSession và NSURLConnection

   Lưu ý rằng bạn có thể thêm giám sát tùy chỉnh cho các yêu cầu mạng .

2. Hãy nhận biết những điều sau đây:

   • Tùy thuộc vào hành vi của mã và thư viện mạng mà mã của bạn sử dụng, Giám sát hiệu suất có thể chỉ báo cáo về các yêu cầu mạng đã hoàn thành. Đ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.

   • Giám sát hiệu suất không báo cáo về các yêu cầu mạng có tiêu đề Content-Type không hợp lệ. Tuy nhiên, các yêu cầu mạng không có tiêu đề Content-Type sẽ vẫn được chấp nhận.

Dữ liệu yêu cầu mạng không được tổng hợp như mong đợi

Tìm hiểu thêm về cách Giám sát hiệu suất tổng hợp dữ liệu yêu cầu mạng theo các mẫu URL.

Bạn cũng có thể thử các mẫu URL tùy 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 như là phần tiếp theo của việc giới thiệu cảnh báo gần đây của chúng tôi, cảnh báo này sẽ tự động thông báo cho bạn khi các ngưỡng bạn đặt bị vượt qua. Sự cố hiện không được dùng nữa và được thay thế bằng cảnh báo.

Bộ chọn ứng dụng ở đầu thẻ Hiệu suất lọc các mục cảnh báo trong Cảnh báo Gần đây . Chỉ có ba cảnh báo gần đây nhất cho (các) ứng dụng đã chọn được hiển thị.

Để tìm hiểu thêm 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 khả năng đặt ngưỡng cho sự cố trong bảng điều khiển?

Giám sát hiệu suất 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ỉ số hiệu suất, chúng tôi đã loại bỏ khả năng định cấu hình các ngưỡng cho sự cố .

Điều gì đã xảy ra với thông tin Chi tiết và Số liệu trong bảng điều khiển Firebase?

Chúng tôi đã thay thế các trang Chi tiết và Số liệu bằng giao diện người dùng (UI) tập trung, được thiết kế lại mớ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 cùng chức năng cốt lõi mà Chi tiết và Chỉ số đã 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 cho một dấu vết cụ thể .

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

Giám sát hiệu suất thu thập dữ liệu hiệu suất từ ​​các thiết bị người dùng của ứ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ì Giám sát hiệu suất có thể giới hạn việc thu thập dữ liệu ở một nhóm nhỏ thiết bị để giảm số lượng sự kiện được xử lý. Các giới hạn này đủ cao để ngay cả khi có ít sự kiện hơn, các giá trị chỉ số vẫn đại diện cho trải nghiệm ứng dụng của người dùng.

Để quản lý khối lượng dữ liệu mà chúng tôi thu thập, Giám sát hiệu suất sử dụng các tùy 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 mã và dấu vết yêu cầu mạng được gửi từ một thiết bị ở mức 300 sự kiện cứ sau 10 phút. Cách tiếp cận này bảo vệ thiết bị khỏi các thiết bị đo vòng lặp có thể gửi một lượng lớn dữ liệu hiệu suất và ngăn không cho một thiết bị làm sai lệch các phép đo hiệu suất.

• Lấy mẫu động : Giám sát hiệu suất thu thập khoảng 100 triệu sự kiện cho dấu vết mã và 100 triệu cho dấu vết yêu cầu mạng trên mỗi ứng dụng 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 Cấu hình từ xa Firebase) để xác định xem một thiết bị ngẫu nhiên có nên chụp và gửi dấu vết hay không. Mộ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ốc độ lấy mẫu động dành riêng cho ứng dụng và điều chỉnh để đảm bảo rằng tổng khối lượng dữ liệu được thu thập vẫn ở dưới mức giới hạn.

  Phiên người dùng gửi dữ liệu bổ sung, chi tiết từ thiết bị của người dùng, 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 phiên người dùng, Giám sát hiệu suất 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 các ứng dụng không vượt quá giới hạn lấy mẫu, Giám sát hiệu suất có thể sử dụng phương pháp 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 thay đổi hiệu quả của các chỉ số của chúng tôi, nhưng nó có thể gây ra những thay đổi nhỏ về mô hình, bao gồm những điều sau:

  • Số dấu vết có thể khác với số lần một đoạn mã được thực thi.
  • Mỗi dấu vết được kết hợp chặt chẽ trong mã có thể có số lượng mẫu khác nhau.

Điều gì đã xảy ra với tab Sự cố trong bảng điều khiển?

Chúng tôi đã thay thế tab Sự cố bằng việc giới thiệu Cảnh báo, tự động thông báo cho bạn khi vượt quá ngưỡng bạn đặt. Bạn không còn 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. Để 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 tab Trên thiết bị và Mạng trong bảng điều khiển? Làm cách nào để xem các dấu vết trên các trang đó?

Chúng tôi đã thiết kế lại phần Giám sát hiệu suất của bảng điều khiển Firebase để tab Trang tổng quan hiển thị các chỉ số chính và tất cả các dấu vết của bạn trong một không gian. Là một phần của thiết kế lại, chúng tôi đã xóa các trang Trên thiết bị và Mạng .

Bảng theo dõi ở cuối tab Trang tổng quan có tất cả thông tin giống như tab Trên thiết bị và Mạng được hiển thị, nhưng có thêm một số tính năng, bao gồm khả năng sắp xếp các dấu vết của bạn theo phần trăm thay đổi đối với một số liệu cụ thể. Để xem tất cả các số liệu 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 của bạn trong các tab con sau của bảng dấu vết:

• Dấu vết yêu cầu mạng (cả có sẵn và tùy chỉnh) — Tab phụ yêu cầu mạng
• Dấu vết mã tùy chỉnh — Tab con dấu vết tùy chỉnh
• Dấu vết khởi động ứng dụng, ứng dụng ở nền trước, ứng dụng ở chế độ nền — Tab phụ Dấu vết tùy chỉnh
• Dấu vết kết xuất màn hình — Tab con kết xuất màn hình
• Dấu vết tải trang — Tab 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 trang tổng quan về bảng điều khiển ( iOS+ | Android | Web ).

Tại sao số khung hình chậm và đơ không như tôi mong đợi?

Khung 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 60Hz, thì 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 mỗi giây. Thời gian hiển thị 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 hiển thị 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 60Hz, mỗi khung hình sẽ có thời gian kết xuất nhanh hơn. Điều này có thể làm cho số khung hình bị chậm hoặc bị treo ít hơn được báo cáo. Đây là giới hạn hiện tại trong SDK giám sát hiệu suất.

Dữ liệu Giám sát hiệu suất của tôi mất nhiều thời gian hơn dự kiến ​​để xuất sang BigQuery. Nó không phải là thời gian thực?

Nếu bạn đã bật tích hợp BigQuery cho Giám sát hiệu suất Firebase, dữ liệu của bạn sẽ được xuất sang BigQuery từ 12 đến 24 giờ sau khi kết thúc ngày (Giờ Thái Bình Dương).

Ví dụ: dữ liệu cho ngày 19 tháng 4 sẽ có sẵn trong BigQuery vào ngày 20 tháng 4 từ 12:00 trưa đến nửa đêm (tất cả ngày và giờ đều là Giờ Thái Bình Dương).

What does "near real-time" performance data mean?

Firebase Performance Monitoring processes collected performance data as it comes in, which results in near real-time data display in the Firebase console. Processed data displays in the console within a few minutes of its collection, hence the term "near real-time".

To take advantage of near real-time data processing, make sure your app uses a real-time compatible SDK version .

How do I get near real-time performance data for my app?

To take advantage of near real-time data processing, you only need to make sure that your app uses a Performance Monitoring SDK version that's compatible with real-time data processing.

These are the real-time compatible SDK versions:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

Which versions of the Performance Monitoring SDK are considered real-time compatible?

These are the SDK versions compatible with real-time data processing:

• iOS — v7.3.0 or later
• tvOS — v8.9.0 or later
• Android — v19.0.10 or later (or Firebase Android BoM v26.1.0 or later)
• Web — v7.14.0 or later

Note that we always recommend using the latest version of SDK, but any version listed above will enable Performance Monitoring to process your data in near real time.

What if I don't update my app to use a real-time compatible SDK version?

If your app doesn't use a real-time compatible SDK version, you will still see all your app's performance data in the Firebase console. However, the display of performance data will be delayed by roughly 36 hours from the time of its collection.

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.