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

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

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

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

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

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

फायरबेस कंसोल के डिवाइस टैब पर कस्टम कोड के निशान से डेटा देखें (इस पृष्ठ पर और बाद में जानें )। ध्यान दें कि इन निशानों के लिए एकत्रित डिफ़ॉल्ट मीट्रिक "अवधि" है, उन्हें कभी-कभी "अवधि निशान" कहा जाता है। साथ ही, फायरबेस कंसोल ( ऑन डिवाइस टैब) में, इन निशानों को ड्यूरेशन लेबल वाली टेबल के नीचे रखा गया है।

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

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

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

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

कस्टम कोड निशान जोड़ें

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

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

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

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

जावा

// 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 = FirebasePerformance.getInstance().newTrace("test_trace")
myTrace.start()

// code that you want to trace

myTrace.stop()

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

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

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

जावा

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

कस्टम मेट्रिक्स को कस्टम कोड के निशान में जोड़ें

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

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

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

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

जावा

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 = FirebasePerformance.getInstance().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()

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

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

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

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

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

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

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

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

जावा

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

val trace = FirebasePerformance.getInstance().newTrace("test_trace")

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

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

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

// Read attributes.
val traceAttributes = trace.attributes

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

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

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

फायरबेस परफॉर्मेंस मॉनिटरिंग मेट्रिक्स डैशबोर्ड की एक छवि

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

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

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

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

इन निशानों को देखने के लिए, फायरबेस कंसोल में प्रदर्शन डैशबोर्ड पर जाएं, फिर डिवाइस टैब पर क्लिक करें।

ऑन डिवाइस टैब से, आप ट्रेस का पता लगाने और ब्याज की मीट्रिक में नीचे ड्रिल करने के लिए विभिन्न स्क्रीन के माध्यम से क्लिक कर सकते हैं। अधिकांश पृष्ठों पर, उदाहरण के लिए, डेटा को फ़िल्टर करने के लिए आप फ़िल्टर बटन (स्क्रीन के ऊपर-बाएँ) का उपयोग कर सकते हैं:

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

अपने निशान के लिए डेटा देखने के बारे में अधिक जानें।

अगला कदम

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