Trang này được dịch bởi Cloud Translation API.

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 làm như vậ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 về hoạt động kết xuất màn hình 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). Người nhận bật Firebase để giám sát các yêu cầu về mạng, bạn cũng phải thêm tính năng Giám sát hiệu suất Trình bổ trợ 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), 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 Bảng kê khai thành phần của Firebase cho Android để 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.2"))

    // 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.
(Phương án 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ụ thuộc.

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ự 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:21.0.1")
}
```
Bạn đang tìm một mô-đun thư viện dành riêng cho Kotlin? Bắt đầu sau Tháng 10 năm 2023 (Firebase BoM 32.5.0), cả nhà phát triển Kotlin và Java đều có thể phụ thuộc vào mô-đun thư viện chính (để biết thông tin chi tiết, hãy xem Câu hỏi thường gặp về sáng kiến này).
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ợ Giám sát hiệu suất của Gradle, Firebase sẽ tự động khởi động đang thu thập dữ liệu cho Yêu cầu mạng HTTP/S. Chiến lược phát hành đĩa đơn Trình bổ trợ này 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.

Cách hoạt động của trình bổ trợ Giám sát hiệu suất

Trước khi mã được chuyển đổi thành tệp DEX, trình bổ trợ Giám sát hiệu suất 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). Phần lớn thời gian cần thiết để đo lường mã của bạn tuỳ thuộc vào số lượng và quy mô lớp học.

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

Tắt trình bổ trợ Giám sát hiệu suất cho các bản gỡ lỗi vào thời điểm biên dịch
Mô-đun hoá mã để 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 giám sát hiệu suất:

Kotlin

Bạn vẫn đang sử dụng buildscript cú pháp không? 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.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

Bạn vẫn đang sử dụng buildscript cú pháp không? 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.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 tính năng Giám sát hiệu suất Trình bổ trợ Gradle:

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 . 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 các sự kiện để 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 nhiều 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 bảng điều khiển của Firebase. Bạn sẽ thấy dữ liệu ban đầu của mình hiển thị trong trong vài phút.

Nếu bạn không thấy dữ liệu ban đầu của mình hiển thị, hãy xem phần 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 <meta-data> vào tệp AndroidManifest.xml của ứng dụng, chẳng hạn như:
```
<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. Sử dụng logcat bạn có thể xem cụ thể dấu vết thời lượng và mạng HTTP/S yêu cầu ghi nhật ký 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 để biết chức năng Giám sát hiệu suất ghi nhật ký 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 của Firebase. Quá trình này có thể mất vài phút thời điểm để 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 phần 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ể dấu vết mã tuỳ chỉnh của công cụ đó.

Với tính năng theo dõi mã tuỳ chỉnh, bạn có thể đo lường thời gian cần để hoàn tất ứng dụng một nhiệm vụ cụ thể hoặc một nhóm 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 của bạn. Chỉ số mặc định cho dấu vết mã tùy 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 dấu vết mã tuỳ chỉnh (và thêm bất kỳ chỉ số tuỳ 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 ứng dụng Android, bạn cũng có thể theo dõi thời lượng bằng các phương pháp cụ thể Chú giải@AddTrace.

Hãy xem bài viết Thêm tính năng giám sát cho mộ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 của bạn.

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 về Hiệu suất 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 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 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 trên giá trị được đặt trong tiêu đề HTTP content-length. Giá trị này có thể không luôn 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 của giải pháp Giám sát hiệu suất Android 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 bắt đầu ứ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
- Đã cấp dữ liệu cho các yêu cầu mạng HTTP/S theo ứng dụng của bạn
Xem, theo dõi và lọc dữ liệu hiệu suất trong bảng điều khiển của Firebase.
Thêm tính năng 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 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.