Google is committed to advancing racial equity for Black communities. See how.
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

Android के लिए प्रदर्शन निगरानी के साथ आरंभ करें

शुरू करने से पहले

यदि आप पहले से नहीं हैं, तो अपने Android प्रोजेक्ट में Firebase जोड़ें

अपने प्रोजेक्ट-लेवल build.gradle file , अपने buildscript और allprojects दोनों वर्गों में Google के buildscript रिपॉजिटरी को शामिल करना सुनिश्चित करें।

चरण 1 : प्रदर्शन निगरानी एसडीके को अपने ऐप में जोड़ें

आपके द्वारा प्रदर्शन निगरानी SDK जोड़ने के बाद, Firebase स्वचालित रूप से आपके ऐप की स्क्रीन रेंडरिंग और आपके ऐप के जीवनचक्र से संबंधित डेटा (जैसे ऐप प्रारंभ समय ) के लिए डेटा एकत्र करना शुरू कर देता है । नेटवर्क अनुरोधों की निगरानी के लिए फायरबेस को सक्षम करने के लिए, आपको प्रदर्शन निगरानी ग्रेड प्लगइन (अगला चरण) भी जोड़ना होगा।

  1. आपके मॉड्यूल (ऐप-स्तर) ग्रेड फ़ाइल (आमतौर पर app/build.gradle ) में:

    // ...
    
    dependencies {
      // ...
    
      // Add the dependency for the Performance Monitoring library
      implementation 'com.google.firebase:firebase-perf:19.0.8'
    }
    
  2. अपने एप्लिकेशन को पुनः साझा करें।

चरण 2 : अपने ऐप में प्रदर्शन निगरानी प्लगइन जोड़ें

आपके द्वारा प्रदर्शन मॉनिटरिंग ग्रेड प्लगइन जोड़ने के बाद, फायरबेस स्वचालित रूप से HTTP / S नेटवर्क अनुरोधों के लिए डेटा एकत्र करना शुरू कर देता है । प्लगइन आपको @AddTrace एनोटेशन का उपयोग करके कस्टम कोड ट्रैस को इंस्ट्रूमेंट करने में सक्षम बनाता है।

  1. अपने मॉड्यूल (ऐप-स्तर) ग्रेड फ़ाइल (आमतौर पर app/build.gradle ) में, प्रदर्शन निगरानी प्लगइन लागू करें:

    apply plugin: 'com.android.application'
    apply plugin: 'com.google.gms.google-services'
    // Apply the Performance Monitoring plugin
    apply plugin: 'com.google.firebase.firebase-perf'
    
    android {
      // ...
    }
    
  2. अपने रूट-लेवल (प्रोजेक्ट-लेवल) ग्रेड फ़ाइल ( build.gradle ) में, प्रदर्शन मॉनिटरिंग प्लगइन को शामिल करने के लिए नियम जोड़ें।

    buildscript {
    
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // Add the Bintray repository
          jcenter()
        }
    
        dependencies {
          // ...
    
          // To benefit from the latest Performance Monitoring plugin features,
          // update your Android Gradle Plugin dependency to at least v3.4.0
          classpath 'com.android.tools.build:gradle:3.4.0'
    
          classpath 'com.google.gms:google-services:4.3.3'  // Google Services plugin
    
          // Add the dependency for the Performance Monitoring plugin
          classpath 'com.google.firebase:perf-plugin:1.3.1'  // Performance Monitoring plugin
        }
    }
    
  3. अपने एप्लिकेशन को पुनः साझा करें।

चरण 3 : प्रारंभिक डेटा प्रदर्शन के लिए प्रदर्शन की घटनाओं को उत्पन्न करें

फायरबेस यह पता लगा सकता है कि आपने अपने ऐप से एसडीके को अपने ऐप में सफलतापूर्वक जोड़ दिया है जब वह आपके ऐप से इवेंट की जानकारी (जैसे ऐप इंटरैक्शन) प्राप्त करता है। यदि आप अभी भी स्थानीय रूप से विकसित कर रहे हैं, तो एसडीके डिटेक्शन के साथ-साथ प्रारंभिक डेटा संग्रह और प्रसंस्करण के लिए घटनाओं को उत्पन्न करने के लिए अपने ऐप के साथ बातचीत करें।

  1. एमुलेटर या टेस्ट डिवाइस का उपयोग करके अपने ऐप को विकसित करना जारी रखें जो निम्नलिखित आवश्यकताओं को पूरा करता है:

    • हाल ही में छवि और Google Play सेवाओं के साथ एक एंड्रॉइड एमुलेटर 15.0.0 या बाद में

    • Google Play सेवाओं के साथ एक परीक्षण उपकरण 15.0.0 या बाद में

  2. अपने एप्लिकेशन को पृष्ठभूमि और अग्रभूमि के बीच कई बार स्विच करके, स्क्रीन के पार नेविगेट करके, और / या नेटवर्क अनुरोधों को ट्रिगर करके अपने ऐप के साथ उत्पन्न करें।

  3. फायरबेस कंसोल के प्रदर्शन डैशबोर्ड पर जाएं यह देखने के लिए कि क्या फायरबेस ने एसडीके का पता लगाया है।

    यदि आपको अपने ऐप में एसडीके जोड़ने के 2 घंटे के भीतर "एसडीके का पता चला" संदेश दिखाई नहीं देता है, तो समस्या निवारण युक्तियों की समीक्षा करें।

  4. प्रदर्शन मॉनिटरिंग, प्रदर्शन डैशबोर्ड में प्रदर्शित करने से पहले प्रदर्शन इवेंट डेटा को संसाधित करता है। आपको एसडीके डिटेक्शन मैसेज देखने के 24 घंटे के भीतर अपना प्रारंभिक डेटा डिस्प्ले देखना चाहिए।

    यदि आपको अपने प्रारंभिक डेटा का प्रदर्शन दिखाई नहीं देता है, तो समस्या निवारण युक्तियों की समीक्षा करें।

चरण 4 : (वैकल्पिक) प्रदर्शन घटनाओं के लिए लॉग संदेश देखें

  1. डिबग लॉगिंग को अपने ऐप के AndroidManifest.xml फ़ाइल में <meta-data> तत्व जोड़कर प्रदर्शन निगरानी के लिए सक्षम करें, जैसे:

    <application>
        <meta-data
          android:name="firebase_performance_logcat_enabled"
          android:value="true" />
    </application>
    
  2. किसी भी त्रुटि संदेश के लिए अपने लॉग संदेशों की जाँच करें।

  3. प्रदर्शन मॉनिटरिंग अपने लॉग संदेशों को FirebasePerformance साथ टैग करती है। लॉगकैट फ़िल्टरिंग का उपयोग करके, आप विशेष रूप से अवधि ट्रेस और HTTP / S नेटवर्क अनुरोध को निम्न कमांड चलाकर देख सकते हैं:

    adb logcat -s FirebasePerformance
  4. निम्न प्रकार के लॉग की जांच करें जो दर्शाते हैं कि प्रदर्शन मॉनिटरिंग प्रदर्शन घटनाओं को लॉग कर रहा है:

    • Logging trace metric: TRACE_NAME
    • Logging network request trace: URL

यदि आपका ऐप प्रदर्शन की घटनाओं को लॉग नहीं कर रहा है, तो समस्या निवारण युक्तियों की समीक्षा करें।

चरण 5 : (वैकल्पिक) विशिष्ट कोड के लिए कस्टम निगरानी जोड़ें

अपने ऐप में विशिष्ट कोड से जुड़े प्रदर्शन डेटा की निगरानी करने के लिए, आप कस्टम कोड ट्रैस लिख सकते हैं

एक कस्टम कोड ट्रेस के साथ, आप यह माप सकते हैं कि किसी विशिष्ट कार्य या कार्यों के सेट को पूरा करने में आपका ऐप कितना समय लेता है, जैसे छवियों का एक सेट लोड करना या आपके डेटाबेस को क्वेरी करना। कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मीट्रिक इसकी अवधि है, लेकिन आप कस्टम मीट्रिक भी जोड़ सकते हैं, जैसे कैश हिट और मेमोरी चेतावनी।

आपके कोड में, आप प्रदर्शन मॉनीटरिंग SDK द्वारा उपलब्ध कराई गई API का उपयोग करके एक कस्टम कोड ट्रेस की शुरुआत और अंत को परिभाषित करते हैं (और किसी भी इच्छित कस्टम मेट्रिक्स को जोड़ते हैं)। Android ऐप्स के लिए, आप @AddTrace एनोटेशन का उपयोग करके विशिष्ट विधियों की अवधि की निगरानी कर सकते हैं।

इन सुविधाओं के बारे में अधिक जानने के लिए विशिष्ट कोड की निगरानी जोड़ें और उन्हें अपने ऐप में कैसे जोड़ें।

चरण 6 : अपने ऐप को नियुक्त करें फिर परिणामों की समीक्षा करें

एक या अधिक परीक्षण उपकरणों का उपयोग करके आपने प्रदर्शन मॉनिटरिंग को मान्य किया है, आप अपने ऐप के अपडेटेड संस्करण को अपने उपयोगकर्ताओं के लिए तैनात कर सकते हैं।

आप फायरबेस कंसोल के प्रदर्शन डैशबोर्ड में प्रदर्शन डेटा की निगरानी कर सकते हैं।

ज्ञात पहलु

  • प्रदर्शन की निगरानी ग्रेड प्लगइन v1.1.0 अमरूद निर्भरता में एक बेमेल का कारण बन सकता है, जिसके परिणामस्वरूप निम्न त्रुटि हुई है:

    Error:Execution failed for task ':app:packageInstantRunResourcesDebug'.
    > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;

    यदि आप यह त्रुटि देखते हैं, तो आप या तो:

    • V1.1.1 या बाद के प्रदर्शन निगरानी प्लगइन को अपग्रेड करें (सबसे हाल का v1.3.1 है)।

    • अपने रूट-लेवल (प्रोजेक्ट-लेवल) ग्रेड फ़ाइल ( build.gradle ) में प्रदर्शन निगरानी प्लगइन निर्भरता लाइन को निम्नानुसार build.gradle :

      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'
          }
        }
      }
      
  • प्रदर्शन की निगरानी HTTP सामग्री लंबाई हेडर में निर्धारित मूल्य के आधार पर HTTP नेटवर्क अनुरोधों के लिए कुल पेलोड आकार की रिपोर्ट करता है। यह मान हमेशा सटीक नहीं हो सकता है।

  • प्रदर्शन निगरानी केवल मल्टी-प्रोसेस एंड्रॉइड ऐप में मुख्य प्रक्रिया का समर्थन करती है।

अगला कदम