获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

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

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

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

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

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

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

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

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

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

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

कस्टम विशेषताएँ और कस्टम मीट्रिक ट्रेस के लिए डिफ़ॉल्ट विशेषताओं और डिफ़ॉल्ट मीट्रिक के साथ 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();

यूजर टाइमिंग एपीआई का उपयोग करके कस्टम कोड ट्रेस जोड़ें

प्रदर्शन मॉनिटरिंग ट्रेस एपीआई के अलावा, आप ब्राउज़र के मूल यूजर टाइमिंग एपीआई का उपयोग करके कस्टम कोड ट्रेस जोड़ सकते हैं। इस एपीआई का उपयोग करके मापी गई ट्रेस की अवधि स्वचालित रूप से प्रदर्शन मॉनिटरिंग एसडीके द्वारा उठाई जाती है। यदि आप प्रदर्शन निगरानी SDK को अतुल्यकालिक रूप से लोड करना चाहते हैं तो उपयोगकर्ता समय 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 का उपयोग करते समय, कस्टम मेट्रिक्स और विशेषताओं को कस्टम कोड ट्रेस में नहीं जोड़ा जा सकता है। यदि आप उन कस्टम तत्वों को कस्टम कोड ट्रेस में जोड़ना चाहते हैं तो प्रदर्शन मॉनिटरिंग ट्रेस एपीआई का उपयोग करें।

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

अगले कदम

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

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

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