Bắt đầu sử dụng tính năng Giám sát hiệu suất cho Android

Trước khi bắt đầu

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Android.

Bước 1: Thêm SDK Performance Monitoring vào ứng dụng

Sau khi bạn thêm SDK Performance Monitoring, Firebase sẽ tự động bắt đầu thu thập dữ liệu về quá trình kết xuất 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 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ợ Performance Monitoring Gradle (bước tiếp theo).

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 phần phụ thuộc của thư viện Performance Monitoring 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:34.11.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 những phiên bản tương thích của thư viện Android trên Firebase.
(Tuỳ chọn) Thêm 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 Firebase BoM, bạn phải chỉ định từng phiên bản thư viện Firebase trong dòng phần phụ thuộc của phiên bản đó.

Xin lưu ý rằng nếu bạn 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. Đ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:22.0.4")
}
```
Biên dịch lại ứng dụng.

Bước 2: Thêm trình bổ trợ Gradle Performance Monitoring vào ứng dụng

Sau khi bạn thêm trình bổ trợ Gradle Performance Monitoring, 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ợ này cũng cho phép bạn đo lường các dấu vết mã tuỳ chỉnh bằng cách sử dụng chú thích@AddTrace.

Cách hoạt động của trình bổ trợ Performance Monitoring

Trước khi mã của bạn được chuyển đổi thành tệp DEX, trình bổ trợ Performance Monitoring sẽ sử dụng Transform API và khung đo lường mã byte ASM để truy cập vào các tệp lớp đã biên dịch của ứng dụng và đo lường mã (để đo lường hiệu suất). Thời gian cần thiết để đo lường mã của bạn phần lớn phụ thuộc vào số lượng và kích thước của các lớp.

Nếu ứng dụng của bạn mất nhiều thời gian để biên dịch hơn bạn muốn, hãy cân nhắc các lựa chọn sau:

Tắt trình bổ trợ Performance Monitoring cho các bản gỡ lỗi tại thời gian biên dịch
Chia mã thành các mô-đun để tối ưu hoá tốc độ bản dựng

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ợ Gradle Performance Monitoring:

Kotlin

Bạn vẫn đang sử dụng cú pháp buildscript? Tìm hiểu cách thêm trình bổ trợ Firebase bằng cú pháp đó.

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.4" apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id("com.google.firebase.firebase-perf") version "2.0.2" apply false
}

Groovy

Bạn vẫn đang sử dụng cú pháp buildscript? Tìm hiểu cách thêm trình bổ trợ Firebase bằng cú pháp đó.

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.4' apply false

    // Add the dependency for the Performance Monitoring Gradle plugin
    id 'com.google.firebase.firebase-perf' version '2.0.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 Performance Monitoring:

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 thành công SDK vào ứng dụng. Nếu vẫn đang phát triển cục bộ, hãy tương tác với ứng dụng để tạo sự kiện cho quá trình thu thập dữ liệu và xử lý ban đầu.

Tạo sự kiện bằng cách chuyển đổi ứng dụng 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 qua 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 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 hiển thị, 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 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 cho Performance Monitoring tại thời gian xây dựng bằng cách thêm <meta-data> phần tử vào tệp AndroidManifest.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ý để tìm thông báo lỗi.
Performance Monitoring gắn thẻ thông báo nhật ký bằng FirebasePerformance. Bằng cách 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 xem 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 rằng Performance Monitoring đ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 trong bảng điều khiển của Firebase. Có thể mất một chút thời gian để dữ liệu cập nhật trong trang tổng quan.

Nếu ứng dụng của bạn không ghi nhật ký các sự kiện 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ể

Để giám sát dữ liệu hiệu suất liên kết với mã cụ thể trong ứng dụng, bạn có thể đo lường dấu vết mã tuỳ chỉnh.

Với dấu vết 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 nhiệm vụ cụ thể hoặc một tập hợp nhiệm vụ, 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. Chỉ số mặc định cho dấu vết mã tuỳ chỉnh là thời lượng của dấu vết đó, nhưng bạn cũng có thể thêm các chỉ số tuỳ chỉnh, chẳng hạn như số lần truy cập bộ nhớ đệm và cảnh báo về bộ nhớ.

Trong mã, bạn xác định điểm bắt đầu và điểm kết thúc của dấu vết mã tuỳ chỉnh (và thêm mọi chỉ số tuỳ chỉnh mong muốn) bằng API do Performance Monitoring SDK cung cấp. Đối với ứng dụng Android, bạn cũng có thể giám sát 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.

Hãy truy cập vào bài viết Thêm tính năng 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 các tính năng đó vào ứng dụng.

Bước 6: Triển khai ứng dụng rồi xem xét kết quả

Sau khi xác thực Performance Monitoring bằng một hoặc nhiều thiết bị kiểm thử, 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ể giám sát dữ liệu hiệu suất trong Hiệu suất trang tổng quan của Firebase bảng điều khiển.

Các vấn đề đã biết

Trình bổ trợ Gradle Performance Monitoring phiên bản 1.1.0 có thể gây ra sự không khớp trong các phần phụ thuộc 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 gặp lỗi này, bạn có thể:

Nâng cấp trình bổ trợ Performance Monitoring lên phiên bản 1.1.1 trở lên (phiên bản mới nhất là 2.0.2).

Thay thế dòng phần phụ thuộc của trình bổ trợ Performance Monitoring 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'
    }
  }
}

Performance Monitoring 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 đề content-length HTTP. Giá trị này có thể không phải lúc nào cũng chính xác.
Performance Monitoring chỉ hỗ trợ quy trình chính trong các ứng dụng Android có nhiều quy trình.

Các bước tiếp theo

Xem xét và chạy mã mẫu Android trên GitHub.Performance Monitoring
Tìm hiểu thêm về dữ liệu được Performance Monitoring 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 khởi động ứng dụng
- Dữ liệu về quá trình kết xuất màn hình trong ứng dụng
- Dữ liệu cho các yêu cầu mạng HTTP/S do ứng dụng của bạn phát hành
Xem, theo dõi và lọc dữ liệu hiệu suất trong bảng điều khiển Firebase.
Thêm tính năng giám sát cho các nhiệm vụ hoặc quy trình cụ thể trong ứng dụng bằng cách đo lường dấu vết mã tuỳ chỉnh.
Sử dụng các thuộc tính để lọc dữ liệu hiệu suất.

Bắt đầu sử dụng tính năng Giám sát hiệu suất cho Android 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.

Trước khi bắt đầu

Bước 1: Thêm SDK Performance Monitoring vào ứng dụng

Bước 2: Thêm trình bổ trợ Gradle Performance Monitoring vào ứng dụng

Kotlin

Groovy

Kotlin

Groovy

Bước 3: Tạo sự kiện hiệu suất để hiển thị dữ liệu ban đầu

Bước 4: (Không bắt buộc) Xem thông báo nhật ký cho các sự kiện hiệu suất

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ể

Bước 6: Triển khai ứng dụng rồi xem xét kết quả

Các vấn đề đã biết

Kotlin

Groovy

Các bước tiếp theo

Bắt đầu sử dụng tính năng Giám sát hiệu suất cho Android