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
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Trang này cung cấp các mẹo khắc phục sự cố để bắt đầu sử dụng Performance Monitoring hoặc sử dụng các tính năng và công cụ của Performance Monitoring.
Các bước kiểm tra đầu tiên để khắc phục sự cố
Hai bước kiểm tra sau đây là các phương pháp hay nhất thường được khuyến nghị cho mọi người trước khi tiến hành khắc phục sự cố thêm.
1. Kiểm tra thông báo nhật ký cho các sự kiện hiệu suất
Kiểm tra thông báo nhật ký để đảm bảo rằng SDK Performance Monitoring đang ghi lại các sự kiện hiệu suất.
Cách xem thông báo nhật ký cho các sự kiện hiệu suất
Bật tính năng ghi nhật ký gỡ lỗi như sau:
Trong Xcode (tối thiểu là phiên bản 16.2), hãy chọn Product (Sản phẩm) > Scheme (Lược đồ) > Edit scheme (Chỉnh sửa lược đồ).
Chọn Run (Chạy) trong trình đơn bên trái, rồi chọn thẻ Arguments (Đối số).
Trong mục Arguments Passed on Launch (Đối số được chuyển khi mở), hãy thêm -FIRDebugEnabled.
Kiểm tra nhật ký thông báo để xem có thông báo lỗi nào không.
Performance Monitoring gắn thẻ tin nhắn nhật ký bằng Firebase/Performance để bạn có thể lọc tin nhắn nhật ký của mình.
Kiểm tra các loại nhật ký sau đây để biết Performance Monitoring có đang ghi lại các sự kiện hiệu suất hay không:
Nếu bạn mới bắt đầu sử dụng Performance Monitoring (iOS+ | Android | Web), các mẹo khắc phục sự cố sau đây có thể giúp giải quyết các sự cố liên quan đến Firebase phát hiện SDK hoặc hiển thị dữ liệu hiệu suất đầu tiên của bạ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 về 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 bạn khởi động ứng dụng, 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 thấy 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 bạn đã thêm phiên bản SDK mới nhất vào ứng dụng của mình hơn 10 phút mà vẫn không thấy thay đổi nào, hãy kiểm tra thông báo nhật ký để đảm bảo rằng Performance Monitoring đang ghi lại 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 sự cố thông báo phát hiện SDK bị trì hoãn.
Ứ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:
Tiếp tục phát triển ứng dụng bằng trình mô phỏng hoặc thiết bị kiểm thử.
Tạo sự kiện bằng cách chuyển đổi ứng dụng của bạn giữa chế độ nền và chế độ nền trước nhiều lần, tương tác với ứng dụng bằng cách di chuyển giữa các màn hình và/hoặc kích hoạt các yêu cầu mạng.
Đảm bảo rằng bạn đã thêm tệp cấu hình Firebase (Google-Service-Info.plist) một cách chính xác vào ứng dụng và bạn chưa sửa đổi tệp này.
Cụ thể, hãy kiểm tra những điều sau:
Tên tệp cấu hình không có ký tự thừa, chẳng hạn như (2).
Tệp cấu hình nằm trong thư mục gốc của dự án XCode và được thêm vào đúng mục tiêu.
Mã ứng dụng Firebase Apple (GOOGLE_APP_ID) có trong tệp cấu hình là mã 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 trong settingsCài đặt dự án.
Nếu có vấn đề với tệp cấu hình trong ứng dụng của bạn, hãy thử làm như sau:
Xoá tệp cấu hình hiện có trong ứng dụng của bạn.
Hãy làm theo các hướng dẫn này để tải một tệp cấu hình mới xuống và thêm tệp đó vào ứng dụng Apple của bạn.
Nếu SDK đang ghi lại các sự kiện và mọi thứ dường 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ố
Nếu bạn đã thêm SDK thành công và đang sử dụng Performance Monitoring trong ứng dụng, các mẹo khắc phục sự cố sau đây có thể giúp giải quyết các sự cố chung liên quan đến tính năng và công cụ Performance Monitoring.
Bảng điều khiển hiệu suất bị thiếu dữ liệu theo dõi màn hình
Nếu bạn thiếu dữ liệu để theo dõi kết xuất màn hình, hãy thử các bước khắc phục sự cố sau:
Đảm bảo rằng bạn đang sử dụng phiên bản mới nhất của Apple Platforms SDK (v12.6.0). Dấu vết kết xuất màn hình chỉ có trong phiên bản 5.0.0 trở lên.
Performance Monitoring không tạo dấu vết kết xuất màn hình cho các bộ điều khiển khung hiển thị vùng chứa (chẳng hạn như UINavigationController và UITabBarController). Nếu chỉ thiếu dữ liệu cho những màn hình này, thì đây là hành vi dự kiến.
Trang tổng quan về hiệu suất bị thiếu dữ liệu dấu vết 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 cho 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 các dấu vết mã tuỳ chỉnh được thiết lập thông qua Trace API, đặc biệt là những dấu vết sau:
Tên cho 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ó 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ự.
Bạn phải bắt đầu và dừng tất cả các dấu vết. Mọi dấu vết chưa bắt đầu, chưa dừng hoặc dừng trước khi bắt đầu sẽ không được ghi lại.
Kiểm tra thông báo nhật ký để đảm bảo rằng Performance Monitoring đang ghi nhật ký các dấu vết mã tuỳ chỉnh dự kiến.
Nếu Performance Monitoring đang ghi lại các 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 bị thiếu dữ liệu yêu cầu mạng
Nếu bạn bị 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:
Tùy thuộc vào hành vi của mã và các thư viện mạng mà mã của bạn 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 vẫn đang mở có thể không được báo cáo.
Performance Monitoring 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 vẫn sẽ được chấp nhận.
Có chuyện 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 để tiếp nối việc ra mắt gần đây tính năng cảnh báo. 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á. Các vấn đề hiện đã không còn được hỗ trợ nữa và được thay thế bằng cảnh báo.
Bộ chọn ứng dụng ở đầu thẻ Hiệu suất sẽ lọc các mục cảnh báo trong mục Cảnh báo gần đây. Chỉ có ba cảnh báo gần đây nhất cho ứng dụng đã chọn mới được hiển thị.
Vậy còn khả năng đặt ngưỡng cho các vấn đề trong bảng điều khiển thì sao?
Performance Monitoring hỗ trợ cảnh báo cho những chỉ số vượt quá ngưỡng đã xác định. Để tránh nhầm lẫn với các ngưỡng có thể cấu hình này cho số liệu hiệu suất, chúng tôi đã loại bỏ khả năng cấu hình 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ế trang Chi tiết và trang Chỉ số bằng một giao diện người dùng (UI) tập trung mới đượ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 cùng chức năng cốt lõi như Chi tiết và Số liệu. Để 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ừ các thiết bị người dùng của ứ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 liên quan đến hiệu suất, thì Performance Monitoring có thể giới hạn việc thu thập dữ liệu đối với 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ị số liệu vẫn đại diện cho 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 lựa 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 đột ngột hàng loạt dấu vết, chúng tôi giới hạn số lượng dấu vết mã và yêu cầu mạng được gửi từ một thiết bị là 300 sự kiện sau 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 vòng lặp có thể gửi một lượng lớn dữ liệu hiệu suất và ngăn chặn một thiết bị duy nhất làm sai lệch các phép đo hiệu suất.
Lấy mẫu động: Performance Monitoring thu thập một số lượng hạn chế các dấu vết mã và dấu vết yêu cầu mạng cho 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 lấy 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 ghi lại 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 tùy thuộc vào từng ứng dụng và được điều chỉnh để đảm bảo tổng khối lượng dữ liệu thu thập được luôn ở mức dưới giới hạn.
Những dự án đã bật tính năng tích hợp BigQuery sẽ nhận được giới hạn cao hơn về số lượng dấu vết yêu cầu mạng.
Phiên người dùng gửi dữ liệu chi tiết bổ sung 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, 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 các ứ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 số liệu của chúng tôi, nhưng nó có thể gây ra những thay đổi nhỏ trong mô hình, bao gồm:
Số lượng dấu vết có thể khác nhau tùy theo số lần thực thi một đoạn mã.
Các dấu vết được liên kết 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ế thẻ Vấn đề bằng tính năng Cảnh báo. Tính năng này sẽ tự động thông báo cho bạn khi ngưỡng bạn đặt bị vượt quá. 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 một 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.
Đ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 thế nào để tôi xem được các dấu vết trên những trang đó?
Chúng tôi đã thiết kế lại phần Performance Monitoring của bảng điều khiển Firebase để tab Bảng điều khiển hiển thị các số liệu 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 đã xóa các trang Trên thiết bị và Mạng.
Bảng theo dõi ở cuối tab Bảng điều khiển có tất cả thông tin giống như thông tin hiển thị trên tab Trên thiết bị và Mạng, nhưng có thêm một số tính năng, bao gồm khả năng sắp xếp theo dõi theo phần trăm thay đổi cho một số liệu cụ thể. Để xem tất cả cá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 các dấu vết của bạn trong các thẻ phụ sau đây của bảng dấu vết:
Theo dõi yêu cầu mạng (cả sẵn có và tùy chỉnh) — tab 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
Dấu vết khởi động ứng dụng, ứng dụng ở chế độ nền trước, ứng dụng ở chế độ nền sau — tab phụ Dấu vết tùy chỉnh
Dấu vết kết xuất màn hình – thẻ phụ Kết xuất màn hình
Theo dõi tải trang — tab phụ Tải trang
Để biết thông tin chi tiết về bảng dấu vết và cách xem các chỉ số và dữ liệu, hãy truy cập vào trang tổng quan về bảng điều khiển (iOS+ | Android | Web).
Tại sao số lượng khung hình chậm và đóng băng 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 giả định của thiết bị 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 được kết xuất hơ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ị đóng băng được báo cáo vì nhiều khung hình sẽ được kết xuất chậm hơn hoặc bị đóng băng. 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 hiển thị nhanh hơn.
Điều này có thể khiến ít khung hình bị chậm hoặc bị treo được báo cáo hơn. Đây là một hạn chế hiện tại trong SDK Performance Monitoring.
Dữ liệu Performance Monitoring của tôi mất nhiều thời gian hơn dự kiến để xuất sang BigQuery. Có phải không phải là thời gian thực không?
Nếu bạn đã bật tính năng tích hợp BigQuery cho Firebase Performance Monitoring, 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 (theo giờ Thái Bình Dương).
Ví dụ: dữ liệu cho ngày 19 tháng 4 sẽ có trong BigQuery vào ngày 20 tháng 4 trong khoảng thời gian từ 12:00 đến 24:00 (tất cả ngày và giờ đều theo giờ Thái Bình Dương).
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 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 được gửi đến, nhờ đó dữ liệu được hiển thị gần như theo thời gian thực trong bảng điều khiển Firebase. Dữ liệu đã xử lý sẽ xuất hiện trong bảng điều khiển trong vòng vài phút sau khi được thu thập, do đó có thuật ngữ "gần như theo thời gian thực".
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 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 nên sử dụng phiên bản SDK mới nhất, nhưng mọi phiên bản được liệt kê ở trên sẽ 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 với 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 mọi phiên bản được liệt kê ở trên sẽ cho phép Performance Monitoring xử lý dữ liệu của bạn gần như theo thời gian thực.
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 với 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, 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ị chậm 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ể ứng dụng sử dụng phiên bản SDK nào, bạn sẽ thấy dữ liệu hiệu suất từ 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 không quá 36 giờ), thì dữ liệu hiển thị là từ 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 gần đây bao gồm dữ liệu hiệu suất của tất cả các phiên bản ứng dụng.
