प्रदर्शन निगरानी आपके ऐप के प्रदर्शन की निगरानी करने में आपकी सहायता के लिए निशान एकत्र करती है। ट्रेस आपके ऐप में समय में दो बिंदुओं के बीच कैप्चर किए गए प्रदर्शन डेटा की एक रिपोर्ट है।
आप अपने ऐप में विशिष्ट कोड से जुड़े प्रदर्शन डेटा की निगरानी के लिए अपने खुद के निशान बना सकते हैं। एक कस्टम कोड ट्रेस के साथ, आप यह माप सकते हैं कि किसी विशिष्ट कार्य या कार्यों के एक सेट को पूरा करने में आपके ऐप को कितना समय लगता है, उदाहरण के लिए छवियों का एक सेट लोड करना या अपने डेटाबेस को क्वेरी करना।
कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मीट्रिक इसकी "अवधि" (ट्रेस के आरंभिक और समाप्ति बिंदुओं के बीच का समय) है, लेकिन आप कस्टम मीट्रिक भी जोड़ सकते हैं।
अपने कोड में, आप प्रदर्शन निगरानी एसडीके द्वारा प्रदान किए गए एपीआई का उपयोग करके कस्टम कोड ट्रेस की शुरुआत और अंत को परिभाषित करते हैं।
कस्टम कोड ट्रेस को बनाए जाने के बाद कभी भी प्रारंभ किया जा सकता है, और वे थ्रेड सुरक्षित होते हैं।
चूंकि इन निशानों के लिए एकत्र की गई डिफ़ॉल्ट मीट्रिक "अवधि" है, इसलिए उन्हें कभी-कभी "अवधि के निशान" कहा जाता है।
आप ट्रेस तालिका के कस्टम ट्रेस उपटैब में इन ट्रेस से डेटा देख सकते हैं, जो प्रदर्शन डैशबोर्ड के नीचे है (इस पृष्ठ पर बाद में कंसोल का उपयोग करने के बारे में और जानें)।
डिफ़ॉल्ट विशेषताएँ, कस्टम विशेषताएँ और कस्टम मीट्रिक
कस्टम कोड ट्रेस के लिए, प्रदर्शन निगरानी स्वचालित रूप से डिफ़ॉल्ट विशेषताओं (ऐप संस्करण, देश, डिवाइस इत्यादि जैसे सामान्य मेटाडेटा) को लॉग करती है ताकि आप फायरबेस कंसोल में ट्रेस के लिए डेटा फ़िल्टर कर सकें। आप कस्टम विशेषताओं (जैसे, गेम स्तर या उपयोगकर्ता गुण) को जोड़ और मॉनिटर भी कर सकते हैं।
आप ट्रेस के दायरे में होने वाली प्रदर्शन-संबंधी घटनाओं के लिए कस्टम मेट्रिक्स रिकॉर्ड करने के लिए एक कस्टम कोड ट्रेस को और कॉन्फ़िगर कर सकते हैं। उदाहरण के लिए, आप कैशे हिट और मिस की संख्या के लिए एक कस्टम मीट्रिक बना सकते हैं या यूआई कितनी बार ध्यान देने योग्य समय के लिए अनुत्तरदायी हो जाता है।
कस्टम विशेषताएँ और कस्टम मीट्रिक ट्रेस के लिए डिफ़ॉल्ट विशेषताओं और डिफ़ॉल्ट मीट्रिक के साथ Firebase कंसोल में प्रदर्शित होते हैं।
कस्टम कोड ट्रेस जोड़ें
विशिष्ट एप्लिकेशन कोड की निगरानी के लिए कस्टम कोड ट्रेस जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस एपीआई का उपयोग करें।
निम्नलिखित पर ध्यान दें:
- एक ऐप में कई कस्टम कोड ट्रेस हो सकते हैं।
- एक से अधिक कस्टम कोड ट्रेस एक ही समय में चल सकते हैं।
- कस्टम कोड ट्रेस के लिए नामों को निम्नलिखित आवश्यकताओं को पूरा करना चाहिए: कोई आगे या पीछे सफेद जगह नहीं, कोई अग्रणी अंडरस्कोर (
_) वर्ण नहीं है, और अधिकतम लंबाई 100 वर्ण है। - कस्टम कोड ट्रेस कस्टम मेट्रिक्स और कस्टम विशेषताओं को जोड़ने का समर्थन करते हैं।
कस्टम कोड ट्रेस को प्रारंभ और बंद करने के लिए, उस कोड को रैप करें जिसे आप निम्नलिखित के समान कोड के साथ ट्रेस करना चाहते हैं:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
कस्टम कोड ट्रेस में कस्टम मेट्रिक्स जोड़ें
कस्टम कोड ट्रेस में कस्टम मेट्रिक्स जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस एपीआई का उपयोग करें।
निम्नलिखित पर ध्यान दें:
- कस्टम मीट्रिक के लिए नामों को निम्न आवश्यकताओं को पूरा करना चाहिए: कोई आगे या पीछे खाली स्थान नहीं, कोई अग्रणी अंडरस्कोर (
_) वर्ण नहीं, और अधिकतम लंबाई 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 के लिए किसी व्यक्ति की व्यक्तिगत रूप से पहचान करती हो।
प्रदर्शन निगरानी स्वयं कोई व्यक्तिगत पहचान योग्य जानकारी (पीआईआई) एकत्र नहीं करती है, जैसे नाम, ईमेल पते या फोन नंबर। डेवलपर कस्टम कोड ट्रेस पर कस्टम विशेषताएँ बनाकर प्रदर्शन मॉनिटरिंग का उपयोग करके अतिरिक्त डेटा एकत्र कर सकते हैं। प्रदर्शन निगरानी के माध्यम से एकत्र किए गए ऐसे डेटा में ऐसी जानकारी नहीं होनी चाहिए जो व्यक्तिगत रूप से Google को किसी व्यक्ति की पहचान कराती हो।
यहां एक लॉग संदेश का उदाहरण दिया गया है जिसमें व्यक्तिगत रूप से पहचान योग्य जानकारी शामिल नहीं है:
customTrace.putAttribute("experiment", "A"); // OKयहां एक उदाहरण दिया गया है जिसमें व्यक्तिगत रूप से पहचान योग्य जानकारी शामिल है (अपने ऐप में इस प्रकार की कस्टम विशेषता का उपयोग न करें):
customTrace.putAttribute(("email", user.getEmailAddress()); // Don't do this!डेटा जो किसी भी व्यक्तिगत रूप से पहचान योग्य जानकारी को उजागर करता है, बिना सूचना के विलोपन के अधीन है।
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 कंसोल में प्रदर्शन संबंधी समस्याओं को ट्रैक करने के तरीके के बारे में अधिक जानें.
कोड परिवर्तनों के लिए अलर्ट सेट करें जो आपके ऐप के प्रदर्शन को खराब कर रहे हैं। उदाहरण के लिए, यदि किसी विशिष्ट कस्टम कोड ट्रेस की अवधि आपके द्वारा निर्धारित सीमा से अधिक हो जाती है, तो आप अपनी टीम के लिए एक ईमेल अलर्ट कॉन्फ़िगर कर सकते हैं।