परफ़ॉर्मेंस मॉनिटर करने की सुविधा, ट्रेस इकट्ठा करती है, ताकि आप अपने ऐप्लिकेशन की परफ़ॉर्मेंस को मॉनिटर कर सकें. ट्रेस, परफ़ॉर्मेंस डेटा की रिपोर्ट होती है. यह रिपोर्ट आपके ऐप्लिकेशन में दो पॉइंट के बीच कैप्चर की जाती है.
अपने ऐप्लिकेशन में खास कोड से जुड़े परफ़ॉर्मेंस डेटा को मॉनिटर करने के लिए, खुद के ट्रेस बनाए जा सकते हैं. कस्टम कोड ट्रेस की मदद से यह मेज़र किया जा सकता है कि किसी खास टास्क या एक सेट को पूरा करने में आपके ऐप्लिकेशन को कितना समय लगता है. उदाहरण के लिए, इमेज का सेट लोड करना या अपने डेटाबेस के बारे में क्वेरी करना.
कस्टम कोड ट्रेस की डिफ़ॉल्ट मेट्रिक उसकी "अवधि" (ट्रैस के शुरू और बंद होने के समय के बीच का समय) है. हालांकि, आपके पास कस्टम मेट्रिक जोड़ने की सुविधा भी है.
अपने कोड में, परफ़ॉर्मेंस मॉनिटर करने वाले SDK टूल से मिले एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस के शुरू और आखिरी हिस्से को तय किया जाता है.
कस्टम कोड ट्रेस बनाने के बाद, उन्हें कभी भी शुरू किया जा सकता है. ये थ्रेड सुरक्षित हैं.
इन ट्रेस के लिए इकट्ठा की गई डिफ़ॉल्ट मेट्रिक "अवधि" है. इसलिए, इन्हें कभी-कभी "अवधि ट्रेस" भी कहा जाता है.
ट्रेस टेबल के कस्टम ट्रेस सबटैब में इन ट्रेस का डेटा देखा जा सकता है. यह सबटेबल परफ़ॉर्मेंस डैशबोर्ड में सबसे नीचे मौजूद होती है. कंसोल का इस्तेमाल करने के बारे में बाद में ज़्यादा जानें.
डिफ़ॉल्ट एट्रिब्यूट, कस्टम एट्रिब्यूट, और कस्टम मेट्रिक
कस्टम कोड ट्रेस के लिए परफ़ॉर्मेंस मॉनिटर करने की सुविधा, डिफ़ॉल्ट एट्रिब्यूट (ऐप्लिकेशन का वर्शन, देश, डिवाइस वगैरह जैसे सामान्य मेटाडेटा) को अपने-आप लॉग करती है, ताकि आप Firebase कंसोल में ट्रेस के डेटा को फ़िल्टर कर सकें. आपके पास कस्टम एट्रिब्यूट (जैसे, गेम लेवल या उपयोगकर्ता प्रॉपर्टी) जोड़ने और उनकी निगरानी करने का विकल्प भी है.
ट्रेस के स्कोप में होने वाली परफ़ॉर्मेंस से जुड़े इवेंट के लिए, कस्टम मेट्रिक को रिकॉर्ड करने के लिए, कस्टम कोड ट्रेस को और कॉन्फ़िगर किया जा सकता है. उदाहरण के लिए, कैश मेमोरी हिट और मिस की संख्या या यूज़र इंटरफ़ेस (यूआई) के कुछ समय के लिए रिस्पॉन्स न होने की संख्या के लिए कस्टम मेट्रिक बनाई जा सकती है.
Firebase कंसोल में कस्टम एट्रिब्यूट और कस्टम मेट्रिक, ट्रेस की डिफ़ॉल्ट विशेषताओं और डिफ़ॉल्ट मेट्रिक के साथ दिखते हैं.
कस्टम कोड ट्रेस जोड़ना
खास ऐप्लिकेशन कोड को मॉनिटर करने के लिए, कस्टम कोड ट्रेस जोड़ने के लिए परफ़ॉर्मेंस मॉनिटरिंग ट्रेस एपीआई का इस्तेमाल करें.
निम्न पर ध्यान दें:
- किसी ऐप्लिकेशन में एक से ज़्यादा कस्टम कोड ट्रेस हो सकते हैं.
- एक समय में एक से ज़्यादा कस्टम कोड ट्रेस चलाए जा सकते हैं.
- कस्टम कोड ट्रेस के नाम नीचे दी गई शर्तों को पूरा करते हों:
शुरुआत में या आखिर में खाली सफ़ेद जगह न हो, शुरुआत में अंडरस्कोर (
_) वर्ण न हो, और ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं. - कस्टम कोड ट्रेस में, कस्टम मेट्रिक और कस्टम एट्रिब्यूट जोड़े जा सकते हैं.
कस्टम कोड ट्रेस को शुरू और बंद करने के लिए, नीचे दिए गए कोड से मिलते-जुलते कोड के साथ, उस कोड को रैप करें जिसे आपको ट्रेस करना है:
Trace customTrace = FirebasePerformance.instance.newTrace('custom-trace');
await customTrace.start();
// Code you want to trace
await customTrace.stop();
कस्टम कोड ट्रेस में कस्टम मेट्रिक जोड़ना
कस्टम कोड ट्रेस में कस्टम मेट्रिक जोड़ने के लिए, परफ़ॉर्मेंस मॉनिटरिंग ट्रेस एपीआई का इस्तेमाल करें.
निम्न पर ध्यान दें:
- कस्टम मेट्रिक के नाम नीचे दी गई ज़रूरी शर्तों को पूरा करते हैं:
शुरुआत में या आखिर में खाली सफ़ेद जगह नहीं, शुरू में अंडरस्कोर (
_) वर्ण मौजूद नहीं होना चाहिए, और ज़्यादा से ज़्यादा 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 कंसोल में परफ़ॉर्मेंस की समस्याओं को ट्रैक करने के तरीके के बारे में ज़्यादा जानें.
कोड में ऐसे बदलावों के लिए सूचनाएं सेट अप करें जो आपके ऐप्लिकेशन की परफ़ॉर्मेंस को खराब कर रहे हैं. उदाहरण के लिए, अगर किसी खास कस्टम कोड ट्रेस की अवधि सेट की गई सीमा से ज़्यादा हो जाती है, तो अपनी टीम के लिए ईमेल सूचना कॉन्फ़िगर की जा सकती है.