खास ऐप्लिकेशन कोड के लिए, अपने हिसाब से मॉनिटरिंग की सुविधा चालू करें


परफ़ॉर्मेंस मॉनिटरिंग, ट्रेस इकट्ठा करती है. इससे आपको अपने ऐप्लिकेशन की परफ़ॉर्मेंस को मॉनिटर करने में मदद मिलती है. ट्रेस, आपके ऐप्लिकेशन में किसी समयावधि के दौरान कैप्चर किए गए परफ़ॉर्मेंस डेटा की रिपोर्ट होती है.

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

कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मेट्रिक, "अवधि" होती है. यह ट्रेस के शुरू और खत्म होने के बीच का समय होता है. हालांकि, कस्टम मेट्रिक भी जोड़ी जा सकती हैं.

अपने कोड में, परफ़ॉर्मेंस मॉनिटरिंग एसडीके की ओर से उपलब्ध कराए गए एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस की शुरुआत और खत्म होने का समय तय करें.

कस्टम कोड ट्रेस को बनाने के बाद, किसी भी समय शुरू किया जा सकता है. साथ ही, ये थ्रेड सेफ़ होते हैं.

इन ट्रेस के लिए, डिफ़ॉल्ट मेट्रिक के तौर पर "अवधि" को इकट्ठा किया जाता है. इसलिए, इन्हें कभी-कभी "अवधि के ट्रेस" भी कहा जाता है.

इन ट्रेस का डेटा, ट्रेस टेबल के कस्टम ट्रेस सबटैब में देखा जा सकता है. यह टेबल, परफ़ॉर्मेंस डैशबोर्ड में सबसे नीचे होती है. कंसोल का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, इस पेज पर बाद में पढ़ें.

डिफ़ॉल्ट एट्रिब्यूट, कस्टम एट्रिब्यूट, और कस्टम मेट्रिक

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

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

कस्टम एट्रिब्यूट और कस्टम मेट्रिक, Firebase कंसोल में दिखती हैं. ये ट्रेस के डिफ़ॉल्ट एट्रिब्यूट और डिफ़ॉल्ट मेट्रिक के साथ दिखती हैं.

कस्टम कोड ट्रेस जोड़ना

Performance Monitoring Trace API का इस्तेमाल करके, कस्टम कोड ट्रेस जोड़ें. इससे ऐप्लिकेशन के किसी खास कोड को मॉनिटर किया जा सकता है.

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

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

कस्टम कोड ट्रेस को शुरू और बंद करने के लिए, उस कोड को रैप करें जिसे आपको ट्रेस करना है. इसके लिए, यहां दिए गए कोड जैसा कोड इस्तेमाल करें:

Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();

// Code you want to trace

await customTrace.stop();

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

कस्टम कोड ट्रेस में कस्टम मेट्रिक जोड़ने के लिए, Performance Monitoring Trace API का इस्तेमाल करें.

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

  • कस्टम मेट्रिक के नाम इन ज़रूरी शर्तों को पूरा करते हों: शुरुआत या आखिर में कोई खाली जगह न हो, शुरुआत में अंडरस्कोर (_) वर्ण न हो, और ज़्यादा से ज़्यादा 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 वर्ण होनी चाहिए.

  • हर कस्टम कोड ट्रेस, ज़्यादा से ज़्यादा पांच कस्टम एट्रिब्यूट रिकॉर्ड कर सकता है.

  • आपको ऐसे कस्टम एट्रिब्यूट का इस्तेमाल नहीं करना चाहिए जिनमें ऐसी जानकारी शामिल हो जिससे Google किसी व्यक्ति की पहचान कर सके.

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();

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

अपने डैशबोर्ड में कुछ खास मेट्रिक ट्रैक करना

अपनी अहम मेट्रिक के रुझान के बारे में जानने के लिए, उन्हें परफ़ॉर्मेंस डैशबोर्ड में सबसे ऊपर मौजूद मेट्रिक बोर्ड में जोड़ें. हर हफ़्ते होने वाले बदलावों को देखकर, तुरंत रिग्रेशन की पहचान की जा सकती है. इसके अलावा, यह पुष्टि की जा सकती है कि कोड में हाल ही में किए गए बदलावों से परफ़ॉर्मेंस बेहतर हो रही है.

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

मेट्रिक बोर्ड में, समय के साथ इकट्ठा किया गया मेट्रिक डेटा दिखता है. यह डेटा, ग्राफ़ के साथ-साथ संख्यात्मक प्रतिशत बदलाव के तौर पर भी दिखता है.

डैशबोर्ड का इस्तेमाल करने के बारे में ज़्यादा जानें.

ट्रेस और उनका डेटा देखना

अपने ट्रेस देखने के लिए, Firebase कंसोल में परफ़ॉर्मेंस डैशबोर्ड पर जाएं. इसके बाद, ट्रेस टेबल तक नीचे की ओर स्क्रोल करें. फिर, सही सबटैब पर क्लिक करें. इस टेबल में, हर ट्रेस के लिए कुछ टॉप मेट्रिक दिखती हैं. साथ ही, किसी खास मेट्रिक के लिए, बदलाव के प्रतिशत के हिसाब से सूची को क्रम से लगाया जा सकता है.

ट्रेस टेबल में किसी ट्रेस के नाम पर क्लिक करने के बाद, अलग-अलग स्क्रीन पर क्लिक करके ट्रेस को एक्सप्लोर किया जा सकता है. साथ ही, अपनी पसंद की मेट्रिक के बारे में ज़्यादा जानकारी पाई जा सकती है. ज़्यादातर पेजों पर, एट्रिब्यूट के हिसाब से डेटा को फ़िल्टर करने के लिए, फ़िल्टर बटन (स्क्रीन के सबसे ऊपर बाईं ओर) का इस्तेमाल किया जा सकता है. उदाहरण के लिए:

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

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

अगले चरण