Trước khi bắt đầu
Nếu bạn chưa có, hãy thêm Firebase vào dự án Android của bạn .
Bước 1 : Thêm SDK giám sát hiệu suất vào ứng dụng của bạn
Sau khi bạn đã thêm SDK giám sát hiệu suất, Firebase sẽ tự động bắt đầu thu thập dữ liệu để hiển thị màn hình của ứng dụng và dữ liệu liên quan đến vòng đời của ứng dụng (chẳng hạn như thời gian bắt đầu ứng dụng ). Để bật Firebase giám sát các yêu cầu mạng, bạn cũng phải thêm plugin Cấp độ giám sát hiệu suất (bước tiếp theo).
Trong tệp Gradle mô-đun (cấp ứng dụng) của bạn (thường là
<project>/<app-module>/build.gradle
), hãy thêm phần phụ thuộc cho thư viện Android Giám sát hiệu suất. Chúng tôi khuyên bạn nên sử dụng Firebase Android BoM để kiểm soát việc lập phiên bản thư viện.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.0') // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf-ktx' }
Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android Firebase.
(Thay thế) Thêm phụ thuộc thư viện Firebase mà không cần sử dụng BoM
Nếu chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.
Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf-ktx:20.3.2' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.0') // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf' }
Bằng cách sử dụng Firebase Android BoM , ứng dụng của bạn sẽ luôn sử dụng các phiên bản tương thích của thư viện Android Firebase.
(Thay thế) Thêm phụ thuộc thư viện Firebase mà không cần sử dụng BoM
Nếu chọn không sử dụng Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phụ thuộc của nó.
Lưu ý rằng nếu bạn sử dụng nhiều thư viện Firebase trong ứng dụng của mình, chúng tôi thực sự khuyên bạn nên sử dụng BoM để quản lý các phiên bản thư viện, điều này đảm bảo rằng tất cả các phiên bản đều tương thích.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation 'com.google.firebase:firebase-perf:20.3.2' }
Biên dịch lại ứng dụng của bạn.
Bước 2 : Thêm plugin Cấp độ giám sát hiệu suất vào ứng dụng của bạn
Sau khi bạn đã thêm plugin Cấp độ giám sát hiệu suất, Firebase sẽ tự động bắt đầu thu thập dữ liệu cho các yêu cầu mạng HTTP/S . Plugin này cũng cho phép bạn thiết lập các dấu vết mã tùy chỉnh bằng cách sử dụng chú thích @AddTrace .
Trong tệp Gradle cấp gốc (cấp dự án) (
<project>/build.gradle
), hãy thêm plugin Cấp giám sát hiệu suất dưới dạng phụ thuộc bản dựng:buildscript { repositories { // Make sure that you have the following two repositories google() // Google's Maven repository mavenCentral() // Maven Central repository } dependencies { ... // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 classpath 'com.android.tools.build:gradle:7.2.0' // Make sure that you have the Google services Gradle plugin dependency classpath 'com.google.gms:google-services:4.3.15' // Add the dependency for the Performance Monitoring Gradle plugin classpath 'com.google.firebase:perf-plugin:1.4.2' } }
Trong tệp Gradle mô -đun (cấp ứng dụng) của bạn (thường là
<project>/<app-module>/build.gradle
), hãy thêm plugin Cấp độ giám sát hiệu suất:plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' ... }
Biên dịch lại ứng dụng của bạn.
Bước 3 : Tạo các sự kiện hiệu suất để hiển thị dữ liệu ban đầu
Firebase bắt đầu xử lý các sự kiện khi bạn thêm thành công SDK vào ứng dụng của mình. Nếu bạn vẫn đang phát triển tại địa phương, hãy tương tác với ứng dụng của bạn để tạo các sự kiện nhằm thu thập và xử lý dữ liệu ban đầu.
Tạo sự kiện bằng cách chuyển ứng dụng của bạn giữa nền và nền trước nhiều lần, tương tác với ứng dụng của bạn bằng cách điều hướng trên các màn hình và/hoặc kích hoạt yêu cầu mạng.
Chuyển đến bảng điều khiển Hiệu suất của bảng điều khiển Firebase. Bạn sẽ thấy dữ liệu ban đầu của mình hiển thị trong vòng vài phút.
Nếu bạn không thấy hiển thị dữ liệu ban đầu của mình, hãy xem lại các mẹo khắc phục sự cố .
Bước 4 : (Tùy chọn) Xem thông báo bản ghi cho các sự kiện hiệu suất
Bật ghi nhật ký gỡ lỗi cho Giám sát hiệu suất tại thời điểm xây dựng bằng cách thêm phần tử
<meta-data>
vào tệpAndroidManifest.xml
của ứng dụng, như sau:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
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.
Giám sát hiệu suất gắn thẻ thông báo nhật ký của nó với
FirebasePerformance
. Sử dụng tính năng lọc logcat, bạn có thể xem cụ thể nhật ký theo dõi thời lượng và ghi nhật ký yêu cầu mạng HTTP/S bằng cách chạy lệnh sau:adb logcat -s FirebasePerformance
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
-
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ố .
Bước 5 : (Tùy chọn) Thêm giám sát tùy chỉnh cho mã cụ thể
Để giám sát dữ liệu hiệu suất được liên kết với mã cụ thể trong ứng dụng của bạn, bạn có thể cung cấp dấu vết mã tùy chỉnh .
Với theo dõi mã tùy chỉnh, bạn có thể đo thời gian ứng dụng của mình hoàn thành một tác vụ hoặc nhóm tác vụ cụ thể, chẳng hạn như tải một nhóm hình ảnh hoặc truy vấn cơ sở dữ liệu của bạn. Số liệu mặc định cho theo dõi mã tùy chỉnh là thời lượng của nó, nhưng bạn cũng có thể thêm các số liệu tùy chỉnh, chẳng hạn như số lần truy cập bộ nhớ cache và cảnh báo bộ nhớ.
Trong mã của mình, bạn xác định phần đầu và phần cuối của một lần theo dõi mã tùy chỉnh (và thêm bất kỳ chỉ số tùy chỉnh mong muốn nào) bằng cách sử dụng API do SDK giám sát hiệu suất cung cấp. Đối với các ứng dụng Android, bạn cũng có thể theo dõi thời lượng của các phương thức cụ thể bằng cách sử dụng chú thích @AddTrace .
Truy cập Thêm giám sát cho mã cụ thể để tìm hiểu thêm về các tính năng này và cách thêm chúng vào ứng dụng của bạn.
Bước 6 : Triển khai ứng dụng của bạn sau đó xem xét kết quả
Sau khi bạn đã xác thực Giám sát hiệu suất bằng một hoặc nhiều thiết bị thử nghiệm, bạn có thể triển khai phiên bản cập nhật của ứng dụng cho người dùng của mình.
Bạn có thể theo dõi dữ liệu hiệu suất trong bảng điều khiển Hiệu suất của bảng điều khiển Firebase.
Các vấn đề đã biết
Plugin Cấp độ giám sát hiệu suất v1.1.0 có thể gây ra sự không khớp trong phần phụ thuộc của ổi, dẫn đến lỗi sau:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
Nếu bạn thấy lỗi này, bạn có thể:
Nâng cấp plugin Giám sát hiệu suất lên v1.1.1 trở lên (mới nhất là v1.4.2).
Thay thế dòng phụ thuộc plugin Giám sát hiệu suất trong tệp Gradle cấp gốc (cấp dự án) của bạn (
build.gradle
), như sau:buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath ('com.google.firebase:perf-plugin:1.1.0') { exclude group: 'com.google.guava', module: 'guava-jdk5' } } }
Giám sát hiệu suất báo cáo tổng kích thước tải trọng cho các yêu cầu mạng HTTP dựa trên giá trị được đặt trong tiêu đề độ dài nội dung HTTP. Giá trị này có thể không phải lúc nào cũng chính xác.
Giám sát hiệu suất chỉ hỗ trợ quy trình chính trong các ứng dụng Android đa quy trình.
Bước tiếp theo
Xem lại và chạy mẫu mã Android Giám sát hiệu suất trên GitHub .
Tìm hiểu thêm về dữ liệu do Giám sát hiệu suất tự động thu thập:
- Dữ liệu liên quan đến vòng đời của ứng dụng, chẳng hạn như thời gian bắt đầu ứng dụng
- Dữ liệu để hiển thị màn hình trong ứng dụng của bạn
- Dữ liệu cho các yêu cầu mạng HTTP/S do ứng dụng của bạn cấp
Xem, theo dõi và lọc dữ liệu hiệu suất của bạn trong bảng điều khiển Firebase.
Thêm giám sát cho các tác vụ hoặc quy trình công việc cụ thể trong ứng dụng của bạn bằng công cụ theo dõi mã tùy chỉnh .