यह पृष्ठ प्रदर्शन निगरानी शुरू करने या प्रदर्शन निगरानी सुविधाओं और टूलींग का उपयोग करने के लिए समस्या निवारण युक्तियाँ प्रदान करता है।
समस्या निवारण के लिए पहले जाँच करता है
आगे की समस्या निवारण से पहले किसी के लिए भी निम्नलिखित दो जाँचें अनुशंसित सामान्य सर्वोत्तम प्रथाएँ हैं।
1. प्रदर्शन घटनाओं के लिए लॉग संदेशों की जाँच करें
यह सुनिश्चित करने के लिए अपने लॉग संदेशों की जाँच करें कि प्रदर्शन मॉनिटरिंग एसडीके प्रदर्शन घटनाओं को कैप्चर कर रहा है।
अपने ऐप की
AndroidManifest.xml
फ़ाइल में<meta-data>
तत्व जोड़कर बिल्ड समय पर प्रदर्शन मॉनिटरिंग के लिए डिबग लॉगिंग सक्षम करें, जैसे:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
किसी भी त्रुटि संदेश के लिए अपने लॉग संदेशों की जाँच करें।
परफॉर्मेंस मॉनिटरिंग अपने लॉग संदेशों को
FirebasePerformance
के साथ टैग करता है। लॉगकैट फ़िल्टरिंग का उपयोग करके, आप निम्न कमांड चलाकर विशेष रूप से अवधि ट्रेस और HTTP/S नेटवर्क अनुरोध लॉगिंग देख सकते हैं:adb logcat -s FirebasePerformance
निम्नलिखित प्रकार के लॉग की जाँच करें जो इंगित करते हैं कि प्रदर्शन निगरानी प्रदर्शन घटनाओं को लॉग कर रही है:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
फायरबेस कंसोल में अपना डेटा देखने के लिए यूआरएल पर क्लिक करें। डैशबोर्ड में डेटा अपडेट होने में कुछ समय लग सकता है।
यदि आपका ऐप प्रदर्शन ईवेंट लॉग नहीं कर रहा है, तो समस्या निवारण युक्तियों की समीक्षा करें।
2. फायरबेस स्थिति डैशबोर्ड की जाँच करें
यदि फायरबेस या प्रदर्शन मॉनिटरिंग के लिए कोई ज्ञात आउटेज है तो फायरबेस स्थिति डैशबोर्ड की जाँच करें।
प्रदर्शन निगरानी के साथ शुरुआत करना
यदि आप प्रदर्शन मॉनिटरिंग ( आईओएस+ | एंड्रॉइड | वेब ) के साथ शुरुआत कर रहे हैं, तो निम्नलिखित समस्या निवारण युक्तियाँ उन समस्याओं में मदद कर सकती हैं जिनमें फायरबेस एसडीके का पता लगाना या फायरबेस कंसोल में अपना पहला प्रदर्शन डेटा प्रदर्शित करना शामिल है।
जब फायरबेस आपके ऐप से इवेंट की जानकारी (जैसे ऐप इंटरैक्शन) प्राप्त करता है तो यह पता लगा सकता है कि आपने अपने ऐप में प्रदर्शन मॉनिटरिंग एसडीके को सफलतापूर्वक जोड़ा है या नहीं। आमतौर पर आपका ऐप शुरू होने के 10 मिनट के भीतर, फायरबेस कंसोल का प्रदर्शन डैशबोर्ड एक "एसडीके डिटेक्टेड" संदेश प्रदर्शित करता है। फिर, 30 मिनट के भीतर, डैशबोर्ड प्रारंभिक संसाधित डेटा प्रदर्शित करता है।
यदि आपको अपने ऐप में एसडीके का नवीनतम संस्करण जोड़े हुए 10 मिनट से अधिक समय हो गया है, और आपको अभी भी कोई बदलाव नहीं दिख रहा है, तो यह सुनिश्चित करने के लिए अपने लॉग संदेशों की जांच करें कि प्रदर्शन मॉनिटरिंग इवेंट लॉग कर रहा है। विलंबित एसडीके डिटेक्शन संदेश के समस्या निवारण के लिए नीचे बताए अनुसार उचित समस्या निवारण चरणों का प्रयास करें।
सुनिश्चित करें कि आप प्रदर्शन मॉनिटरिंग Android SDK 19.1.0 या बाद का संस्करण (या Firebase BoM 26.3.0 या बाद का संस्करण) का उपयोग कर रहे हैं, रिलीज़ नोट देखें।
यदि आप अभी भी स्थानीय स्तर पर विकास कर रहे हैं, तो डेटा संग्रह के लिए अधिक ईवेंट उत्पन्न करने का प्रयास करें:
- अपने ऐप को पृष्ठभूमि और अग्रभूमि के बीच कई बार स्विच करके, स्क्रीन पर नेविगेट करके अपने ऐप के साथ इंटरैक्ट करके और/या नेटवर्क अनुरोधों को ट्रिगर करके ईवेंट उत्पन्न करें।
सुनिश्चित करें कि आपकी फायरबेस कॉन्फ़िगरेशन फ़ाइल (
google-services.json
) आपके ऐप में सही ढंग से जोड़ी गई है और आपने फ़ाइल को संशोधित नहीं किया है। विशेष रूप से, निम्नलिखित की जाँच करें:कॉन्फ़िग फ़ाइल नाम अतिरिक्त वर्णों, जैसे
(2)
के साथ नहीं जोड़ा गया है।कॉन्फ़िगरेशन फ़ाइल आपके ऐप के मॉड्यूल (ऐप-स्तर) निर्देशिका में है।
कॉन्फ़िगरेशन फ़ाइल में सूचीबद्ध फायरबेस एंड्रॉइड ऐप आईडी (
mobilesdk_app_id
) आपके ऐप के लिए सही है। अपनी प्रोजेक्ट सेटिंग्स के योर ऐप्स कार्ड में अपना फायरबेस ऐप आईडी ढूंढें।
यदि आपके ऐप में कॉन्फ़िगरेशन फ़ाइल में कुछ भी गलत लगता है, तो निम्न प्रयास करें:
आपके ऐप में वर्तमान में मौजूद कॉन्फिग फ़ाइल को हटा दें।
नई कॉन्फ़िग फ़ाइल डाउनलोड करने और उसे अपने Android ऐप में जोड़ने के लिए इन निर्देशों का पालन करें।
यदि एसडीके ईवेंट लॉग कर रहा है और सब कुछ सही ढंग से सेट किया गया प्रतीत होता है, लेकिन आप अभी भी एसडीके डिटेक्शन संदेश या संसाधित डेटा नहीं देख रहे हैं (10 मिनट के बाद), तो फायरबेस सपोर्ट से संपर्क करें ।
प्रदर्शन मॉनिटरिंग ग्रैडल प्लगइन के सेटअप की जाँच इस प्रकार करें:
सुनिश्चित करें कि आपने प्लगइन सही ढंग से जोड़ा है । विशेष रूप से, निम्नलिखित की जाँच करें:
- आपने अपने मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल में प्लगइन (
) जोड़ा है।apply plugin: 'com.google.firebase.firebase-perf' - आपने अपने प्रोजेक्ट-स्तरीय
build.gradle
फ़ाइल में प्लगइन (
) के लिए क्लासपाथ निर्भरता शामिल की है।classpath 'com.google.firebase:perf-plugin:1.4.2'
- आपने अपने मॉड्यूल (ऐप-स्तर)
सुनिश्चित करें कि प्लगइन निम्नलिखित में से किसी भी झंडे के माध्यम से अक्षम नहीं है :
- आपके मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल मेंinstrumentationEnabled
- आपकी
gradle.properties
फ़ाइल मेंfirebasePerformanceInstrumentationEnabled
- आपके मॉड्यूल (ऐप-स्तर)
जांचें कि आपकी
AndroidManifest.xml
फ़ाइल में निम्न में से किसी भी फ़्लैग के माध्यम से प्रदर्शन मॉनिटरिंग SDK अक्षम नहीं है :-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
सुनिश्चित करें कि रनटाइम पर प्रदर्शन मॉनिटरिंग अक्षम नहीं है ।
यदि आपको अपने ऐप में कुछ भी अक्षम नहीं मिलता है, तो फायरबेस सपोर्ट से संपर्क करें ।
प्रदर्शन मॉनिटरिंग प्रदर्शन इवेंट डेटा को प्रदर्शन डैशबोर्ड में प्रदर्शित करने से पहले संसाधित करता है।
यदि "एसडीके डिटेक्टेड" संदेश प्रकट हुए 24 घंटे से अधिक हो गए हैं, और आप अभी भी डेटा नहीं देख रहे हैं, तो ज्ञात आउटेज होने की स्थिति में फायरबेस स्थिति डैशबोर्ड की जांच करें। यदि कोई आउटेज नहीं है, तो फायरबेस सपोर्ट से संपर्क करें ।
सामान्य समस्या निवारण
यदि आपने सफलतापूर्वक एसडीके जोड़ लिया है और अपने ऐप में प्रदर्शन मॉनिटरिंग का उपयोग कर रहे हैं, तो निम्नलिखित समस्या निवारण युक्तियाँ सामान्य समस्याओं में मदद कर सकती हैं जिनमें प्रदर्शन मॉनिटरिंग सुविधाएँ और टूलिंग शामिल हैं।
यदि आपको प्रदर्शन ईवेंट के लिए लॉग संदेश नहीं दिख रहे हैं, तो निम्न समस्या निवारण चरण आज़माएँ:
प्रदर्शन मॉनिटरिंग ग्रैडल प्लगइन के सेटअप की जाँच इस प्रकार करें:
सुनिश्चित करें कि आपने प्लगइन सही ढंग से जोड़ा है । विशेष रूप से, निम्नलिखित की जाँच करें:
- आपने अपने मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल में प्लगइन (
) जोड़ा है।apply plugin: 'com.google.firebase.firebase-perf' - आपने अपने प्रोजेक्ट-स्तरीय
build.gradle
फ़ाइल में प्लगइन (
) के लिए क्लासपाथ निर्भरता शामिल की है।classpath 'com.google.firebase:perf-plugin:1.4.2'
- आपने अपने मॉड्यूल (ऐप-स्तर)
सुनिश्चित करें कि प्लगइन निम्नलिखित में से किसी भी झंडे के माध्यम से अक्षम नहीं है :
- आपके मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल मेंinstrumentationEnabled
- आपकी
gradle.properties
फ़ाइल मेंfirebasePerformanceInstrumentationEnabled
- आपके मॉड्यूल (ऐप-स्तर)
जांचें कि आपकी
AndroidManifest.xml
फ़ाइल में निम्न में से किसी भी फ़्लैग के माध्यम से प्रदर्शन मॉनिटरिंग SDK अक्षम नहीं है :-
firebase_performance_collection_enabled
-
firebase_performance_collection_deactivated
-
सुनिश्चित करें कि रनटाइम पर प्रदर्शन मॉनिटरिंग अक्षम नहीं है ।
यदि आपको अपने ऐप में कुछ भी अक्षम नहीं मिलता है, तो फायरबेस सपोर्ट से संपर्क करें ।
यदि आपके पास स्क्रीन रेंडरिंग ट्रेस के लिए डेटा नहीं है, तो निम्न समस्या निवारण चरणों को आज़माएँ:
सुनिश्चित करें कि आप Android SDK का नवीनतम संस्करण (v20.5.1) उपयोग कर रहे हैं। स्क्रीन रेंडरिंग ट्रेस केवल v15.2.0 या बाद के संस्करण के साथ उपलब्ध हैं।
सुनिश्चित करें कि आपने स्क्रीन के लिए हार्डवेयर एक्सेलेरेशन को मैन्युअल रूप से अक्षम नहीं किया है।
सुनिश्चित करें कि आप डेक्सगार्ड या जैक का उपयोग नहीं कर रहे हैं। प्रदर्शन निगरानी इन टूलचेन के साथ असंगत है।
डेक्सगार्ड ऐप स्टार्ट, ऐप-इन-फोरग्राउंड और ऐप-इन-बैकग्राउंड ट्रेस के स्वचालित संग्रह को अक्षम कर देता है। हालाँकि, यदि आपका ऐप DexGuard का उपयोग करता है तो कोई भी कस्टम कोड निशान सामान्य रूप से व्यवहार करना चाहिए।
जैक को हटा दिया गया है और आम तौर पर आपके ऐप में इसका उपयोग नहीं किया जाना चाहिए।
क्या आप स्वचालित रूप से एकत्र किए गए ट्रेस के लिए प्रदर्शन डेटा देख रहे हैं , लेकिन कस्टम कोड ट्रेस के लिए नहीं ? निम्नलिखित समस्या निवारण चरण आज़माएँ:
यदि आपने ट्रेस एपीआई के माध्यम से कस्टम कोड ट्रेस को इंस्ट्रुमेंट किया है, तो ट्रेस के सेटअप की जांच करें, विशेष रूप से निम्नलिखित:
- कस्टम कोड ट्रेस और कस्टम मेट्रिक्स के नामों को निम्नलिखित आवश्यकताओं को पूरा करना होगा: कोई अग्रणी या पिछला खाली स्थान नहीं, कोई अग्रणी अंडरस्कोर (
_
) वर्ण नहीं, और अधिकतम लंबाई 32 वर्ण है। - सभी निशान शुरू और बंद होने चाहिए। कोई भी ट्रेस जो शुरू नहीं हुआ है, बंद नहीं हुआ है, या शुरू होने से पहले रुक गया है उसे लॉग नहीं किया जाएगा।
- कस्टम कोड ट्रेस और कस्टम मेट्रिक्स के नामों को निम्नलिखित आवश्यकताओं को पूरा करना होगा: कोई अग्रणी या पिछला खाली स्थान नहीं, कोई अग्रणी अंडरस्कोर (
यदि आपने
@AddTrace
नोटेशन के माध्यम से कस्टम कोड ट्रेस को इंस्ट्रुमेंट किया है, तो परफॉर्मेंस मॉनिटरिंग ग्रैडल प्लगइन के सेटअप की जांच करें:सुनिश्चित करें कि आपने प्लगइन सही ढंग से जोड़ा है । विशेष रूप से, निम्नलिखित की जाँच करें:
- आपने अपने मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल में प्लगइन (
) जोड़ा है।apply plugin: 'com.google.firebase.firebase-perf' - आपने अपने प्रोजेक्ट-स्तरीय
build.gradle
फ़ाइल में प्लगइन (
) के लिए क्लासपाथ निर्भरता शामिल की है।classpath 'com.google.firebase:perf-plugin:1.4.2'
- आपने अपने मॉड्यूल (ऐप-स्तर)
सुनिश्चित करें कि प्लगइन निम्नलिखित में से किसी भी झंडे के माध्यम से अक्षम नहीं है :
- आपके मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल मेंinstrumentationEnabled
- आपकी
gradle.properties
फ़ाइल मेंfirebasePerformanceInstrumentationEnabled
- आपके मॉड्यूल (ऐप-स्तर)
यह सुनिश्चित करने के लिए अपने लॉग संदेशों की जाँच करें कि प्रदर्शन मॉनिटरिंग अपेक्षित कस्टम कोड ट्रेस लॉग कर रहा है।
यदि प्रदर्शन मॉनिटरिंग इवेंट लॉग कर रही है, लेकिन 24 घंटों के बाद कोई डेटा प्रदर्शित नहीं होता है, तो फायरबेस सपोर्ट से संपर्क करें ।
यदि आपको नेटवर्क अनुरोध डेटा नहीं मिल रहा है, तो निम्न समस्या निवारण चरणों को आज़माएँ:
एंड्रॉइड ऐप्स के लिए, परफॉर्मेंस मॉनिटरिंग ग्रैडल प्लगइन इंस्ट्रूमेंटेशन को सक्षम करता है जो HTTP/S नेटवर्क अनुरोधों की स्वचालित निगरानी प्रदान करता है। निम्नलिखित की जाँच करें:
सुनिश्चित करें कि आपने प्लगइन सही ढंग से जोड़ा है । विशेष रूप से, निम्नलिखित की जाँच करें:
- आपने अपने मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल में प्लगइन (
) जोड़ा है।apply plugin: 'com.google.firebase.firebase-perf' - आपने अपने प्रोजेक्ट-स्तरीय
build.gradle
फ़ाइल में प्लगइन (
) के लिए क्लासपाथ निर्भरता शामिल की है।classpath 'com.google.firebase:perf-plugin:1.4.2'
- आपने अपने मॉड्यूल (ऐप-स्तर)
सुनिश्चित करें कि प्लगइन निम्नलिखित में से किसी भी झंडे के माध्यम से अक्षम नहीं है :
- आपके मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल मेंinstrumentationEnabled
- आपकी
gradle.properties
फ़ाइल मेंfirebasePerformanceInstrumentationEnabled
- आपके मॉड्यूल (ऐप-स्तर)
नेटवर्क लाइब्रेरी असंगति की जाँच करें। प्रदर्शन मॉनिटरिंग स्वचालित रूप से नेटवर्क अनुरोधों के लिए मेट्रिक्स एकत्र करती है जो निम्नलिखित नेटवर्किंग लाइब्रेरीज़ का उपयोग करते हैं: OkHttp 3.xx, Java का URLConnection, और Apache HttpClient।
ध्यान दें कि आप नेटवर्क अनुरोधों के लिए कस्टम मॉनिटरिंग जोड़ सकते हैं।
निम्नलिखित से अवगत रहें:
आपके कोड के व्यवहार और आपके कोड द्वारा उपयोग की जाने वाली नेटवर्किंग लाइब्रेरी के आधार पर, प्रदर्शन मॉनिटरिंग केवल पूर्ण किए गए नेटवर्क अनुरोधों पर रिपोर्ट कर सकती है। इसका मतलब यह है कि खुले छोड़े गए HTTP/S कनेक्शन की रिपोर्ट नहीं की जा सकती है।
प्रदर्शन निगरानी डेक्सगार्ड और जैक के साथ संगत नहीं है।
- DexGuard HTTP/S नेटवर्क अनुरोधों की निगरानी अक्षम कर देता है।
- जैक को हटा दिया गया है और आम तौर पर आपके ऐप में इसका उपयोग नहीं किया जाना चाहिए।
प्रदर्शन निगरानी अमान्य
Content-Type
हेडर वाले नेटवर्क अनुरोधों पर रिपोर्ट नहीं करती है। हालाँकि,Content-Type
हेडर के बिना नेटवर्क अनुरोध अभी भी स्वीकार किए जाएंगे।
इस बारे में और जानें कि प्रदर्शन मॉनिटरिंग यूआरएल पैटर्न के तहत नेटवर्क अनुरोध डेटा को कैसे एकत्रित करती है ।
आप कस्टम यूआरएल पैटर्न भी आज़मा सकते हैं!
सामान्य प्रश्न
हमने हाल ही में अलर्ट की शुरुआत के बाद शीर्ष मुद्दों को हाल के अलर्ट से बदल दिया है, जो आपके द्वारा निर्धारित सीमा पार होने पर स्वचालित रूप से आपको सूचित करता है। मुद्दे अब अप्रचलित हो गए हैं और उनकी जगह अलर्ट ने ले ली है।
प्रदर्शन कार्ड के शीर्ष पर स्थित ऐप्स चयनकर्ता हाल के अलर्ट के अंतर्गत अलर्ट प्रविष्टियों को फ़िल्टर करता है। चयनित ऐप(ऐप्स) के लिए केवल तीन सबसे हालिया अलर्ट प्रदर्शित होते हैं।
अलर्ट के बारे में अधिक जानने के लिए, प्रदर्शन समस्याओं के लिए अलर्ट सेट करें देखें।
प्रदर्शन निगरानी उन मेट्रिक्स के लिए अलर्ट का समर्थन करती है जो परिभाषित सीमा से अधिक हैं। प्रदर्शन मेट्रिक्स के लिए इन कॉन्फ़िगर करने योग्य थ्रेशोल्ड के साथ भ्रम से बचने के लिए, हमने मुद्दों के लिए थ्रेशोल्ड को कॉन्फ़िगर करने की क्षमता हटा दी है।
समस्याओं के निवारण के तरीके को बेहतर बनाने के लिए हमने विवरण और मेट्रिक्स पृष्ठों को एक नए पुन: डिज़ाइन किए गए, केंद्रीकृत उपयोगकर्ता इंटरफ़ेस (यूआई) से बदल दिया है। यह नया समस्या निवारण यूआई वही मूल कार्यक्षमता प्रदान करता है जो विवरण और मेट्रिक्स प्रदान करते हैं। समस्या निवारण के बारे में अधिक जानने के लिए, किसी विशिष्ट ट्रेस के लिए अधिक डेटा देखें देखें ।
प्रदर्शन मॉनिटरिंग आपके ऐप के उपयोगकर्ता उपकरणों से प्रदर्शन डेटा एकत्र करता है। यदि आपके एप्लिकेशन में कई उपयोगकर्ता हैं या यदि ऐप बड़ी मात्रा में प्रदर्शन गतिविधि उत्पन्न करता है, तो प्रदर्शन मॉनिटरिंग संसाधित घटनाओं की संख्या को कम करने के लिए डेटा संग्रह को उपकरणों के एक सबसेट तक सीमित कर सकती है। ये सीमाएँ इतनी अधिक हैं कि, कम घटनाओं के साथ भी, मीट्रिक मान अभी भी आपके उपयोगकर्ता के ऐप अनुभव के प्रतिनिधि हैं।
हमारे द्वारा एकत्र किए गए डेटा की मात्रा को प्रबंधित करने के लिए, प्रदर्शन निगरानी निम्नलिखित नमूना विकल्पों का उपयोग करती है:
ऑन-डिवाइस दर सीमित करना : किसी डिवाइस को अचानक बहुत सारे ट्रेस भेजने से रोकने के लिए, हम डिवाइस से भेजे गए कोड और नेटवर्क अनुरोध ट्रेस की संख्या को हर 10 मिनट में 300 इवेंट तक सीमित करते हैं। यह दृष्टिकोण डिवाइस को लूप किए गए इंस्ट्रूमेंटेशन से बचाता है जो बड़ी मात्रा में प्रदर्शन डेटा भेज सकता है, और यह एकल डिवाइस को प्रदर्शन माप को ख़राब करने से रोकता है।
गतिशील नमूनाकरण : प्रदर्शन मॉनिटरिंग सभी ऐप उपयोगकर्ताओं के लिए प्रतिदिन प्रति ऐप कोड ट्रेस के लिए लगभग 100M ईवेंट और नेटवर्क अनुरोध ट्रेस के लिए 100M की सीमा एकत्र करता है। यह निर्धारित करने के लिए कि किसी यादृच्छिक डिवाइस को निशान कैप्चर करना चाहिए और भेजना चाहिए या नहीं, डिवाइस पर एक गतिशील नमूना दर प्राप्त की जाती है (फ़ायरबेस रिमोट कॉन्फ़िगरेशन का उपयोग करके)। एक उपकरण जिसे नमूने के लिए नहीं चुना गया है वह कोई ईवेंट नहीं भेजता है। गतिशील नमूनाकरण दर ऐप-विशिष्ट है और यह सुनिश्चित करने के लिए समायोजित की जाती है कि एकत्रित डेटा की कुल मात्रा सीमा से नीचे रहे।
उपयोगकर्ता सत्र उपयोगकर्ता के डिवाइस से अतिरिक्त, विस्तृत डेटा भेजते हैं, डेटा को कैप्चर करने और भेजने के लिए अधिक संसाधनों की आवश्यकता होती है। उपयोगकर्ता सत्रों के प्रभाव को कम करने के लिए, प्रदर्शन निगरानी सत्रों की संख्या को भी सीमित कर सकती है।
सर्वर-साइड दर सीमित करना : यह सुनिश्चित करने के लिए कि ऐप्स नमूना सीमा से अधिक न हों, प्रदर्शन निगरानी उपकरणों से प्राप्त कुछ घटनाओं को हटाने के लिए सर्वर-साइड नमूनाकरण का उपयोग कर सकती है। हालाँकि इस प्रकार की सीमा हमारे मेट्रिक्स की प्रभावशीलता को नहीं बदलती है, लेकिन इससे पैटर्न में मामूली बदलाव हो सकते हैं, जिनमें निम्नलिखित शामिल हैं:
- ट्रेस की संख्या कोड के एक टुकड़े को निष्पादित करने की संख्या से भिन्न हो सकती है।
- जो निशान कोड में बारीकी से जुड़े हुए हैं उनमें से प्रत्येक में नमूनों की अलग-अलग संख्या हो सकती है।
हमने मुद्दे टैब को अलर्ट की शुरूआत के साथ बदल दिया है, जो आपके द्वारा निर्धारित सीमा पार होने पर स्वचालित रूप से आपको सूचित करता है। थ्रेशोल्ड की स्थिति निर्धारित करने के लिए अब आपको फायरबेस कंसोल को मैन्युअल रूप से जांचने की आवश्यकता नहीं है। अलर्ट के बारे में जानने के लिए, प्रदर्शन समस्याओं के लिए अलर्ट सेट करें देखें।
हमने फायरबेस कंसोल के प्रदर्शन मॉनिटरिंग अनुभाग को फिर से डिज़ाइन किया है ताकि डैशबोर्ड टैब आपके प्रमुख मेट्रिक्स और आपके सभी निशान एक ही स्थान पर प्रदर्शित कर सके। रीडिज़ाइन के भाग के रूप में, हमने ऑन डिवाइस और नेटवर्क पेज हटा दिए।
डैशबोर्ड टैब के निचले भाग में ट्रेस तालिका में वही सारी जानकारी होती है जो ऑन डिवाइस और नेटवर्क टैब पर प्रदर्शित होती है, लेकिन कुछ अतिरिक्त सुविधाओं के साथ, जिसमें एक विशिष्ट मीट्रिक के लिए प्रतिशत परिवर्तन के आधार पर आपके ट्रेस को क्रमबद्ध करने की क्षमता भी शामिल है। किसी विशिष्ट ट्रेस के लिए सभी मीट्रिक और डेटा देखने के लिए, ट्रेस तालिका में ट्रेस नाम पर क्लिक करें।
निशान तालिका के निम्नलिखित उपटैब में अपने निशान देखें:
- नेटवर्क अनुरोध ट्रेस (आउट-ऑफ-द-बॉक्स और कस्टम दोनों) - नेटवर्क अनुरोध उपटैब
- कस्टम कोड ट्रेस - कस्टम ट्रेस उपटैब
- ऐप प्रारंभ, ऐप-इन-फ़ोरग्राउंड, ऐप-इन-बैकग्राउंड ट्रेस - कस्टम ट्रेस उपटैब
- स्क्रीन रेंडरिंग ट्रेस - स्क्रीन रेंडरिंग उपटैब
- पेज लोड ट्रेस - पेज लोड उपटैब
ट्रेस तालिका और मेट्रिक्स और डेटा देखने के बारे में विवरण के लिए, कंसोल अवलोकन पृष्ठ ( आईओएस+ | एंड्रॉइड | वेब ) पर जाएं।
धीमे रेंडरिंग फ़्रेम और जमे हुए फ़्रेम की गणना 60Hz की अनुमानित डिवाइस ताज़ा दर के साथ की जाती है। यदि किसी डिवाइस की ताज़ा दर 60Hz से कम है, तो प्रत्येक फ़्रेम का रेंडरिंग समय धीमा होगा क्योंकि प्रति सेकंड कम फ़्रेम रेंडर किए जाते हैं। धीमे रेंडरिंग समय के कारण अधिक धीमे या जमे हुए फ़्रेम की रिपोर्ट की जा सकती है क्योंकि अधिक फ़्रेम धीमे रेंडर किए जाएंगे या फ़्रीज़ हो जाएंगे। हालाँकि, यदि किसी डिवाइस की ताज़ा दर 60Hz से अधिक है, तो प्रत्येक फ़्रेम का रेंडरिंग समय तेज़ होगा। इससे कम धीमे या जमे हुए फ़्रेम रिपोर्ट किए जा सकते हैं। यह प्रदर्शन निगरानी एसडीके में एक वर्तमान सीमा है।
ऐप गतिविधि के अलावा अंशों का प्रदर्शन देखने के लिए, सुनिश्चित करें कि आपका ऐप परफॉर्मेंस मॉनिटरिंग एंड्रॉइड एसडीके संस्करण 20.1.0 या उससे ऊपर का उपयोग कर रहा है। अधिक जानने के लिए, अपने ऐप में प्रदर्शन मॉनिटरिंग जोड़ें देखें।
प्रत्येक टुकड़ा और गतिविधि का निशान आपके एप्लिकेशन में परिभाषित उसके वर्ग नाम पर आधारित है। प्रत्येक स्क्रीन ट्रेस में क्लास के नाम के बाद st उपसर्ग होता है। फ़ायरबेस कंसोल पर, उपसर्ग हटा दिया जाता है। अधिक जानने के लिए, स्क्रीन रेंडरिंग प्रदर्शन डेटा (Apple और Android ऐप्स) के बारे में जानें देखें।
प्रदर्शन निगरानी एक डिवाइस पर एकत्र किए गए सभी ईवेंट में ईवेंट नमूनाकरण आयोजित करती है। यह दृष्टिकोण हमें प्रदर्शन मेट्रिक्स प्रदान करने के लिए उपयोगकर्ता उपकरणों से आवश्यक न्यूनतम ईवेंट एकत्र करने देता है।
प्रदर्शन मॉनिटरिंग आपको उन मेट्रिक्स के लिए अलर्ट सेट करने की सुविधा देती है जिनकी आप परवाह करते हैं। उत्पन्न स्क्रीन रेंडरिंग ट्रेस के लिए, जब धीमे और जमे हुए फ्रेम का प्रतिशत आपके द्वारा निर्धारित सीमा से अधिक हो जाता है, तो आपको सूचित करने के लिए अलर्ट सेट कर सकते हैं।
एंड्रॉइड के लिए प्रदर्शन मॉनिटरिंग HTTP/S नेटवर्क अनुरोधों की निगरानी जैसी कुछ आउट-ऑफ-द-बॉक्स सुविधाएं प्रदान करने के लिए बाइटकोड इंस्ट्रूमेंटेशन का उपयोग करता है। संकलन के एक भाग के रूप में, प्रक्रिया को आपके ऐप के सभी वर्गों (निर्भरताओं सहित) के माध्यम से उस कोड को साधने की आवश्यकता होती है जो आपके एप्लिकेशन के नेटवर्क अनुरोध प्रदर्शन को मापने में महत्वपूर्ण है।
निर्माण समय में वृद्धि के लिए यहां कुछ प्रमुख योगदानकर्ता दिए गए हैं:
- कक्षाओं या फ़ाइलों की संख्या
- उनमें से प्रत्येक वर्ग का आकार (कोड की पंक्तियाँ)
- आपकी मशीन कॉन्फ़िगरेशन
- प्रारंभिक निर्माण बनाम बाद का निर्माण (बाद के निर्माण आमतौर पर प्रारंभिक निर्माण की तुलना में तेज़ होते हैं)
अपने निर्माण समय को अनुकूलित करने के लिए, अपने कोड को मॉड्यूलराइज़ करने पर विचार करें।
प्रदर्शन मॉनिटरिंग प्लगइन के v1.3.3 से शुरू करके, हमने लाइब्रेरी इनपुट की वृद्धिशील बिल्ड प्रोसेसिंग और कैशिंग में काफी सुधार करने पर ध्यान केंद्रित किया है। नवीनतम बिल्ड समय सुधार प्राप्त करने के लिए, प्लगइन के नवीनतम संस्करण (v1.4.2) का उपयोग करना सुनिश्चित करें ।
ध्यान दें कि यदि आप लंबे निर्माण समय से बचना चाहते हैं तो आप अपने डिबग बिल्ड के लिए प्रदर्शन मॉनिटरिंग प्लगइन को स्थानीय रूप से अक्षम कर सकते हैं। हालाँकि, उत्पादन बिल्ड के लिए इस दृष्टिकोण की अनुशंसा नहीं की जाती है, क्योंकि इसके परिणामस्वरूप आपके ऐप में नेटवर्क अनुरोधों के लिए प्रदर्शन माप छूट सकता है।
एंड्रॉइड के लिए प्रदर्शन मॉनिटरिंग HTTP/S नेटवर्क अनुरोधों की निगरानी जैसी कुछ आउट-ऑफ-द-बॉक्स सुविधाएं प्रदान करने के लिए बाइटकोड इंस्ट्रूमेंटेशन का उपयोग करता है। संकलन के एक भाग के रूप में, प्रक्रिया को आपके ऐप के सभी वर्गों (निर्भरताओं सहित) के माध्यम से उस कोड को साधने की आवश्यकता होती है जो आपके एप्लिकेशन के नेटवर्क अनुरोध प्रदर्शन को मापने में महत्वपूर्ण है।
यदि आपको परफॉर्मेंस मॉनिटरिंग प्लगइन के साथ एकीकृत करने के बाद JSR/RET are not supported with computeFrames option
या इसी तरह की त्रुटियां मिलती हैं, तो ऐसा इसलिए हो सकता है क्योंकि आपके पास लाइब्रेरी पर निर्भरता भी है जो परफॉर्मेंस मॉनिटरिंग ग्रैडल प्लगइन के साथ असंगत है।
इससे निजात पाने के लिए, आप इन चरणों का पालन करके असंगत कक्षाओं/पुस्तकालयों को उपकरण बनाने से बाहर कर सकते हैं:
- परफॉर्मेंस मॉनिटरिंग ग्रैडल प्लगइन (न्यूनतम v1.4.0 ) के नवीनतम संस्करण में अपडेट करें।
- अपने एंड्रॉइड ग्रैडल प्लगइन संस्करण को v7.2.0 या नए पर अपडेट करें।
- असंगत कक्षाओं/पुस्तकालयों को इंस्ट्रुमेंटेड होने से बाहर करने के लिए अपने मॉड्यूल (ऐप-स्तर)
build.gradle
फ़ाइल में निम्नलिखित ध्वज जोड़ें:android { // ... androidComponents { onVariants(selector().all(), { instrumentation.excludes.add("example.incompatible.library") }) } }
एंड्रॉइड ग्रैडल प्लगइन केInstrumentation
एपीआई कीexclude
संपत्ति के बारे में अधिक जानने के लिए, इंस्ट्रुमेंटेशन देखें।
जब आप असंगत पुस्तकालयों के कारण बिल्ड त्रुटियों का सामना करते हैं तो कृपया जीथब समस्या दर्ज करें ताकि उन्हें प्रदर्शन मॉनिटरिंग प्लगइन में शामिल होने से भी बाहर रखा जा सके।
यदि आपने फायरबेस प्रदर्शन मॉनिटरिंग के लिए BigQuery एकीकरण सक्षम किया है, तो आपका डेटा दिन के अंत (प्रशांत समय) के 12 से 24 घंटे बाद BigQuery पर निर्यात किया जाएगा।
उदाहरण के लिए, 19 अप्रैल का डेटा BigQuery में 20 अप्रैल को दोपहर 12:00 बजे से आधी रात के बीच उपलब्ध होगा (सभी तिथियां और समय प्रशांत समय के अनुसार हैं)।
वास्तविक समय डेटा प्रसंस्करण और प्रदर्शन के पास
फायरबेस प्रदर्शन निगरानी प्रक्रियाओं ने प्रदर्शन डेटा को एकत्र किया क्योंकि यह आता है, जिसके परिणामस्वरूप फायरबेस कंसोल में वास्तविक समय डेटा डिस्प्ले के पास होता है। संसाधित डेटा कंसोल में अपने संग्रह के कुछ मिनटों के भीतर प्रदर्शित करता है, इसलिए "वास्तविक समय के पास" शब्द।
रियल-टाइम डेटा प्रोसेसिंग के पास लाभ उठाने के लिए, सुनिश्चित करें कि आपका ऐप एक वास्तविक समय के संगत एसडीके संस्करण का उपयोग करता है।
रियल-टाइम डेटा प्रोसेसिंग के पास लाभ उठाने के लिए, आपको केवल यह सुनिश्चित करने की आवश्यकता है कि आपका ऐप एक प्रदर्शन की निगरानी SDK संस्करण का उपयोग करता है जो वास्तविक समय डेटा प्रोसेसिंग के साथ संगत है।
ये वास्तविक समय के संगत एसडीके संस्करण हैं:
- iOS - V7.3.0 या बाद में
- TVOS - V8.9.0 या बाद में
- Android - V19.0.10 या बाद में (या फायरबेस Android BOM V26.1.0 या बाद में)
- वेब - V7.14.0 या बाद में
ध्यान दें कि हम हमेशा एसडीके के नवीनतम संस्करण का उपयोग करने की सलाह देते हैं, लेकिन ऊपर सूचीबद्ध कोई भी संस्करण प्रदर्शन की निगरानी को वास्तविक समय में आपके डेटा को संसाधित करने में सक्षम करेगा।
ये SDK संस्करण हैं जो वास्तविक समय के डेटा प्रसंस्करण के साथ संगत हैं:
- iOS - V7.3.0 या बाद में
- TVOS - V8.9.0 या बाद में
- Android - V19.0.10 या बाद में (या फायरबेस Android BOM V26.1.0 या बाद में)
- वेब - V7.14.0 या बाद में
ध्यान दें कि हम हमेशा एसडीके के नवीनतम संस्करण का उपयोग करने की सलाह देते हैं, लेकिन ऊपर सूचीबद्ध कोई भी संस्करण प्रदर्शन की निगरानी को वास्तविक समय में आपके डेटा को संसाधित करने में सक्षम करेगा।
यदि आपका ऐप वास्तविक समय के संगत एसडीके संस्करण का उपयोग नहीं करता है, तो आप अभी भी फायरबेस कंसोल में अपने सभी ऐप के प्रदर्शन डेटा को देखेंगे। हालांकि, प्रदर्शन डेटा के प्रदर्शन में इसके संग्रह के समय से लगभग 36 घंटे की देरी होगी।
हाँ! भले ही एसडीके संस्करण एक ऐप उदाहरण का उपयोग करता है, आपको अपने सभी उपयोगकर्ताओं से प्रदर्शन डेटा दिखाई देगा।
हालाँकि, यदि आप हाल के डेटा (लगभग 36 घंटे से कम पुराना) देख रहे हैं, तो प्रदर्शित डेटा एक वास्तविक समय के संगत एसडीके संस्करण का उपयोग करके ऐप इंस्टेंसेस के उपयोगकर्ताओं से है। गैर-हालिया डेटा, हालांकि, आपके ऐप के सभी संस्करणों से प्रदर्शन डेटा शामिल है।
फायरबेस समर्थन से संपर्क करना
यदि आप फायरबेस सपोर्ट तक पहुंचते हैं , तो हमेशा अपने फायरबेस ऐप आईडी को शामिल करें। अपनी प्रोजेक्ट सेटिंग्स के अपने ऐप कार्ड में अपना फायरबेस ऐप आईडी खोजें।