विशिष्ट ऐप कोड के लिए कस्टम मॉनिटरिंग जोड़ें

प्रदर्शन निगरानी आपके ऐप के प्रदर्शन पर नज़र रखने में आपकी मदद करने के लिए ट्रेस एकत्र करती है। ट्रेस आपके ऐप में दो समय के बीच कैप्चर किए गए प्रदर्शन डेटा की रिपोर्ट है।

आप अपने ऐप में विशिष्ट कोड से जुड़े प्रदर्शन डेटा की निगरानी के लिए अपने स्वयं के निशान बना सकते हैं। एक कस्टम कोड ट्रेस के साथ, आप यह माप सकते हैं कि आपके ऐप को किसी विशिष्ट कार्य या कार्यों के एक सेट को पूरा करने में कितना समय लगता है, उदाहरण के लिए छवियों का एक सेट लोड करना या अपने डेटाबेस को क्वेरी करना।

कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मीट्रिक इसकी "अवधि" (ट्रेस के आरंभ और रुकने के बिंदुओं के बीच का समय) है, लेकिन आप कस्टम मीट्रिक भी जोड़ सकते हैं।

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

चूंकि इन ट्रेस के लिए एकत्रित डिफ़ॉल्ट मीट्रिक "अवधि" है, इसलिए उन्हें कभी-कभी "अवधि ट्रेस" कहा जाता है।

आप ट्रेस तालिका के कस्टम ट्रेस उपटैब में इन ट्रेस से डेटा देख सकते हैं, जो प्रदर्शन डैशबोर्ड के नीचे है (इस पृष्ठ पर बाद में कंसोल का उपयोग करने के बारे में और जानें)।

डिफ़ॉल्ट विशेषताएं, कस्टम विशेषताएं और कस्टम मीट्रिक

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

आप ट्रेस के दायरे में होने वाली प्रदर्शन-संबंधी घटनाओं के लिए कस्टम मीट्रिक रिकॉर्ड करने के लिए कस्टम कोड ट्रेस को और कॉन्फ़िगर कर सकते हैं। उदाहरण के लिए, आप कैश हिट और मिस की संख्या या ध्यान देने योग्य समयावधि के लिए UI के अनुत्तरदायी बनने की संख्या के लिए एक कस्टम मीट्रिक बना सकते हैं।

कस्टम विशेषताएँ और कस्टम मीट्रिक्स डिफ़ॉल्ट विशेषताओं और ट्रेस के लिए डिफ़ॉल्ट मीट्रिक के साथ-साथ Firebase कंसोल में प्रदर्शित होते हैं।

कस्टम कोड ट्रेस जोड़ें

विशिष्ट एप्लिकेशन कोड की निगरानी के लिए कस्टम कोड ट्रेस जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस एपीआई का उपयोग करें।

निम्नलिखित पर ध्यान दें:

  • एक ऐप में कई कस्टम कोड ट्रेस हो सकते हैं।
  • एक से अधिक कस्टम कोड ट्रेस एक ही समय में चल सकते हैं।
  • कस्टम कोड ट्रेस के लिए नाम निम्नलिखित आवश्यकताओं को पूरा करना चाहिए: कोई अग्रणी या पिछला व्हाइटस्पेस नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं है, और अधिकतम लंबाई 100 वर्ण है।
  • कस्टम कोड ट्रेस कस्टम मीट्रिक और कस्टम विशेषताओं को जोड़ने का समर्थन करते हैं।

किसी कस्टम कोड ट्रेस को प्रारंभ और बंद करने के लिए, उस कोड को रैप करें जिसे आप ट्रेस करना चाहते हैं, निम्न के समान कोड की पंक्तियों के साथ (यह उदाहरण test_trace के कस्टम ट्रेस नाम का उपयोग करता है):

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace

myTrace.stop();

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.Trace;

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

(वैकल्पिक) @AddTrace . का उपयोग करके विशिष्ट विधियों की निगरानी करें

Android ऐप्स इंस्ट्रूमेंट कस्टम कोड ट्रेस के लिए @AddTrace एनोटेशन का भी समर्थन करते हैं। इस सुविधा का उपयोग करते हुए, ट्रेस निर्दिष्ट विधि की शुरुआत में शुरू होता है और विधि के पूरा होने पर रुक जाता है, जिसमें विधि द्वारा लागू कुछ भी शामिल है।

उदाहरण के लिए, आप एक कस्टम कोड ट्रेस बना सकते हैं जिसे onCreateTrace कहा जाता है, जो तब चलता है जब onCreate() विधि को कॉल किया जाता है।

Java

// Import these Performance Monitoring classes at the top of your `.java` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@Override
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
}

Kotlin+KTX

// Import these Performance Monitoring classes at the top of your `.kt` file
import com.google.firebase.perf.FirebasePerformance;
import com.google.firebase.perf.metrics.AddTrace;

// Add the `@AddTrace` annotation above the method you want to trace
@AddTrace(name = "onCreateTrace", enabled = true /* optional */)
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
}

कस्टम कोड ट्रेस में कस्टम मीट्रिक जोड़ें

कस्टम कोड ट्रेस में कस्टम मीट्रिक जोड़ने के लिए प्रदर्शन निगरानी ट्रेस API का उपयोग करें।

निम्नलिखित पर ध्यान दें:

  • कस्टम मीट्रिक के नाम निम्नलिखित आवश्यकताओं को पूरा करना चाहिए: कोई अग्रणी या पिछला व्हाइटस्पेस नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं है, और अधिकतम लंबाई 100 वर्ण है।
  • प्रत्येक कस्टम कोड ट्रेस 32 मीट्रिक (डिफ़ॉल्ट अवधि मीट्रिक सहित) तक रिकॉर्ड कर सकता है।

कोई कस्टम मीट्रिक जोड़ने के लिए, प्रत्येक बार ईवेंट होने पर निम्न के समान कोड की एक पंक्ति जोड़ें. उदाहरण के लिए, यह कस्टम मीट्रिक आपके ऐप में होने वाले प्रदर्शन-संबंधी ईवेंट की गणना करता है, जैसे कैश हिट और मिस (उदाहरण के लिए item_cache_hit और item_cache_miss के ईवेंट नामों और 1 की वृद्धि का उपयोग करके)।

Java

Trace myTrace = FirebasePerformance.getInstance().newTrace("test_trace");
myTrace.start();

// code that you want to trace (and log custom metrics)
Item item = cache.fetch("item");
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1);
} else {
    myTrace.incrementMetric("item_cache_miss", 1);
}

myTrace.stop();

Kotlin+KTX

val myTrace = Firebase.performance.newTrace("test_trace")
myTrace.start()

// code that you want to trace (and log custom metrics)
val item = cache.fetch("item")
if (item != null) {
    myTrace.incrementMetric("item_cache_hit", 1)
} else {
    myTrace.incrementMetric("item_cache_miss", 1)
}

myTrace.stop()

कस्टम कोड ट्रेस के लिए कस्टम विशेषताएँ बनाएँ

कस्टम कोड ट्रेस में कस्टम विशेषताओं को जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस API का उपयोग करें।

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

निम्नलिखित पर ध्यान दें:

  • कस्टम विशेषताओं के लिए नाम निम्नलिखित आवश्यकताओं को पूरा करना चाहिए: कोई अग्रणी या पिछला व्हाइटस्पेस नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं है, और अधिकतम लंबाई 32 वर्ण है।

  • प्रत्येक कस्टम कोड ट्रेस अधिकतम 5 कस्टम विशेषताओं को रिकॉर्ड कर सकता है।

  • आपको ऐसी कस्टम विशेषताओं का उपयोग नहीं करना चाहिए जिनमें ऐसी जानकारी हो जो Google को व्यक्तिगत रूप से किसी व्यक्ति की पहचान कराती हो।

    इस दिशानिर्देश के बारे में और जानें

Java

Trace trace = FirebasePerformance.getInstance().newTrace("test_trace");

// Update scenario.
trace.putAttribute("experiment", "A");

// Reading scenario.
String experimentValue = trace.getAttribute("experiment");

// Delete scenario.
trace.removeAttribute("experiment");

// Read attributes.
Map<String, String> traceAttributes = trace.getAttributes();

Kotlin+KTX

Firebase.performance.newTrace("test_trace").trace {
    // Update scenario.
    putAttribute("experiment", "A")

    // Reading scenario.
    val experimentValue = getAttribute("experiment")

    // Delete scenario.
    removeAttribute("experiment")

    // Read attributes.
    val traceAttributes = this.attributes
}

प्रदर्शन डेटा ट्रैक करें, देखें और फ़िल्टर करें

अपने डैशबोर्ड में विशिष्ट मीट्रिक ट्रैक करें

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

Firebase प्रदर्शन निगरानी डैशबोर्ड में मीट्रिक बोर्ड की एक छवि

अपने मीट्रिक बोर्ड में मीट्रिक जोड़ने के लिए, इन चरणों का पालन करें:

  1. फायरबेस कंसोल में परफॉर्मेंस डैशबोर्ड पर जाएं।
  2. एक खाली मीट्रिक कार्ड पर क्लिक करें, फिर अपने बोर्ड में जोड़ने के लिए एक मौजूदा मीट्रिक चुनें।
  3. अधिक विकल्पों के लिए, उदाहरण के लिए, किसी मीट्रिक को बदलने या निकालने के लिए, अधिक विकल्पों के लिए, आबादी वाले मीट्रिक कार्ड पर पर क्लिक करें।

मेट्रिक्स बोर्ड समय के साथ एकत्र किए गए मीट्रिक डेटा को ग्राफिकल रूप में और संख्यात्मक प्रतिशत परिवर्तन दोनों के रूप में दिखाता है।

डैशबोर्ड का उपयोग करने के बारे में और जानें।

निशान और उनका डेटा देखें

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

प्रदर्शन निगरानी फायरबेस कंसोल में एक समस्या निवारण पृष्ठ प्रदान करता है जो मीट्रिक परिवर्तनों को हाइलाइट करता है, जिससे आपके ऐप्स और उपयोगकर्ताओं पर प्रदर्शन समस्याओं के प्रभाव को त्वरित रूप से संबोधित करना और कम करना आसान हो जाता है। जब आप संभावित प्रदर्शन समस्याओं के बारे में सीखते हैं, उदाहरण के लिए, निम्नलिखित परिदृश्यों में, आप समस्या निवारण पृष्ठ का उपयोग कर सकते हैं:

  • आप डैशबोर्ड पर प्रासंगिक मेट्रिक्स का चयन करते हैं और आपको एक बड़ा डेल्टा दिखाई देता है।
  • ट्रेस तालिका में आप शीर्ष पर सबसे बड़ा डेल्टा प्रदर्शित करने के लिए सॉर्ट करते हैं, और आपको एक महत्वपूर्ण प्रतिशत परिवर्तन दिखाई देता है।
  • आपको एक ईमेल अलर्ट प्राप्त होता है जो आपको एक प्रदर्शन समस्या की सूचना देता है।

आप निम्न तरीकों से समस्या निवारण पृष्ठ तक पहुँच सकते हैं:

  • मीट्रिक डैशबोर्ड पर, मीट्रिक विवरण देखें बटन पर क्लिक करें.
  • किसी भी मीट्रिक कार्ड पर => विवरण देखें चुनें। समस्या निवारण पृष्ठ आपके द्वारा चयनित मीट्रिक के बारे में जानकारी प्रदर्शित करता है।
  • ट्रेस तालिका में, ट्रेस नाम या उस ट्रेस से संबद्ध पंक्ति में किसी भी मीट्रिक मान पर क्लिक करें।
  • ईमेल अलर्ट में, अभी जाँच करें पर क्लिक करें।

जब आप ट्रेस तालिका में किसी ट्रेस नाम पर क्लिक करते हैं, तब आप रुचि के मीट्रिक में ड्रिल-डाउन कर सकते हैं। विशेषता के आधार पर डेटा फ़िल्टर करने के लिए फ़िल्टर बटन पर क्लिक करें, उदाहरण के लिए:

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

अपने ट्रेस के लिए डेटा देखने के बारे में और जानें।

अगले कदम

  • प्रदर्शन डेटा की जांच करने के लिए विशेषताओं का उपयोग करने के बारे में अधिक जानें।

  • Firebase कंसोल में प्रदर्शन समस्याओं को ट्रैक करने के तरीके के बारे में और जानें।

  • कोड परिवर्तनों के लिए अलर्ट सेट करें जो आपके ऐप के प्रदर्शन को खराब कर रहे हैं। उदाहरण के लिए, यदि किसी विशिष्ट कस्टम कोड ट्रेस की अवधि आपके द्वारा निर्धारित सीमा से अधिक हो जाती है, तो आप अपनी टीम के लिए ईमेल अलर्ट कॉन्फ़िगर कर सकते हैं।

  • उपयोगकर्ता सत्रों की विस्तृत रिपोर्ट देखें जिसमें आप उसी सत्र के दौरान एकत्र किए गए अन्य ट्रेस के समयरेखा संदर्भ में एक विशिष्ट ट्रेस देख सकते हैं।