अगर कोड में बदलाव या नेटवर्क के अनुरोधों की वजह से आपके ऐप्लिकेशन की परफ़ॉर्मेंस खराब हो रही है, तो प्रोजेक्ट के सदस्यों को सूचना देने के लिए, Performance Monitoring चेतावनियों का इस्तेमाल करें.
अपने ऐप्लिकेशन के लिए, कस्टम अलर्ट सेट अप और कस्टमाइज़ किए जा सकते हैं. ये अलर्ट आपको तब मिलते हैं, जब किसी इवेंट की परफ़ॉर्मेंस, सेट किए गए थ्रेशोल्ड को पार कर जाती है.
चेतावनी कब ट्रिगर होती है?
जब आपके ऐप्लिकेशन की कोई मेट्रिक, Firebase कंसोल में तय किए गए पर्सेंटाइल (अगर लागू हो) के लिए तय की गई सीमा को पार कर जाती है, तो सूचना ट्रिगर होती है. सूचनाएं सिर्फ़ तब ट्रिगर होती हैं, जब आपका ऐप्लिकेशन रीयल-टाइम में काम करने वाले एसडीके वर्शन का इस्तेमाल करता है.
ऐप्लिकेशन शुरू होने का समय
ऐप्लिकेशन के शुरू होने के समय के लिए सूचना कॉन्फ़िगर करने पर, सूचना तब ट्रिगर होती है, जब ये सभी शर्तें पूरी होती हैं:
- Firebase ने पिछले एक घंटे में, आपके ऐप्लिकेशन के नए वर्शन के लिए,
_app_startट्रेस के कम से कम100 सैंपल रिकॉर्ड किए हैं. - पिछले एक घंटे में और कॉन्फ़िगर किए गए पर्सेंटाइल के लिए,
_app_startट्रेस की अवधि, ऐप्लिकेशन के लिए तय की गई थ्रेशोल्ड से ज़्यादा हो गई है. - आपके ऐप्लिकेशन के नए वर्शन में, इस थ्रेशोल्ड के लिए पहले कोई सूचना नहीं दी गई थी.
कस्टम कोड ट्रेस
कस्टम कोड ट्रेस मेट्रिक के लिए सूचना कॉन्फ़िगर करने पर, सूचना तब ट्रिगर होती है, जब ये सभी शर्तें पूरी होती हैं:
- Firebase ने पिछले एक घंटे में, आपके ऐप्लिकेशन के नए वर्शन के लिए, कस्टम कोड ट्रेस के कम से कम
100 सैंपल रिकॉर्ड किए हों. - पिछले घंटे के दौरान और कॉन्फ़िगर किए गए पर्सेंटाइल के लिए, ट्रेस की अवधि ऐप्लिकेशन की तय की गई थ्रेशोल्ड से ज़्यादा थी.
- (सिर्फ़ iOS+ और Android के लिए) आपके ऐप्लिकेशन के नए वर्शन में, इस थ्रेशोल्ड के लिए पहले कोई सूचना नहीं दी गई थी.
- (सिर्फ़ वेब के लिए) पिछले
तीन दिनों में, इसी थ्रेशोल्ड के लिए पहले कोई सूचना नहीं दी गई थी.
नेटवर्क के अनुरोध
जब नेटवर्क अनुरोध की मेट्रिक के लिए कोई सूचना कॉन्फ़िगर की जाती है, तो सूचना तब ट्रिगर होती है, जब ये सभी शर्तें पूरी होती हैं:
- Firebase ने पिछले एक घंटे में, आपके ऐप्लिकेशन के सभी वर्शन में यूआरएल पैटर्न से मैच करने वाले कम से कम
100 सैंपल रिकॉर्ड किए हों. - पिछले घंटे के दौरान, मेट्रिक की एग्रीगेट की गई वैल्यू, तय की गई थ्रेशोल्ड वैल्यू को पार कर गई:
- response time: एग्रीगेट की गई वैल्यू, कॉन्फ़िगर किए गए पर्सेंटाइल के लिए सेट की गई थ्रेशोल्ड से ज़्यादा हो गई है
- सक्सेस रेट: (सिर्फ़ iOS+/Android के लिए) सभी उपयोगकर्ताओं के लिए, कुल वैल्यू तय की गई थ्रेशोल्ड से कम हो गई है
- पिछले
तीन दिनों में, इस थ्रेशोल्ड के लिए कोई सूचना नहीं दी गई हो.
स्क्रीन रेंडरिंग
स्क्रीन रेंडरिंग मेट्रिक के लिए सूचना कॉन्फ़िगर करने पर, सूचना तब ट्रिगर होती है, जब ये सभी शर्तें पूरी होती हैं:
- Firebase ने पिछले एक घंटे में, आपके ऐप्लिकेशन के नए वर्शन के लिए, स्क्रीन रेंडरिंग के कम से कम
100 सैंपल रिकॉर्ड किए हों. - पिछले घंटे के दौरान, मेट्रिक की एग्रीगेट की गई वैल्यू, तय की गई थ्रेशोल्ड वैल्यू को पार कर गई:
- रुके हुए फ़्रेम: एग्रीगेट की गई वैल्यू, सेट किए गए थ्रेशोल्ड से ज़्यादा हो गई है
- रेंडर होने में ज़्यादा समय लेने वाले फ़्रेम: एग्रीगेट की गई वैल्यू, सेट किए गए थ्रेशोल्ड से ज़्यादा हो गई है
- आपके ऐप्लिकेशन के नए वर्शन में, इस थ्रेशोल्ड के लिए पहले कोई सूचना नहीं दी गई थी.
पेज लोड
पेज लोड होने की मेट्रिक के लिए सूचना कॉन्फ़िगर करने पर, सूचना तब ट्रिगर होती है, जब ये सभी शर्तें पूरी होती हैं:
- Firebase ने पिछले घंटे में, आपके ऐप्लिकेशन के लिए पेज लोड होने के कम से कम
100 सैंपल रिकॉर्ड किए हों. - पिछले घंटे के दौरान, मेट्रिक की एग्रीगेट की गई वैल्यू, तय किए गए थ्रेशोल्ड को पार कर गई. साथ ही, कॉन्फ़िगर किए गए पर्सेंटाइल के लिए भी ऐसा हुआ:
- क्लिक के बाद रिस्पॉन्स में लगा समय: एग्रीगेट की गई वैल्यू, सेट की गई थ्रेशोल्ड और कॉन्फ़िगर किए गए पर्सेंटाइल से ज़्यादा है
- साइट का पहला एलिमेंट लोड होने में लगने वाला समय: एग्रीगेट की गई वैल्यू, सेट की गई थ्रेशोल्ड और कॉन्फ़िगर किए गए पर्सेंटाइल से ज़्यादा है
- first paint: एग्रीगेट की गई वैल्यू, तय की गई थ्रेशोल्ड और कॉन्फ़िगर किए गए पर्सेंटाइल से ज़्यादा है
- पिछले
तीन दिनों में, इस थ्रेशोल्ड के लिए कोई सूचना नहीं दी गई हो.
सूचनाएं कॉन्फ़िगर करने, डिफ़ॉल्ट पर्सेंटाइल, और खास तरह के ट्रेस और मेट्रिक के लिए सूचनाएं सेट अप करने के सबसे सही तरीकों के बारे में ज़्यादा जानें.
Performance Monitoring सूचनाओं के लिए, अन्य परफ़ॉर्मेंस मेट्रिक या Firebase कंसोल से कॉन्फ़िगर किए गए Slack, Jira या PagerDuty के इंटिग्रेशन की सूचनाएं उपलब्ध नहीं हैं.
सूचनाएं पाना
डिफ़ॉल्ट सूचनाएं पाना
डिफ़ॉल्ट रूप से, Firebase ईमेल के ज़रिए Performance Monitoring सूचनाएं भेज सकता है.
इस डिफ़ॉल्ट तरीके से Performance Monitoring की सूचनाएं पाने के लिए, आपके पास firebaseperformance.config.update की अनुमति होनी चाहिए. इन भूमिकाओं में, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है:
सूचनाएं और उनकी सेटिंग, पूरे प्रोजेक्ट पर लागू होती हैं. इसका मतलब है कि डिफ़ॉल्ट रूप से, परफ़ॉर्मेंस अलर्ट ट्रिगर होने पर, प्रोजेक्ट के हर सदस्य को एक ईमेल मिलेगा. सूचनाएं सिर्फ़ उन प्रोजेक्ट सदस्यों को भेजी जाती हैं जिनके पास सूचनाएं पाने की ज़रूरी अनुमतियां होती हैं. साथ ही, ये सूचनाएं व्यक्तिगत ईमेल पतों पर भेजी जाती हैं, न कि खातों के ग्रुप पर. जैसे, Google ग्रुप या Google Workspace खाते.
अपने खाते के लिए सूचनाएं पाने की सुविधा चालू या बंद करना
अपने खाते के लिए, Performance Monitoring की सूचनाएं चालू या बंद की जा सकती हैं. इससे प्रोजेक्ट के अन्य सदस्यों पर कोई असर नहीं पड़ेगा. ध्यान दें कि सूचनाएं पाने के लिए, आपके पास ज़रूरी अनुमतियां होनी चाहिए.
Performance Monitoring की सूचनाएं चालू या बंद करने के लिए, यह तरीका अपनाएं:
- Firebase कंसोल में, सबसे ऊपर दाएं कोने में,
Firebase सूचनाएं पर जाएं. - इसके बाद,
सेटिंग पर जाएं और Performance Monitoring की सूचनाओं के लिए, खाते की सेटिंग सेट करें.
तीसरे पक्ष की सेवाओं के लिए, बेहतर चेतावनी की सुविधा सेट अप करना
Cloud Functions for Firebase का इस्तेमाल करके, अपनी टीम के पसंदीदा सूचना चैनल पर Performance Monitoring से जुड़ी सूचनाएं भी भेजी जा सकती हैं. उदाहरण के लिए, ऐसा फ़ंक्शन लिखा जा सकता है जो ऐप्लिकेशन के धीरे-धीरे शुरू होने के समय पर सूचना देने वाले इवेंट को कैप्चर करे. साथ ही, सूचना की जानकारी को Discord, Slack या Jira जैसी किसी तीसरे पक्ष की सेवा पर पोस्ट करे.
Cloud Functions for Firebase का इस्तेमाल करके, बेहतर चेतावनी देने की सुविधाएं सेट अप करने के लिए, यह तरीका अपनाएं:
Firebase के लिए Cloud Functions सेट अप करें. इसमें ये टास्क शामिल हैं:
- Node.js या Python के लिए डेवलपमेंट एनवायरमेंट सेट अप करें.
- Firebase सीएलआई को इंस्टॉल करें और उसमें साइन इन करें.
- Firebase सीएलआई का इस्तेमाल करके, Cloud Functions for Firebase को शुरू करें.
कोई ऐसा फ़ंक्शन लिखें और डिप्लॉय करें जो Performance Monitoring से मिलने वाली सूचना को कैप्चर करे और इवेंट पेलोड को मैनेज करे. उदाहरण के लिए, Discord पर मैसेज में सूचना की जानकारी पोस्ट करे.
परफ़ॉर्मेंस अलर्ट से जुड़े उन सभी इवेंट के बारे में जानने के लिए जिन्हें कैप्चर किया जा सकता है, परफ़ॉर्मेंस मॉनिटरिंग अलर्ट के रेफ़रंस दस्तावेज़ पर जाएं.
अमान्य सूचनाओं को अपने-आप हटाना
Performance Monitoring, सूचनाओं की पुष्टि करता है, ताकि यह पक्का किया जा सके कि डेटा मान्य है और सूचनाएं चालू हैं. सूचनाओं को तब मान्य माना जाता है, जब इनमें से कोई एक बात सही हो:
- यह सूचना उस संसाधन आईडी के लिए बनाई जाती है जिसके लिए Performance Monitoring को पिछले 90 दिनों में डेटा मिला है.
- सूचना को हाल ही में किसी कस्टम यूआरएल पैटर्न के लिए बनाया गया था. कस्टम यूआरएल पैटर्न बनाने और सूचना सेट अप करने के बाद, आपके पास उस पैटर्न के लिए डेटा भेजने के लिए 90 दिन होते हैं. अगर 90 दिनों की समयावधि के अंदर कोई डेटा नहीं भेजा जाता है, तो Performance Monitoring उस सूचना को हटा देता है. कस्टम यूआरएल पैटर्न के बारे में ज़्यादा जानने के लिए, कस्टम यूआरएल पैटर्न के तहत कुल डेटा देखें.
अगर इनमें से कोई भी शर्त पूरी नहीं होती है, तो Performance Monitoring सूचना को हटा देता है.
सूचना कॉन्फ़िगर करना
Performance Monitoring से जुड़ी सूचनाएं कॉन्फ़िगर करने के लिए, आपके पास
firebaseperformance.config.update की अनुमति होनी चाहिए. इन भूमिकाओं वाले उपयोगकर्ताओं को यह अनुमति डिफ़ॉल्ट रूप से मिलती है:
Firebase परफ़ॉर्मेंस एडमिन,
Firebase क्वालिटी एडमिन,
Firebase एडमिन,
और प्रोजेक्ट का मालिक या एडिटर.
अगर आपने अब तक ऐसा नहीं किया है, तो अपने ऐप्लिकेशन में Performance Monitoring का सबसे नया SDK टूल जोड़ें. ज़्यादा जानकारी के लिए, वेब, Android, Apple, और Flutter प्लैटफ़ॉर्म के लिए, शुरुआती निर्देश देखें.
रजिस्टर किए गए हर ऐप्लिकेशन में, ट्रेस टेबल या डैशबोर्ड रिपोर्ट कार्ड का इस्तेमाल करके, हर उस मेट्रिक के लिए सूचना कॉन्फ़िगर करें जिसकी आपको निगरानी करनी है. हर ऐप्लिकेशन के लिए, अलग-अलग सूचनाएं सेट की जा सकती हैं. साथ ही, हर सूचना के लिए अलग थ्रेशोल्ड सेट किया जा सकता है. इसके अलावा, यह भी हो सकता है कि किसी ऐप्लिकेशन के लिए कोई सूचना सेट न की गई हो.
ट्रेस टेबल में सूचना कॉन्फ़िगर करना
Firebase कंसोल में Performance Monitoring डैशबोर्ड टैब पर जाएं. इसके बाद, वह ऐप्लिकेशन चुनें जिसके लिए आपको सूचना कॉन्फ़िगर करनी है.
स्क्रीन पर सबसे नीचे मौजूद, ट्रेस टेबल पर स्क्रोल करें.
ट्रेस टाइप का वह टैब चुनें जिसके लिए आपको सूचना सेट करनी है. इसके बाद, लागू होने वाली लाइन ढूंढें.
लाइन के सबसे दाईं ओर, ओवरफ़्लो मेन्यू () खोलें और सूचना की सेटिंग को चुनें.
ऐप्लिकेशन के लिए, सूचना की थ्रेशोल्ड और पर्सेंटाइल (अगर लागू हो) सेट करने या सूचना को चालू/बंद करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें. Android और iOS के लिए डिफ़ॉल्ट पर्सेंटाइल 90वां और वेब के लिए 75वां है. डिफ़ॉल्ट पर्सेंटाइल के बारे में ज़्यादा जानने के लिए, अपने डैशबोर्ड में मुख्य मेट्रिक ट्रैक करना लेख पढ़ें.
डैशबोर्ड के रिपोर्ट कार्ड में सूचना कॉन्फ़िगर करना
Firebase कंसोल में Performance Monitoring डैशबोर्ड टैब पर जाएं. इसके बाद, वह ऐप्लिकेशन चुनें जिसके लिए आपको सूचना कॉन्फ़िगर करनी है.
रिपोर्ट कार्ड टैब में, वह मेट्रिक कार्ड ढूंढें जिसके लिए आपको सूचना कॉन्फ़िगर करनी है.
अपनी पसंद के मेट्रिक कार्ड में, ओवरफ़्लो मेन्यू () खोलें और सूचना की सेटिंग चुनें.
ऐप्लिकेशन के लिए, सूचना की थ्रेशोल्ड और पर्सेंटाइल (अगर लागू हो) सेट करने या सूचना को चालू/बंद करने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें. Android और iOS के लिए डिफ़ॉल्ट पर्सेंटाइल 90वां और वेब के लिए 75वां है. डिफ़ॉल्ट पर्सेंटाइल के बारे में ज़्यादा जानने के लिए, अपने डैशबोर्ड में मुख्य मेट्रिक ट्रैक करना लेख पढ़ें.
परफ़ॉर्मेंस अलर्ट सेट करने के सबसे सही तरीके
नेटवर्क के अनुरोध
Firebase, यूआरएल पैटर्न के तहत एक जैसे नेटवर्क अनुरोधों के डेटा को इकट्ठा करता है. यह डेटा इनमें से कोई एक हो सकता है:
उपयोगकर्ता के तय किए गए पैटर्न, जिन्हें कस्टम यूआरएल पैटर्न कहा जाता है.
Firebase से मिले पैटर्न, जिन्हें अपने-आप बनने वाले यूआरएल पैटर्न कहा जाता है.
ऐप्लिकेशन के इस्तेमाल के नए पैटर्न के आधार पर, ये पैटर्न समय के साथ बदल सकते हैं.
कस्टम यूआरएल पैटर्न के लिए सूचनाएं सेट अप करना
हमारा सुझाव है कि आपने जो भी कस्टम यूआरएल पैटर्न कॉन्फ़िगर किए हैं उनके लिए सूचनाएं सेट अप करें. Firebase, किसी अनुरोध को सबसे पहले कस्टम यूआरएल पैटर्न से मैच करने की कोशिश करता है. इसलिए, मिलते-जुलते अनुरोधों को एक ही यूआरएल पैटर्न से ज़्यादा बेहतर तरीके से मैप किया जाता है. इससे आपकी टीम के लिए, कस्टम यूआरएल पैटर्न से जुड़ी सूचनाएं ज़्यादा काम की और असरदार हो जाती हैं. ऐसा इसलिए, क्योंकि आपने पहले ही अनुरोधों के उस खास पैटर्न की पहचान कर ली है जो आपके ऐप्लिकेशन के लिए ज़रूरी है.
अपने-आप बनने वाले यूआरएल पैटर्न के लिए सूचनाएं सेट अप करना
अपने-आप बनने वाले यूआरएल पैटर्न के लिए सूचना सेट अप करते समय, पक्का करें कि अपने-आप बनने वाला यूआरएल पैटर्न कुछ दिनों के लिए स्थिर हो. ध्यान रखें कि अपने-आप जनरेट होने वाले यूआरएल पैटर्न समय के साथ बदल सकते हैं. साथ ही, सूचना के कॉन्फ़िगरेशन नए यूआरएल पैटर्न पर लागू नहीं होते. इस वजह से, हो सकता है कि आपको उन पैटर्न के लिए गलत सूचनाएं मिलें या सूचनाएं ही न मिलें जिनकी आपको ज़रूरत है. यह पक्का करने के लिए कि यह पैटर्न स्टेबल है, कस्टम यूआरएल पैटर्न भी बनाया जा सकता है.
वेब पेज लोड
वेब मेट्रिक को मापने के लिए, सुझाई गई थ्रेशोल्ड वैल्यू के बारे में जानने के लिए, Core Web Vitals वाला दस्तावेज़ देखें.
स्क्रीन रेंडरिंग
ऐप्लिकेशन इस्तेमाल करने का बेहतर अनुभव देने के लिए, उपयोगकर्ता सेशन में धीमे और फ़्रीज़ हुए फ़्रेम नहीं होने चाहिए. Performance Monitoring का सुझाव है कि आप फ़्रीज़ हुए फ़्रेम के लिए, 1% से ज़्यादा और रेंडर होने में ज़्यादा समय लेने वाले फ़्रेम के लिए, 5% से ज़्यादा की सूचनाएं सेट अप करें. आपको दिखेगा कि परफ़ॉर्मेंस अलर्ट कॉन्फ़िगरेशन के दौरान, ये वैल्यू डिफ़ॉल्ट सेटिंग के तौर पर मौजूद हैं. बहुत ज़्यादा धीमे या रुके हुए फ़्रेम और ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़े अन्य सबसे सही तरीकों के बारे में ज़्यादा जानने के लिए, Google Play के दिशा-निर्देश देखें.