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

आईओएस+ एंड्रॉइड वेब फ़्लटर

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

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

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

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

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

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

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

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

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

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

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

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

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

कस्टम कोड अंश जोड़ें

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

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

• एक ऐप में एकाधिक कस्टम कोड ट्रेस हो सकते हैं।
• एक ही समय में एक से अधिक कस्टम कोड ट्रेस चल सकते हैं।
• कस्टम कोड ट्रेस के नामों को निम्नलिखित आवश्यकताओं को पूरा करना होगा: कोई अग्रणी या पिछला खाली स्थान नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं, और अधिकतम लंबाई 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();

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

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

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

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

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

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

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

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

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

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

अपने निशानों का डेटा देखने के बारे में और जानें।

अगले कदम

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

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

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