Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

तीव्र

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
// Add the Performance Monitoring module to your header
import FirebasePerformance

let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

// code that you want to trace

trace.stop()

उद्देश्य सी

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
// Add the Performance Monitoring module to your header
@import FirebasePerformance;

FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

// code that you want to trace

[trace stop];

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

कस्टम कोड ट्रेस में कस्टम मेट्रिक्स जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस एपीआई ( स्विफ्ट | ओब्ज-सी ) का उपयोग करें।

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

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

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

तीव्र

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.incrementMetric(named:"EVENT_NAME", by: 1)
// code that you want to trace (and log custom metrics)

trace.stop()

उद्देश्य सी

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace incrementMetric:@"EVENT_NAME" byInt:1];
// code that you want to trace (and log custom metrics)

[trace stop];

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

कस्टम कोड ट्रेस में कस्टम विशेषताएँ जोड़ने के लिए प्रदर्शन मॉनिटरिंग ट्रेस API ( स्विफ़्ट | ओब्ज-सी ) का उपयोग करें।

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

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

  • कस्टम एट्रिब्यूट के नामों को निम्न आवश्यकताओं को पूरा करना चाहिए:

    • कोई अग्रणी या पिछला सफेद स्थान नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं
    • कोई रिक्त स्थान
    • अधिकतम लंबाई 32 वर्ण है
    • नाम के लिए अनुमत वर्ण AZ , az , और _ हैं।

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

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

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

तीव्र

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
let trace = Performance.startTrace(name: "CUSTOM_TRACE_NAME")

trace.setValue("A", forAttribute: "experiment")

// Update scenario.
trace.setValue("B", forAttribute: "experiment")

// Reading scenario.
let experimentValue:String? = trace.valueForAttribute("experiment")

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

// Read attributes.
let attributes:[String, String] = trace.attributes;

उद्देश्य सी

नोट: यह फायरबेस उत्पाद macOS, Mac Catalyst, watchOS लक्ष्यों पर उपलब्ध नहीं है।
FIRTrace *trace = [FIRPerformance startTraceWithName:@"CUSTOM_TRACE_NAME"];

[trace setValue:@"A" forAttribute:@"experiment"];

// Update scenario.
[trace setValue:@"B" forAttribute:@"experiment"];

// Reading scenario.
NSString *experimentValue = [trace valueForAttribute:@"experiment"];

// Delete scenario.
[trace removeAttribute:@"experiment"];

// Read attributes.
NSDictionary <NSString *, NSString *> *attributes = [trace attributes];

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले कदम

  • परफ़ॉर्मेंस डेटा की जांच करने के लिए एट्रिब्यूट का इस्तेमाल करने के बारे में ज़्यादा जानें.

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

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

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