इस क्विकस्टार्ट में, Firebase Performance Monitoring को सेट अप करने का तरीका बताया गया है. इससे आपको अपने Flutter ऐप्लिकेशन की परफ़ॉर्मेंस की खास जानकारी पाने में मदद मिलेगी.
शुरू करने से पहले
अगर आपने पहले से ही ऐसा नहीं किया है, तो अपने Flutter प्रोजेक्ट में Firebase को कॉन्फ़िगर और शुरू करें.
पहला चरण: अपने ऐप्लिकेशन में Performance Monitoring जोड़ना
Performance Monitoring का Flutter प्लग-इन इंस्टॉल करने के लिए, अपने Flutter प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:
flutter pub add firebase_performanceअपने Flutter प्रोजेक्ट की रूट डायरेक्ट्री से यह कमांड चलाएं:
flutterfire configureइस कमांड को चलाने से यह पक्का होता है कि आपके Flutter ऐप्लिकेशन का Firebase कॉन्फ़िगरेशन अप-टू-डेट है. साथ ही, Android के लिए, आपके ऐप्लिकेशन में Performance Monitoring का ज़रूरी Gradle प्लग-इन जुड़ जाता है.
यह प्रोसेस पूरी होने के बाद, अपने Flutter प्रोजेक्ट को फिर से बनाएं:
flutter run
Performance Monitoring SDK टूल जोड़ने के बाद, Firebase आपके ऐप्लिकेशन के लाइफ़साइकल (जैसे, ऐप्लिकेशन के शुरू होने का समय) और एचटीटीपी/एस नेटवर्क अनुरोधोंसे जुड़ा डेटा अपने-आप इकट्ठा करने लगता है.
Flutter पर, Flutter की अलग-अलग स्क्रीन के लिए, स्क्रीन रेंडरिंग की परफ़ॉर्मेंस को मॉनिटर करने की सुविधा उपलब्ध नहीं है. एक ही व्यू कंट्रोलर, आपके पूरे Flutter ऐप्लिकेशन को नेटिव तरीके से एनकैप्सुलेट करता है. इसलिए, Firebase SDK टूल को स्क्रीन ट्रांज़िशन के बारे में पता नहीं चलता.
दूसरा चरण: शुरुआती डेटा दिखाने के लिए, परफ़ॉर्मेंस इवेंट जनरेट करना
अपने ऐप्लिकेशन में SDK टूल जोड़ने के बाद, Firebase इवेंट प्रोसेस करना शुरू कर देता है. अगर अब भी स्थानीय तौर पर डेवलपमेंट किया जा रहा है, तो शुरुआती डेटा कलेक्शन और प्रोसेसिंग के लिए इवेंट जनरेट करने के लिए, अपने ऐप्लिकेशन के साथ इंटरैक्ट करें.
सिम्युलेटर या टेस्ट डिवाइस का इस्तेमाल करके, अपने ऐप्लिकेशन को डेवलप करना जारी रखें.
अपने ऐप्लिकेशन को कई बार बैकग्राउंड और फ़ोरग्राउंड के बीच स्विच करके, स्क्रीन पर नेविगेट करके अपने ऐप्लिकेशन के साथ इंटरैक्ट करके, और/या नेटवर्क अनुरोध ट्रिगर करके इवेंट जनरेट करें.
Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड पर जाएं. आपको कुछ ही मिनटों में शुरुआती डेटा दिखना चाहिए.
अगर आपको शुरुआती डेटा नहीं दिखता है, तो समस्या हल करने के सुझाव देखें.
तीसरा चरण: (ज़रूरी नहीं) परफ़ॉर्मेंस इवेंट के लिए लॉग मैसेज देखना
किसी भी गड़बड़ी के मैसेज के लिए, अपने लॉग मैसेज देखें.
Performance Monitoring, अपने लॉग मैसेज को इन टैग से टैग करता है, ताकि लॉग मैसेज को फ़िल्टर किया जा सके:
- iOS+:
Firebase/Performance - Android:
FirebasePerformance
- iOS+:
इन लॉग टाइप की जांच करें. इनसे पता चलता है कि Performance Monitoring, परफ़ॉर्मेंस इवेंट लॉग कर रहा है:
Logging trace metric: TRACE_NAME, FIREBASE_PERFORMANCE_CONSOLE_URLLogging network request trace: URL
Firebase कंसोल में अपना डेटा देखने के लिए, यूआरएल पर क्लिक करें. डैशबोर्ड में डेटा अपडेट होने में कुछ समय लग सकता है.
चौथा चरण: (ज़रूरी नहीं) खास कोड के लिए, कस्टम मॉनिटरिंग जोड़ना
अपने ऐप्लिकेशन में मौजूद खास कोड से जुड़े परफ़ॉर्मेंस डेटा को मॉनिटर करने के लिए, कस्टम कोड ट्रेस को इंस्ट्रूमेंट किया जा सकता है.
कस्टम कोड ट्रेस की मदद से, यह मेज़र किया जा सकता है कि आपके ऐप्लिकेशन को कोई खास टास्क या टास्क का सेट पूरा करने में कितना समय लगता है. जैसे, इमेज का सेट लोड करना या अपने डेटाबेस को क्वेरी करना. कस्टम कोड ट्रेस के लिए डिफ़ॉल्ट मेट्रिक, उसकी अवधि होती है. हालांकि, कस्टम मेट्रिक भी जोड़ी जा सकती हैं. जैसे, कैश हिट और मेमोरी से जुड़ी चेतावनियां.
अपने कोड में, Performance Monitoring SDK टूल से मिले एपीआई का इस्तेमाल करके, कस्टम कोड ट्रेस की शुरुआत और खत्म होने की स्थिति तय की जा सकती है. साथ ही, अपनी पसंद के मुताबिक कस्टम मेट्रिक जोड़ी जा सकती हैं.
इन सुविधाओं के बारे में ज़्यादा जानने और इन्हें अपने ऐप्लिकेशन में जोड़ने का तरीका जानने के लिए, खास कोड के लिए मॉनिटरिंग जोड़ना लेख पढ़ें.
पांचवा चरण: अपना ऐप्लिकेशन डिप्लॉय करना और फिर नतीजे देखना
इम्युलेटर और एक या उससे ज़्यादा टेस्ट डिवाइस का इस्तेमाल करके, Performance Monitoring की पुष्टि करने के बाद, अपने ऐप्लिकेशन का अपडेट किया गया वर्शन, उपयोगकर्ताओं के लिए डिप्लॉय किया जा सकता है.
Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड में, परफ़ॉर्मेंस डेटा को मॉनिटर किया जा सकता है.
अगले चरण
Performance Monitoring से अपने-आप इकट्ठा होने वाले डेटा के बारे में ज़्यादा जानें:
- आपके ऐप्लिकेशन के लाइफ़साइकल से जुड़ा डेटा, जैसे ऐप्लिकेशन के शुरू होने का समय
- आपके ऐप्लिकेशन से जारी किए गए एचटीटीपी/एस नेटवर्क अनुरोधों का डेटा
Firebase कंसोल में, अपने परफ़ॉर्मेंस डेटा को देखें, ट्रैक करें, और फ़िल्टर करें.
कस्टम कोड ट्रेस को इंस्ट्रूमेंट करके, अपने ऐप्लिकेशन में खास टास्क या वर्कफ़्लो के लिए मॉनिटरिंग जोड़ें.
परफ़ॉर्मेंस डेटा को फ़िल्टर करने के लिए, एट्रिब्यूट का इस्तेमाल करें.