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