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

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Web modular API

import { trace } from "firebase/performance";

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

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

t.stop();perf_add_custom_trace.js

Web namespaced API

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

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

trace.stop();index.js

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

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

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

Web modular API

const performance = window.performance;

performance.mark("measurementStart");

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

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

Web namespaced API

const performance = window.performance;

performance.mark("measurementStart");

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

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

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

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

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

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

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

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

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

Web modular API

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;
}perf_add_custom_metrics.js

Web namespaced API

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;
}index.js

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

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

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

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

कस्टम विशेषताओं के नाम निम्नलिखित आवश्यकताओं को पूरा करने चाहिए:
- कोई अग्रणी या अनुगामी रिक्त स्थान नहीं, कोई अग्रणी अंडरस्कोर ( _ ) वर्ण नहीं
- कोई रिक्त स्थान
- अधिकतम लंबाई 32 अक्षर है
- नाम के लिए अनुमत वर्ण AZ , az , और _ हैं।
प्रत्येक कस्टम कोड ट्रेस अधिकतम 5 कस्टम विशेषताएँ रिकॉर्ड कर सकता है।
कृपया सुनिश्चित करें कि कस्टम विशेषताओं में ऐसी कोई जानकारी न हो जो Google को किसी व्यक्ति की व्यक्तिगत पहचान कराती हो।
इस दिशानिर्देश के बारे में और जानें
उपयोगकर्ता डेटा एकत्र करना: प्रदर्शन निगरानी स्वयं कोई व्यक्तिगत पहचान योग्य जानकारी (पीआईआई) एकत्र नहीं करती है, जैसे नाम, ईमेल पते या फोन नंबर। डेवलपर्स कस्टम कोड ट्रेस पर कस्टम विशेषताएँ बनाकर प्रदर्शन मॉनिटरिंग का उपयोग करके अतिरिक्त डेटा एकत्र कर सकते हैं। प्रदर्शन निगरानी के माध्यम से एकत्र किए गए ऐसे डेटा में ऐसी जानकारी नहीं होनी चाहिए जो Google को किसी व्यक्ति की व्यक्तिगत पहचान कराती हो।
यहां एक लॉग संदेश का उदाहरण दिया गया है जिसमें व्यक्तिगत पहचान योग्य जानकारी शामिल नहीं है :
```
trace.putAttribute("experiment", "A");
```
यहां एक उदाहरण दिया गया है जिसमें व्यक्तिगत रूप से पहचान योग्य जानकारी शामिल है (अपने ऐप में इस प्रकार की कस्टम विशेषता का उपयोग न करें ):
```
trace.putAttribute("email", user.getEmailAddress());
```
वह डेटा जो किसी व्यक्तिगत पहचान योग्य जानकारी को उजागर करता है, बिना किसी सूचना के हटाया जा सकता है।

Web modular API

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();perf_add_custom_attributes.js

Web namespaced API

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();index.js

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

विशेषता द्वारा फ़िल्टर किए जा रहे फ़ायरबेस प्रदर्शन मॉनिटरिंग डेटा की एक छवि

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

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

अगले कदम

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