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