परफ़ॉर्मेंस मॉनिटरिंग, ट्रेस इकट्ठा करती है, ताकि आप अपने ऐप्लिकेशन की परफ़ॉर्मेंस को मॉनिटर कर सकें. ट्रेस, आपके ऐप्लिकेशन में दो समय के बीच कैप्चर किए गए परफ़ॉर्मेंस डेटा की रिपोर्ट होती है.
अपने ऐप्लिकेशन में मौजूद किसी खास कोड से जुड़े परफ़ॉर्मेंस डेटा को मॉनिटर करने के लिए, खुद के ट्रेस बनाए जा सकते हैं. कस्टम कोड ट्रेस की मदद से, यह मेज़र किया जा सकता है कि आपके ऐप्लिकेशन को किसी खास टास्क या टास्क के सेट को पूरा करने में कितना समय लगता है. उदाहरण के लिए, इमेज के सेट को लोड करने या अपने डेटाबेस से क्वेरी करने में कितना समय लगता है.
कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मेट्रिक, इसकी "अवधि" होती है. यह ट्रेस के शुरू और खत्म होने के बीच का समय होता है. हालांकि, इसमें कस्टम मेट्रिक भी जोड़ी जा सकती हैं.
अपने कोड में, कस्टम कोड ट्रेस की शुरुआत और आखिर को तय करने के लिए, परफ़ॉर्मेंस मॉनिटरिंग एसडीके के एपीआई का इस्तेमाल करें.
कस्टम कोड ट्रेस को बनाने के बाद, कभी भी शुरू किया जा सकता है. साथ ही, ये थ्रेड सेफ़ होते हैं.
इन ट्रेस के लिए इकट्ठा की गई डिफ़ॉल्ट मेट्रिक "अवधि" होती है. इसलिए, इन्हें कभी-कभी "अवधि ट्रेस" भी कहा जाता है.
इन ट्रेस का डेटा, ट्रेस टेबल के कस्टम ट्रेस सब-टैब में देखा जा सकता है. यह टेबल, परफ़ॉर्मेंस डैशबोर्ड में सबसे नीचे होती है. इस पेज पर, कंसोल का इस्तेमाल करने के बारे में ज़्यादा जानें.
डिफ़ॉल्ट एट्रिब्यूट, कस्टम एट्रिब्यूट, और कस्टम मेट्रिक
कस्टम कोड ट्रेस के लिए, परफ़ॉर्मेंस मॉनिटरिंग की सुविधा, डिफ़ॉल्ट एट्रिब्यूट को अपने-आप लॉग करती है. इनमें ऐप्लिकेशन का वर्शन, देश, डिवाइस वगैरह जैसे सामान्य मेटाडेटा शामिल हैं. इससे Firebase कंसोल में, ट्रेस के लिए डेटा को फ़िल्टर किया जा सकता है. कस्टम एट्रिब्यूट (जैसे, गेम लेवल या उपयोगकर्ता प्रॉपर्टी) को भी जोड़ा और मॉनिटर किया जा सकता है.
कस्टम कोड ट्रेस को कॉन्फ़िगर करके, परफ़ॉर्मेंस से जुड़े इवेंट के लिए कस्टम मेट्रिक रिकॉर्ड की जा सकती हैं. ये इवेंट, ट्रेस के दायरे में होते हैं. उदाहरण के लिए, कैश मेमोरी में हिट और मिस की संख्या या यूज़र इंटरफ़ेस (यूआई) के कुछ समय तक काम न करने की संख्या के लिए, कस्टम मेट्रिक बनाई जा सकती है.
कस्टम एट्रिब्यूट और कस्टम मेट्रिक, Firebase कंसोल में ट्रेस के लिए डिफ़ॉल्ट एट्रिब्यूट और डिफ़ॉल्ट मेट्रिक के साथ दिखती हैं.
कस्टम कोड ट्रेस जोड़ना
खास ऐप्लिकेशन कोड को मॉनिटर करने के लिए, कस्टम कोड ट्रेस जोड़ें. इसके लिए, परफ़ॉर्मेंस मॉनिटरिंग ट्रेस एपीआई का इस्तेमाल करें.
निम्न पर ध्यान दें:
- किसी ऐप्लिकेशन में कई कस्टम कोड ट्रेस हो सकते हैं.
- एक ही समय पर, कस्टम कोड ट्रेस की एक से ज़्यादा प्रोसेस चल सकती हैं.
- कस्टम कोड ट्रेस के नाम के लिए, ये ज़रूरी शर्तें पूरी होनी चाहिए:
शुरुआत या आखिर में कोई खाली सफ़ेद जगह नहीं होनी चाहिए, शुरुआत में अंडरस्कोर (
_) वर्ण नहीं होना चाहिए, और ज़्यादा से ज़्यादा 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 कंसोल में परफ़ॉर्मेंस डैशबोर्ड पर जाएं. इसके बाद, नीचे की ओर स्क्रोल करके ट्रेस टेबल पर जाएं और सही सब-टैब पर क्लिक करें. टेबल में हर ट्रेस के लिए कुछ मुख्य मेट्रिक दिखती हैं. साथ ही, किसी खास मेट्रिक के लिए, सूची को प्रतिशत में हुए बदलाव के हिसाब से क्रम में लगाया जा सकता है.
ट्रेस टेबल में किसी ट्रेस के नाम पर क्लिक करके, अलग-अलग स्क्रीन पर क्लिक किया जा सकता है. इससे ट्रेस को एक्सप्लोर किया जा सकता है और अपनी पसंद की मेट्रिक के बारे में ज़्यादा जानकारी हासिल की जा सकती है. ज़्यादातर पेजों पर, एट्रिब्यूट के हिसाब से डेटा को फ़िल्टर करने के लिए, फ़िल्टर करें बटन (स्क्रीन पर सबसे ऊपर बाईं ओर) का इस्तेमाल किया जा सकता है. उदाहरण के लिए:
- पिछली या नई रिलीज़ का डेटा देखने के लिए, ऐप्लिकेशन के वर्शन के हिसाब से फ़िल्टर करें
- डिवाइस के हिसाब से फ़िल्टर करके जानें कि पुराने डिवाइसों पर आपका ऐप्लिकेशन कैसा परफ़ॉर्म करता है
- देश के हिसाब से फ़िल्टर करें, ताकि यह पक्का किया जा सके कि आपके डेटाबेस की जगह से किसी खास इलाके पर असर न पड़ रहा हो
ट्रेस का डेटा देखने के बारे में ज़्यादा जानें.
अगले चरण
परफ़ॉर्मेंस डेटा की जांच करने के लिए, एट्रिब्यूट इस्तेमाल करने के बारे में ज़्यादा जानें.
Firebase कंसोल में, परफ़ॉर्मेंस की समस्याओं को ट्रैक करने के तरीके के बारे में ज़्यादा जानें.
कोड में होने वाले ऐसे बदलावों के लिए सूचनाएं सेट अप करें जिनसे आपके ऐप्लिकेशन की परफ़ॉर्मेंस खराब हो रही है. उदाहरण के लिए, अगर किसी कस्टम कोड ट्रेस की अवधि आपके सेट किए गए थ्रेशोल्ड से ज़्यादा हो जाती है, तो अपनी टीम के लिए ईमेल से सूचना पाने की सुविधा कॉन्फ़िगर की जा सकती है.