Firebase प्रदर्शन मॉनिटर करना बंद करें

ऐप्लिकेशन डेवलपमेंट और टेस्टिंग के दौरान, आपको Performance Monitoring को बंद करना फ़ायदेमंद लग सकता है.

उदाहरण के लिए, ऐप्लिकेशन बनाने की प्रोसेस के दौरान Performance Monitoring को बंद करके, ये काम किए जा सकते हैं:

अपने डीबग बिल्ड में, Performance Monitoring की कुछ सुविधाओं को बंद करें. जैसे, Performance Monitoring Gradle प्लग इन की सुविधाएं. हालांकि, रिलीज़ बिल्ड के लिए, इन सुविधाओं को फिर से चालू करें.
ऐप्लिकेशन बनाते समय Performance Monitoring को बंद करें. हालांकि, ऐप्लिकेशन को रनटाइम के दौरान इसे फिर से चालू करने की अनुमति दें.
ऐप्लिकेशन बनाते समय, Performance Monitoring को बंद करें. साथ ही, अपने ऐप्लिकेशन को रनटाइम के दौरान इसे फिर से चालू करने की अनुमति न दें.

आपके पास Performance Monitoring चालू होने पर भी अपना ऐप्लिकेशन बनाने का विकल्प है. हालांकि, Firebase Remote Config का इस्तेमाल करें, ताकि आपके पास अपने प्रोडक्शन ऐप्लिकेशन में Performance Monitoring को बंद करने (और फिर से चालू करने) का विकल्प हो. इस विकल्प की मदद से, अपने ऐप्लिकेशन को इस तरह कॉन्फ़िगर किया जा सकता है कि उपयोगकर्ता Performance Monitoring का इस्तेमाल करने के लिए ऑप्ट-इन या ऑप्ट-आउट कर सकें.

ऐप्लिकेशन बनाने की प्रोसेस के दौरान Performance Monitoring को बंद करना

बिल्ड प्रोसेस के दौरान, Performance Monitoring को बंद किया जा सकता है. इसके लिए, Performance Monitoring Gradle प्लग इन को बंद करें और/या Performance Monitoring Android लाइब्रेरी को बंद करें.

डेवलपमेंट और डीबग करने के दौरान, प्लग इन को बंद करना फ़ायदेमंद होता है, क्योंकि प्लग इन के इंस्ट्रूमेंटेशन की वजह से, बिल्ड में लगने वाला समय बढ़ सकता है. हालांकि, लाइब्रेरी को चालू रखा जा सकता है, ताकि आप अब भी ऐप्लिकेशन शुरू होने, ऐप्लिकेशन के फ़ोरग्राउंड में होने, और ऐप्लिकेशन के बैकग्राउंड में होने के ट्रैस के साथ-साथ, अपने ऐप्लिकेशन में मौजूद किसी भी कस्टम कोड ट्रैस का परफ़ॉर्मेंस डेटा देख सकें.

ध्यान दें: अगर लाइब्रेरी को बंद करके प्लगिन को चालू रखा जाता है, तो प्लगिन से इंस्ट्रूमेंटेशन की प्रोसेस फिर भी होती है. हालांकि, प्लग इन से इकट्ठा किया गया डेटा, परफ़ॉर्मेंस रिपोर्टिंग के लिए प्रोसेस नहीं किया जाता. जैसे, @AddTrace एनोटेशन प्रोसेसिंग और एचटीटीपी/एचटीटीपीएस नेटवर्क अनुरोध की अपने-आप निगरानी करना.
Performance Monitoring को पूरी तरह से बंद करने के लिए, आपको प्लग इन और लाइब्रेरी, दोनों को बंद करना होगा.

Performance Monitoring Gradle प्लग इन बंद करना

Performance Monitoring प्लग इन को बंद करने के लिए, instrumentationEnabled फ़्लैग जोड़ें. इसके लिए, इन विकल्पों का इस्तेमाल करें:

एक्सटेंशन प्रॉपर्टी — यह कंपाइल करने के समय, किसी खास बिल्ड वैरिएंट के लिए प्लग इन को बंद कर देता है
प्रोजेक्ट प्रॉपर्टी — यह कंपाइल करने के समय, सभी बिल्ड वैरिएंट के लिए प्लग इन को बंद कर देता है

एक्सटेंशन प्रॉपर्टी फ़्लैग की मदद से प्लग इन को बंद करना

एक्सटेंशन प्रॉपर्टी फ़्लैग का इस्तेमाल करके, किसी खास बिल्ड वैरिएंट के लिए, कंपाइल करने के समय Performance Monitoring प्लग इन को बंद किया जा सकता है.

पक्का करें कि आपकी रूट-लेवल (प्रोजेक्ट-लेवल) Gradle फ़ाइल (<project>/build.gradle.kts या <project>/build.gradle) में, 'Android Gradle प्लग इन' की डिपेंडेंसी के तौर पर v3.4.0 या इसके बाद का वर्शन तय किया गया हो.

Android Gradle प्लग इन के पुराने वर्शन के लिए, अब भी किसी खास बिल्ड वैरिएंट के लिए Performance Monitoring प्लग इन को बंद किया जा सकता है. हालांकि, उस वैरिएंट के लिए बिल्ड में लगने वाले समय में योगदान को पूरी तरह से खत्म नहीं किया जाएगा.

अपने मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल में यह फ़्लैग जोड़ें. आम तौर पर, यह फ़्लैग <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle होता है. इसके बाद, Performance Monitoring प्लग इन को बंद करने के लिए, इसे false पर सेट करें.

Kotlin

import com.google.firebase.perf.plugin.FirebasePerfExtension

// ...

android {
  // ...
  buildTypes {
    getByName("debug") {
      configure<FirebasePerfExtension> {
        // 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.
        setInstrumentationEnabled(false)
      }
    }
  }
}

Groovy

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
      }
    }
  }
}

प्रोजेक्ट प्रॉपर्टी फ़्लैग की मदद से प्लग इन को बंद करना

प्रोजेक्ट प्रॉपर्टी फ़्लैग का इस्तेमाल करके, Performance Monitoring प्लग इन को 'कंपाइल करें' समय पर, सभी बिल्ड वैरिएंट के लिए बंद किया जा सकता है.

अपनी gradle.properties फ़ाइल में यह फ़्लैग जोड़ें. इसके बाद, Performance Monitoring प्लग इन को बंद करने के लिए, इसे false पर सेट करें.

// ...

// 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

अहम जानकारी: अगर प्रोजेक्ट प्रॉपर्टी फ़्लैग तय किया गया है, तो यह सभी बिल्ड वैरिएंट पर लागू होता है. साथ ही, यह एक्सटेंशन प्रॉपर्टी फ़्लैग से ज़्यादा अहमियत रखता है.
अपने प्रोडक्शन ऐप्लिकेशन में Performance Monitoring प्लग इन को फिर से चालू करने के लिए, आपको प्रोजेक्ट प्रॉपर्टी फ़्लैग पर टिप्पणी करनी होगी या उसे true पर सेट करना होगा.

Performance Monitoring Android लाइब्रेरी बंद करना

अगर कंपाइल करने के समय Performance Monitoring लाइब्रेरी को बंद किया जाता है, तो आपके पास यह चुनने का विकल्प होता है कि ऐप्लिकेशन को रनटाइम के दौरान लाइब्रेरी को चालू करने की अनुमति दी जाए या नहीं.

कंपाइल के समय लाइब्रेरी को बंद करें, लेकिन अपने ऐप्लिकेशन को रनटाइम के दौरान इसे चालू करने की अनुमति दें

अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में यह <meta-data> एलिमेंट जोड़ें:

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

कंपाइल करने के समय लाइब्रेरी को बंद करें, लेकिन अपने ऐप्लिकेशन को रनटाइम के दौरान इसे चालू करने की अनुमति न दें

अपने ऐप्लिकेशन की AndroidManifest.xml फ़ाइल में यह <meta-data> एलिमेंट जोड़ें:

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

Remote Config का इस्तेमाल करके, रनटाइम के दौरान ऐप्लिकेशन बंद करना

Firebase Remote Config की मदद से, ऐप्लिकेशन के काम करने के तरीके और लुक में बदलाव किए जा सकते हैं. इसलिए, यह आपके ऐप्लिकेशन के डिप्लॉय किए गए इंस्टेंस में Performance Monitoring को बंद करने का सबसे सही तरीका है.

अगली बार जब आपका Android ऐप्लिकेशन शुरू होगा, तब Performance Monitoring डेटा इकट्ठा करने की सुविधा को बंद करने के लिए, यहां दिए गए उदाहरण के तौर पर दिए गए कोड का इस्तेमाल करें. Android ऐप्लिकेशन में Remote Config का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, Android पर Firebase Remote Config का इस्तेमाल करना लेख पढ़ें.

पक्का करें कि Remote Config, मॉड्यूल (ऐप्लिकेशन-लेवल) की Gradle फ़ाइल के dependencies सेक्शन में हो. आम तौर पर, यह <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle होता है:
Kotlin+KTX
```
  implementation("com.google.firebase:firebase-config-ktx:22.0.1")
```
Java
```
  implementation("com.google.firebase:firebase-config:22.0.1")
```

अगर perf_disable को true पर सेट किया गया है, तो Remote Config को सेट अप करें और Performance Monitoring को बंद करें:

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
        }
    }MainActivity.kt

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
                }
            }
        });MainActivity.java

Remote Config वैल्यू को फ़ेच और चालू करने के लिए, MainActivity.java में यह कोड जोड़ें:

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
        }
    }MainActivity.kt

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
                }
            }
        });MainActivity.java

Firebase कंसोल में Performance Monitoring को बंद करने के लिए, अपने ऐप्लिकेशन के प्रोजेक्ट में perf_disable पैरामीटर बनाएं. इसके बाद, इसकी वैल्यू को true पर सेट करें.

इस बदलाव से, Performance Monitoring SDK के "कोई कार्रवाई नहीं" कॉल (NOOP) किए जाएंगे. इससे, आपके ऐप्लिकेशन में Performance Monitoring SDK का इस्तेमाल करने से, ऐप्लिकेशन की परफ़ॉर्मेंस पर होने वाले किसी भी असर को खत्म किया जा सकेगा.

अगर perf_disable की वैल्यू को false पर सेट किया जाता है, तो Performance Monitoring चालू रहेगा.