Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

कस्टम कोड ट्रेस बनाए जाने के बाद उन्हें कभी भी शुरू किया जा सकता है, और वे थ्रेड सुरक्षित हैं।

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

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

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

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

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

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

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

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

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

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

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

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

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

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

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

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

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

Trace customTrace = FirebasePerformance.instance.newTrace("custom-trace");
await customTrace.start();

// Code you want to trace

customTrace.incrementMetric("metric-name", 1);

// More code

await customTrace.stop();

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

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

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

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

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

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

Trace trace = FirebasePerformance.instance.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();

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

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

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

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

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

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

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

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

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

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

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

अगले कदम

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

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

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