Trước khi bắt đầu
Thêm Firebase vào dự án Android của bạn nếu bạn chưa thêm.
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 cho quá trình kết xuất màn hình và dữ liệu liên quan đến vòng đời của ứng dụng (như thời gian khởi động ứng dụng). Để cho phép Firebase giám sát các yêu cầu mạng, bạn cũng phải thêm trình bổ trợ Gradle Giám sát hiệu suất (bước tiếp theo).
Trong tệp Gradle (cấp ứng dụng) trong mô-đun (thường là
<project>/<app-module>/build.gradle.kts
hoặc<project>/<app-module>/build.gradle
), hãy thêm phần phụ thuộc cho thư viện Giám sát hiệu suất dành cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.1")) // 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 trên Firebase.
(Thay thế) Thêm các phần phụ thuộc của thư viện Firebase mà không sử dụng BoM
Nếu chọn không sử dụng BoM của Firebase, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phần phụ thuộc.
Xin lưu ý rằng nếu sử dụng nhiều thư viện Firebase trong ứng dụng, thì bạn nên sử dụng BoM để quản lý các phiên bản thư viện, qua đó đảm bảo 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:21.0.1") }
Biên dịch lại ứng dụng.
Bước 2: Thêm trình bổ trợ Gradle giám sát hiệu suất vào ứng dụng của bạn
Sau khi bạn thêm trình bổ trợ Gradle 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. Trình bổ trợ cũng cho phép bạn đo lường dấu vết mã tuỳ chỉnh bằng cách sử dụng chú giải@AddTrace.
Trong tệp Gradle cấp gốc (cấp dự án) (
<project>/build.gradle.kts
hoặc<project>/build.gradle
), hãy thêm trình bổ trợ Giám sát hiệu suất Gradle:Kotlin
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id("com.android.application") version "7.3.0" apply false // Make sure that you have the Google services Gradle plugin dependency id("com.google.gms.google-services") version "4.4.2" apply false // Add the dependency for the Performance Monitoring Gradle plugin id("com.google.firebase.firebase-perf") version "1.4.2" apply false }
Groovy
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id 'com.android.application' version '7.3.0' apply false // Make sure that you have the Google services Gradle plugin dependency id 'com.google.gms.google-services' version '4.4.2' apply false // Add the dependency for the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' version '1.4.2' apply false }
Trong tệp Gradle mô-đun (cấp ứng dụng) (thường là
<project>/<app-module>/build.gradle.kts
hoặc<project>/<app-module>/build.gradle
), hãy thêm trình bổ trợ Gradle cho Giám sát hiệu suất:Kotlin
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") ... }
Groovy
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.
Bước 3: Tạo 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 SDK vào ứng dụng thành công. Nếu bạn vẫn đang phát triển cục bộ, hãy tương tác với ứng dụng của bạn để tạo sự kiện cho hoạt động thu thập và xử lý dữ liệu ban đầu.
Tạo sự kiện bằng cách chuyển đổi ứng dụng giữa nền và nền trước một vài lần, tương tác với ứng dụng bằng cách di chuyển trên các màn hình và/hoặc kích hoạt các yêu cầu mạng.
Chuyển đến trang tổng quan Hiệu suất của bảng điều khiển của Firebase. Bạn sẽ thấy dữ liệu ban đầu hiển thị trong vòng vài phút.
Nếu bạn không thấy dữ liệu ban đầu của mình, hãy xem các mẹo khắc phục sự cố.
Bước 4: (Không bắt buộc) Xem thông điệp nhật ký cho sự kiện hiệu suất
Bật tính năng ghi nhật ký gỡ lỗi cho tính năng 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 điệp nhật ký của bạn để xem có thông báo lỗi nào không.
Dịch vụ Giám sát hiệu suất gắn thẻ thông điệp nhật ký bằng
FirebasePerformance
. Khi sử dụng tính năng lọc logcat, bạn có thể xem cụ thể dấu vết thời lượng và 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 tính năng Giám sát hiệu suất đang ghi lại các sự kiện về 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 của Firebase. Có thể mất vài phút để dữ liệu cập nhật trong trang tổng quan.
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 các mẹo khắc phục sự cố.
Bước 5: (Không bắt buộc) Thêm tính năng giám sát tuỳ chỉnh cho mã cụ thể
Để theo dõi dữ liệu hiệu suất được liên kết với mã cụ thể trong ứng dụng của mình, bạn có thể đo lường dấu vết mã tuỳ chỉnh.
Với tính năng theo dõi mã tuỳ chỉnh, bạn có thể đo lường thời gian ứng dụng cần để hoàn thành một tác vụ hoặc một nhóm nhiệm vụ cụ thể, chẳng hạn như tải một tập hợp hình ảnh hoặc truy vấn cơ sở dữ liệu của bạn. Chỉ số mặc định cho dấu vết mã tuỳ chỉnh là thời lượng, nhưng bạn cũng có thể thêm chỉ số tuỳ chỉnh, chẳng hạn như lượt truy cập vào bộ nhớ đệm và cảnh báo về bộ nhớ.
Trong mã, bạn xác định điểm bắt đầu và kết thúc của một dấu vết mã tuỳ chỉnh (và thêm mọi chỉ số tuỳ chỉnh mong muốn) 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ú giải@AddTrace.
Hãy xem bài viết Thêm tính năng giám sát 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.
Bước 6: Triển khai ứng dụng sau đó xem xét kết quả
Sau khi xác thực tính năng 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.
Bạn có thể theo dõi dữ liệu hiệu suất trong trang tổng quan Hiệu suất của bảng điều khiển của Firebase.
Các vấn đề đã biết
Trình bổ trợ Gradle giám sát hiệu suất phiên bản 1.1.0 có thể gây ra tình trạng không khớp trong các phần phụ thuộc của Guava, 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 thấy lỗi này, bạn có thể:
Nâng cấp trình bổ trợ Giám sát hiệu suất lên phiên bản 1.1.1 trở lên (phiên bản mới nhất là phiên bản 1.4.2).
Thay thế dòng phần phụ thuộc của trình bổ trợ Giám sát hiệu suất trong tệp Gradle cấp gốc (cấp dự án) (
<project>/build.gradle.kts
hoặc<project>/build.gradle
) như sau:Kotlin
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") } } }
Groovy
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' } } }
Tính năng 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.
Tính năng Giám sát hiệu suất chỉ hỗ trợ quy trình chính trong các ứng dụng Android đa quá trình.
Các bước tiếp theo
Xem lại và chạy mã mẫu Android Giám sát hiệu suất trên GitHub.
Tìm hiểu thêm về dữ liệu được tính năng Theo dõi hiệu suất thu thập tự động:
- Dữ liệu liên quan đến vòng đời của ứng dụng, chẳng hạn như thời gian khởi động ứng dụng
- Dữ liệu về hoạt động kết xuất 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 đưa ra
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 của Firebase.
Thêm tính năng theo dõi 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ách đo lường dấu vết mã tuỳ chỉnh.