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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Web version 9

import { trace } from "firebase/performance";

const t = trace(perf, "CUSTOM_TRACE_NAME");
t.start();

// Code that you want to trace 
// ...

t.stop();

Web version 8

const trace = perf.trace("CUSTOM_TRACE_NAME");
trace.start();

// Code that you want to trace 
// ...

trace.stop();

उपयोगकर्ता समय API का उपयोग करके कस्टम कोड ट्रेस जोड़ें

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

इस सुविधा का उपयोग करने के लिए, उस कोड को लपेटें जिसे आप उपयोगकर्ता समय चिह्नों के साथ ट्रेस करना चाहते हैं:

Web version 9

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

Web version 8

const performance = window.performance;

performance.mark("measurementStart");

// Code that you want to trace 
// ...

performance.mark("measurementStop");
performance.measure("customTraceName", "measurementStart", "measurementStop");

ध्यान दें कि ऊपर दिए गए उदाहरण में performance ब्राउज़र की window.performance ऑब्जेक्ट को संदर्भित करता है।

उपयोगकर्ता समय API का उपयोग करते समय, कस्टम मीट्रिक और विशेषताओं को कस्टम कोड ट्रेस में नहीं जोड़ा जा सकता है। यदि आप उन कस्टम तत्वों को कस्टम कोड ट्रेस में जोड़ना चाहते हैं, तो प्रदर्शन मॉनिटरिंग ट्रेस API का उपयोग करें।

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

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

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

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

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

Web version 9

import { trace } from "firebase/performance";

async function getInventory(inventoryIds) {
  const t = trace(perf, "inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  t.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  t.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  t.stop();

  return inventoryData;
}

Web version 8

async function getInventory(inventoryIds) {
  const trace = perf.trace("inventoryRetrieval");

  // Tracks the number of IDs fetched (the metric could help you to optimize in the future)
  trace.incrementMetric("numberOfIds", inventoryIds.length);

  // Measures the time it takes to request inventory based on the amount of inventory
  trace.start();
  const inventoryData = await retrieveInventory(inventoryIds);
  trace.stop();

  return inventoryData;
}

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

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

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

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

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

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

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

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

Web version 9

import { trace } from "firebase/performance";

const t = trace(perf, "test_trace");
t.putAttribute("experiment", "A");

// Update scenario
t.putAttribute("experiment", "B");

// Reading scenario
const experimentValue = t.getAttribute("experiment");

// Delete scenario
t.removeAttribute("experiment");

// Read attributes
const traceAttributes = t.getAttributes();

Web version 8

const trace = perf.trace("test_trace");
trace.putAttribute("experiment", "A");

// Update scenario
trace.putAttribute("experiment", "B");

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

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

// Read attributes
const traceAttributes = trace.getAttributes();

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

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

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

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

Firebase प्रदर्शन निगरानी डैशबोर्ड में मीट्रिक बोर्ड की एक छवि

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले कदम

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

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

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