Check out what’s new from Firebase at Google I/O 2022. Learn more

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

Để cho phép người dùng của bạn chọn tham gia hoặc chọn không sử dụng Giám sát hiệu suất Firebase, bạn có thể muốn định cấu hình ứng dụng của mình để có thể bật và tắt Giám sát hiệu suất. Bạn cũng có thể thấy khả năng này hữu ích trong quá trình phát triển và thử nghiệm ứng dụng.

Sau đây là một số tùy chọn cần xem xét:

  • Bạn có thể tắt SDK giám sát hiệu suất khi xây dựng ứng dụng của mình, với tùy chọn bật lại khi chạy.

  • Bạn có thể tạo ứng dụng của mình với SDK giám sát hiệu suất được bật nhưng có tùy chọn tắt ứng dụng trong thời gian chạy bằng cách sử dụng Cấu hình từ xa Firebase.

  • Bạn có thể hủy kích hoạt hoàn toàn SDK theo dõi hiệu suất mà không có tùy chọn nào để bật nó trong thời gian chạy.

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

Một tình huống mà việc tắt Giám sát hiệu suất trong quá trình xây dựng ứng dụng của bạn có thể hữu ích là tránh báo cáo dữ liệu hiệu suất từ ​​phiên bản trước khi phát hành ứng dụng của bạn trong quá trình phát triển và thử nghiệm ứng dụng.

Để tắt hoặc tắt tính năng Giám sát hiệu suất, bạn có thể thêm một trong hai khóa vào tệp danh sách thuộc tính ( Info.plist ) cho ứng dụng Apple của mình:

  • Để tắt Giám sát hiệu suất nhưng cho phép ứng dụng của bạn bật trong thời gian chạy, hãy đặt firebase_performance_collection_enabled thành false trong tệp Info.plist của ứng dụng.

  • Để hủy kích hoạt hoàn toàn Giám sát hiệu suất mà không có tùy chọn bật tính năng này trong thời gian chạy, hãy đặt firebase_performance_collection_deactivated thành true trong tệp Info.plist của ứng dụng của bạn.

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, do đó, 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 tính năng 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 Apple 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 Apple, hãy xem Sử dụng Cấu hình từ xa Firebase trên các nền tảng của Apple .

  1. Đảm bảo rằng cấu hình từ xa được sử dụng trong Podfile của bạn:

    pod 'Firebase/RemoteConfig'
    
  2. Thêm phần sau vào đầu tệp AppDelegate của ứng dụng:

    Nhanh

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    import FirebaseRemoteConfig
    

    Objective-C

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    @import FirebaseRemoteConfig;
    
  3. Trong tệp AppDelegate của bạn, hãy thêm mã sau vào câu lệnh launchOptions trong application:didFinishLaunchingWithOptions: phương thức instance:

    Nhanh

    Lưu ý: Sản phẩm này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    remoteConfig = RemoteConfig.remoteConfig()
    // You can change the "false" below to "true" to permit more fetches when validating
    // your app, but you should change it back to "false" or remove this statement before
    // distributing your app in production.
    let remoteConfigSettings = RemoteConfigSettings(developerModeEnabled: false)
    remoteConfig.configSettings = remoteConfigSettings!
    // Load in-app defaults from a plist file that sets perf_disable to false until
    // you update values in the Firebase console.
    remoteConfig.setDefaultsFromPlistFileName("RemoteConfigDefaults")
    // Important! This needs to be applied before FirebaseApp.configure()
    if !remoteConfig["perf_disable"].boolValue {
        // The following line disables all automatic (out-of-the-box) monitoring
        Performance.sharedInstance().isInstrumentationEnabled = false
        // The following line disables all custom monitoring
        Performance.sharedInstance().isDataCollectionEnabled = false
    }
    else {
        Performance.sharedInstance().isInstrumentationEnabled = true
        Performance.sharedInstance().isDataCollectionEnabled = true
    }
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    self.remoteConfig = [FIRRemoteConfig remoteConfig];
    // You can change the NO below to YES to permit more fetches when validating
    // your app, but you should change it back to NO or remove this statement before
    // distributing your app in production.
    FIRRemoteConfigSettings *remoteConfigSettings =
        [[FIRRemoteConfigSettings alloc] initWithDeveloperModeEnabled:NO];
    self.remoteConfig.configSettings = remoteConfigSettings;
    // Load in-app defaults from a plist file that sets perf_disable to false until
    // you update values in the Firebase console.
    [self.remoteConfig setDefaultsFromPlistFileName:@"RemoteConfigDefaults"];
    // Important! This needs to be applied before [FIRApp configure]
    if (!self.remoteConfig[@"perf_disable"].numberValue.boolValue) {
        // The following line disables all automatic (out-of-the-box) monitoring
        [FIRPerformance sharedInstance].instrumentationEnabled = NO;
        // The following line disables all custom monitoring
        [FIRPerformance sharedInstance].dataCollectionEnabled = NO;
    }
    else {
        [FIRPerformance sharedInstance].instrumentationEnabled = YES;
        [FIRPerformance sharedInstance].dataCollectionEnabled = YES;
    }
    // Use Firebase library to configure APIs
    [FIRApp configure];
    
  4. Trong ViewController.m hoặc tệp triển khai khác được ứng dụng của bạn sử dụng, hãy thêm mã sau để tìm nạp và kích hoạt các giá trị Cấu hình từ xa:

    Nhanh

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    //RemoteConfig fetch and activation in your app, shortly after startup
    remoteConfig.fetch(withExpirationDuration: TimeInterval(30.0)) { (status, error) -> Void in
      if status == .success {
        print("Config fetched!")
        self.remoteConfig.activateFetched()
      } else {
        print("Config not fetched")
        print("Error \(error!.localizedDescription)")
      }
    }
    

    Objective-C

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    //RemoteConfig fetch and activation in your app, shortly after startup
    [self.remoteConfig fetchWithExpirationDuration:30.0 completionHandler:^(FIRRemoteConfigFetchStatus status, NSError *error) {
      if (status == FIRRemoteConfigFetchStatusSuccess) {
        NSLog(@"Config fetched!");
        [self.remoteConfig activateFetched];
      } else {
        NSLog(@"Config not fetched");
        NSLog(@"Error %@", error.localizedDescription);
      }
    }];
    
  5. Để tắt tính năng 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 .

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

Tắt tính năng thu thập dữ liệu tùy chỉnh hoặc tự động một cách riêng biệt

Bạn có thể thực hiện một số thay đổi đối với mã được hiển thị ở trên và trong bảng điều khiển Firebase để cho phép bạn tắt tất cả giám sát tự động (ngoài hộp) riêng biệt với giám sát tùy chỉnh.

  1. Thêm mã sau vào các câu lệnh launchOptions trong application:didFinishLaunchingWithOptions: phương thức instance (thay vì những gì được hiển thị ở trên cho cùng một phương thức instance):

    Nhanh

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    remoteConfig = FIRRemoteConfig.remoteConfig()
    let remoteConfigSettings = FIRRemoteConfigSettings(developerModeEnabled: true)
    remoteConfig.configSettings = remoteConfigSettings!
    // Important! This needs to be applied before FirebaseApp.configure()
    if remoteConfig["perf_disable_auto"].boolValue {
        // The following line disables all automatic (out-of-the-box) monitoring
        Performance.sharedInstance().isInstrumentationEnabled = false
    }
    else {
        Performance.sharedInstance().isInstrumentationEnabled = true
    }
    if remoteConfig["perf_disable_manual"].boolValue {
        // The following line disables all custom monitoring
        Performance.sharedInstance().isDataCollectionEnabled = false
    }
    else {
        Performance.sharedInstance().isDataCollectionEnabled = true
    }
    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    Lưu ý: Sản phẩm Firebase này không khả dụng trên các mục tiêu macOS, Mac Catalyst, watchOS.
    self.remoteConfig = [FIRRemoteConfig remoteConfig];
    FIRRemoteConfigSettings *remoteConfigSettings =
        [[FIRRemoteConfigSettings alloc] initWithDeveloperModeEnabled:YES];
    self.remoteConfig.configSettings = remoteConfigSettings;
    // Important! This needs to be applied before [FirebaseApp configure]
    if (self.remoteConfig[@"perf_disable_auto"].numberValue.boolValue) {
        // The following line disables all automatic (out-of-the-box) monitoring
        [FIRPerformance sharedInstance].instrumentationEnabled = NO;
    }
    else {
        [FIRPerformance sharedInstance].instrumentationEnabled = YES;
    }
    if (self.remoteConfig[@"perf_disable_manual"].numberValue.boolValue) {
        // The following line disables all custom monitoring
        [FIRPerformance sharedInstance].dataCollectionEnabled = NO;
    }
    else {
        [FIRPerformance sharedInstance].dataCollectionEnabled = YES;
    }
    // Use Firebase library to configure APIs
    [FirebaseApp configure];
    
  2. Hoàn thành phần sau trong bảng điều khiển Firebase:

    • Để tắt tất cả giám sát tự động (ngoài hộp), hãy tạo thông số perf_disable_auto trong dự án ứng dụng của bạn, sau đó đặt giá trị của nó thành true .
    • Để tắt tất cả giám sát tùy chỉnh, hãy tạo thông số perf_disable_manual trong dự án ứng dụng của bạn, sau đó đặt giá trị của nó thành true .