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