Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Tắt tính năng giám sát hiệu suất của Firebase

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.

Trong quá trình phát triển và thử nghiệm ứng dụng, bạn có thể thấy hữu ích khi tắt Giám sát hiệu suất.

Ví dụ: bằng cách tắt Giám sát hiệu suất trong quá trình xây dựng ứng dụng , bạn có thể:

  • Tắt một số chức năng nhất định của Giám sát hiệu suất (chẳng hạn như những chức năng được cung cấp bởi plugin Gradle Giám sát hiệu suất ) trong các bản dựng gỡ lỗi của bạn, nhưng bật lại các chức năng cho bản phát hành của bạn.

  • Tắt Giám sát hiệu suất khi xây dựng ứng dụng của bạn, nhưng cho phép ứng dụng của bạn bật lại trong thời gian chạy.

  • Tắt Giám sát hiệu suất khi xây dựng ứng dụng của bạn và không cho phép ứng dụng của bạn bật lại trong thời gian chạy.

Bạn cũng có thể tạo ứng dụng của mình với tính năng Giám sát hiệu suất được bật , nhưng hãy sử dụng Cấu hình từ xa của Firebase để giúp bạn linh hoạt tắt (và bật lại) Giám sát hiệu suất trong ứng dụng sản xuất của mình. Với tùy chọn này, bạn thậm chí có thể định cấu hình ứng dụng của mình để cho phép người dùng chọn tham gia hoặc chọn không sử dụng Giám sát hiệu suất.

Tắt tính năng Giám sát hiệu suất trong quá trình xây dựng ứng dụng của bạn

Bạn có thể tắt Giám sát Hiệu suất trong quá trình xây dựng của mình bằng cách tắt plugin Gradle Giám sát Hiệu suất và / hoặc bằng cách tắt thư viện Android Giám sát Hiệu suất .

Trong quá trình phát triển và gỡ lỗi, việc tắt plugin là rất hữu ích vì thiết bị đo của plugin có thể góp phần làm tăng thời gian xây dựng. Tuy nhiên, bạn có thể cân nhắc việc kích hoạt thư viện để bạn vẫn có thể xem dữ liệu hiệu suất từ ​​các dấu vết khởi động ứng dụng, ứng dụng trong nền và ứng dụng trong nền cũng như bất kỳ dấu vết mã tùy chỉnh nào trong ứng dụng của bạn.

Tắt plugin Gradle giám sát hiệu suất

Bạn có thể vô hiệu hóa plugin Giám sát Hiệu suất bằng cách thêm một lá cờ Công instrumentationEnabled bằng cách sử dụng các tùy chọn sau:

Tắt plugin thông qua cờ Thuộc tính tiện ích mở rộng

Bằng cách sử dụng cờ Thuộc tính tiện ích mở rộng , bạn có thể tắt plugin Giám sát hiệu suất cho một biến thể bản dựng cụ thể tại thời điểm biên dịch.

  1. Trong tệp build.gradle cấp gốc (cấp dự án) của bạn, hãy đảm bảo phần phụ thuộc vào Trình cắm Android Gradle của bạn được chỉ định là v3.4.0 trở lên.

    Đối với các phiên bản trước của Plugin Android Gradle, bạn vẫn có thể tắt plugin Giám sát hiệu suất cho một biến thể xây dựng cụ thể, nhưng đóng góp về thời gian xây dựng cho biến thể đó sẽ không bị loại bỏ hoàn toàn.

  2. Thêm cờ sau vào tệp build.gradle mô-đun (cấp ứng dụng) của bạn, sau đó đặt nó thành false để tắt plugin Giám sát hiệu suất.

    android {
      // ...
      buildTypes {
        debug {
          FirebasePerformance {
            // Set this flag to 'false' to disable @AddTrace annotation processing and
            // automatic monitoring of HTTP/S network requests
            // for a specific build variant at compile time.
            instrumentationEnabled false
          }
        }
      }
    }
    

Tắt plugin thông qua cờ Thuộc tính dự án

Bằng cách sử dụng cờ Thuộc tính dự án , bạn có thể tắt plugin Giám sát hiệu suất cho tất cả các biến thể bản dựng tại thời điểm biên dịch.

Thêm cờ sau vào tệp gradle.properties của bạn, sau đó đặt nó thành false để tắt plugin Giám sát hiệu suất.

// ...

// Set this flag to 'false' to disable @AddTrace annotation processing and
// automatic monitoring of HTTP/S network requests
// for all build variants at compile time.
firebasePerformanceInstrumentationEnabled=false

Tắt thư viện Android Giám sát Hiệu suất

Nếu bạn tắt thư viện Giám sát hiệu suất tại thời điểm biên dịch, bạn có thể chọn có cho phép ứng dụng của mình bật thư viện trong thời gian chạy hay không.

Tắt thư viện tại thời điểm biên dịch, nhưng cho phép ứng dụng của bạn bật nó trong thời gian chạy

Thêm phần tử <meta-data> sau vào tệp AndroidManifest.xml của ứng dụng:

  <application>
    <meta-data
      android:name="firebase_performance_collection_enabled"
      android:value="false" />
  </application>

Tắt thư viện tại thời điểm biên dịch, nhưng không cho phép ứng dụng của bạn bật nó trong thời gian chạy

Thêm phần tử <meta-data> sau vào tệp AndroidManifest.xml của ứng dụng:

  <application>
    <meta-data
      android:name="firebase_performance_collection_deactivated"
      android:value="true" />
  </application>

Tắt ứng dụng của bạn trong thời gian chạy bằng Cấu hình từ xa

Cấu hình từ xa của Firebase cho phép bạn thực hiện các thay đổi đối với hành vi và giao diện của ứng dụng, vì vậy, nó cung cấp một cách lý tưởng để cho phép bạn tắt Giám sát hiệu suất trong các phiên bản đã triển khai của ứng dụng.

Để tắt thu thập dữ liệu Giám sát hiệu suất vào lần tiếp theo khi ứng dụng Android của bạn khởi động, hãy sử dụng mã ví dụ được hiển thị bên dưới. Để biết thêm thông tin về cách sử dụng Cấu hình từ xa trong ứng dụng Android, hãy xem Sử dụng cấu hình từ xa Firebase trên Android .

  1. Đảm bảo rằng Cấu hình từ xa nằm trong phần dependencies của tệp Gradle mô-đun của bạn (thường là app/build.gradle ):

    implementation 'com.google.firebase:firebase-config:21.2.0'
    
  2. Thiết lập Cấu hình từ xa và tắt Giám sát hiệu suất nếu perf_disable được đặt thành true :

    Java

    // Setup remote config
    final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
    
    // You can uncomment the following two statements to permit more fetches when
    // validating your app, but you should comment out or delete these lines before
    // distributing your app in production.
    // FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    //       .setMinimumFetchIntervalInSeconds(3600)
    //       .build();
    // config.setConfigSettingsAsync(configSettings);
    // Load in-app defaults from an XML file that sets perf_disable to false until you update
    // values in the Firebase Console
    
    //Observe the remote config parameter "perf_disable" and disable Performance Monitoring if true
    config.setDefaultsAsync(R.xml.remote_config_defaults)
            .addOnCompleteListener(new OnCompleteListener<Void>() {
                @Override
                public void onComplete(@NonNull Task<Void> task) {
                    if (task.isSuccessful()) {
                        if (config.getBoolean("perf_disable")) {
                            FirebasePerformance.getInstance().setPerformanceCollectionEnabled(false);
                        } else {
                            FirebasePerformance.getInstance().setPerformanceCollectionEnabled(true);
                        }
                    } else {
                        // An error occurred while setting default parameters
                    }
                }
            });

    Kotlin+KTX

    // Setup remote config
    val config = Firebase.remoteConfig
    
    // You can uncomment the following two statements to permit more fetches when
    // validating your app, but you should comment out or delete these lines before
    // distributing your app in production.
    // val configSettings = remoteConfigSettings {
    //     minimumFetchIntervalInSeconds = 3600
    // }
    // config.setConfigSettingsAsync(configSettings)
    // Load in-app defaults from an XML file that sets perf_disable to false until you update
    // values in the Firebase Console
    
    // Observe the remote config parameter "perf_disable" and disable Performance Monitoring if true
    config.setDefaultsAsync(R.xml.remote_config_defaults)
            .addOnCompleteListener { task ->
                if (task.isSuccessful) {
                    Firebase.performance.isPerformanceCollectionEnabled = !config.getBoolean("perf_disable")
                } else {
                    // An error occurred while setting default parameters
                }
            }
  3. Thêm mã sau vào MainActivity.java để tìm nạp và kích hoạt các giá trị Cấu hình Từ xa:

    Java

    //Remote Config fetches and activates parameter values from the service
    final FirebaseRemoteConfig config = FirebaseRemoteConfig.getInstance();
    config.fetch(3600)
            .continueWithTask(new Continuation<Void, Task<Boolean>>() {
                @Override
                public Task<Boolean> then(@NonNull Task<Void> task) throws Exception {
                    if (!task.isSuccessful()) {
                        throw task.getException();
                    }
                    return config.activate();
                }
            })
            .addOnCompleteListener(new OnCompleteListener<Boolean>() {
                @Override
                public void onComplete(@NonNull Task<Boolean> task) {
                    if (task.isSuccessful()) {
                        // Parameter values successfully activated
                        // ...
                    } else {
                        // Handle errors
                    }
                }
            });

    Kotlin+KTX

    // Remote Config fetches and activates parameter values from the service
    val config = Firebase.remoteConfig
    config.fetch(3600)
            .continueWithTask { task ->
                if (!task.isSuccessful) {
                    task.exception?.let {
                        throw it
                    }
                }
                config.activate()
            }
            .addOnCompleteListener(this) { task ->
                if (task.isSuccessful) {
                    // Parameter values successfully activated
                    // ...
                } else {
                    // Handle errors
                }
            }
  4. Để tắt Giám sát hiệu suất trong bảng điều khiển Firebase, hãy tạo thông số perf_disable trong dự án ứng dụng của bạn, sau đó đặt giá trị của nó thành true .

    Thay đổi này sẽ thực hiện lệnh gọi "không hoạt động" (NOOP) của SDK theo dõi hiệu suất, loại bỏ bất kỳ ảnh hưởng đáng kể nào đến hiệu suất ứng dụng khi sử dụng SDK theo dõi hiệu suất trong ứng dụng của bạn.

    Nếu bạn đặt giá trị perf_disable thành false , Giám sát hiệu suất vẫn được bật.