नेटवर्क अनुरोध डेटा एग्रीगेशन को पसंद के मुताबिक बनाएं

Firebase Performance Monitoring एक जैसे नेटवर्क अनुरोधों के डेटा को अपने-आप इकट्ठा करता है, ताकि आपको नेटवर्क अनुरोध की परफ़ॉर्मेंस के रुझानों को समझने में मदद मिल सके.

हालांकि, कभी-कभी आपको यह तय करना होता है कि Firebase, नेटवर्क अनुरोध से जुड़े डेटा को कैसे इकट्ठा करे, ताकि आपके ऐप्लिकेशन के इस्तेमाल के उदाहरणों को बेहतर तरीके से सपोर्ट किया जा सके. हम नेटवर्क अनुरोधों के लिए, डेटा एग्रीगेशन को पसंद के मुताबिक बनाने के दो तरीके उपलब्ध कराते हैं: कस्टम यूआरएल पैटर्न के तहत डेटा एग्रीगेट करना और सक्सेस रेट के हिसाब से कैलकुलेट करने के तरीके को पसंद के मुताबिक बनाना.

कस्टम यूआरएल पैटर्न के हिसाब से डेटा को एग्रीगेट करना

हर अनुरोध के लिए, Firebase यह जांच करता है कि नेटवर्क अनुरोध का यूआरएल, यूआरएल पैटर्न से मेल खाता है या नहीं. अगर अनुरोध किया गया यूआरएल, किसी यूआरएल पैटर्न से मेल खाता है, तो Firebase अनुरोध के डेटा को यूआरएल पैटर्न के हिसाब से अपने-आप एग्रीगेट कर देता है.

कस्टम यूआरएल पैटर्न बनाए जा सकते हैं. इससे उन यूआरएल पैटर्न को मॉनिटर किया जा सकता है जिन्हें Firebase, अपने-आप यूआरएल पैटर्न मैच करने की सुविधा के ज़रिए कैप्चर नहीं कर रहा है. उदाहरण के लिए, किसी यूआरएल से जुड़ी समस्या हल करने या समय के साथ यूआरएल के किसी सेट को मॉनिटर करने के लिए, कस्टम यूआरएल पैटर्न का इस्तेमाल किया जा सकता है.

Firebase, सभी यूआरएल पैटर्न (कस्टम यूआरएल पैटर्न भी शामिल हैं) और उनके एग्रीगेट किए गए डेटा को, ट्रेस टेबल के नेटवर्क अनुरोध सबटैब में दिखाता है. यह सबटैब, Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड के सबसे नीचे होता है.

कस्टम यूआरएल पैटर्न मैचिंग कैसे काम करती है?

Firebase, यूआरएल पैटर्न अपने-आप मैच होने की सुविधा का इस्तेमाल करने से पहले, अनुरोध किए गए यूआरएल को कॉन्फ़िगर किए गए किसी कस्टम यूआरएल पैटर्न से मैच करने की कोशिश करता है. कस्टम यूआरएल पैटर्न से मेल खाने वाले किसी भी अनुरोध के लिए, Firebase अनुरोधों के डेटा को कस्टम यूआरएल पैटर्न के तहत इकट्ठा करता है.

अगर किसी अनुरोध का यूआरएल, एक से ज़्यादा कस्टम यूआरएल पैटर्न से मेल खाता है, तो Firebase अनुरोध को सिर्फ़ सबसे सटीक कस्टम यूआरएल पैटर्न पर मैप करता है. ऐसा, यहां दिए गए क्रम के हिसाब से किया जाता है: सामान्य टेक्स्ट > * > ** पाथ में बाईं से दाईं ओर. उदाहरण के लिए, example.com/books/dog के लिए किए गए अनुरोध में, दो कस्टम यूआरएल पैटर्न मैच होते हैं:

example.com/books/*
example.com/*/dog

हालांकि, पैटर्न example.com/books/*, यूआरएल पैटर्न से मेल खाने वाला सबसे खास पैटर्न है, क्योंकि example.com/books/* में सबसे बाईं ओर मौजूद सेगमेंट books को example.com/*/dog में सबसे बाईं ओर मौजूद सेगमेंट * से ज़्यादा प्राथमिकता मिलती है.

नया कस्टम यूआरएल पैटर्न बनाते समय, इन बातों का ध्यान रखें:

नए कस्टम यूआरएल पैटर्न बनाने से, पिछली बार के अनुरोधों से मिले मैच और कुल डेटा पर कोई असर नहीं पड़ता. Firebase, अनुरोध किए गए डेटा को पिछली तारीख से फिर से इकट्ठा नहीं करता है.
कस्टम यूआरएल का नया पैटर्न बनाने से, सिर्फ़ आने वाले समय के अनुरोधों पर असर पड़ता है. Performance Monitoring को नए कस्टम यूआरएल पैटर्न के तहत डेटा इकट्ठा करने और उसे एग्रीगेट करने में 12 घंटे लग सकते हैं.

कस्टम यूआरएल पैटर्न बनाना

Firebase कंसोल के परफ़ॉर्मेंस डैशबोर्ड में सबसे नीचे मौजूद ट्रेस टेबल में, नेटवर्क अनुरोध सबटैब से कस्टम यूआरएल पैटर्न बनाया जा सकता है.

कस्टम यूआरएल पैटर्न बनाने के लिए, प्रोजेक्ट के सदस्य को मालिक या एडिटर होना चाहिए. हालांकि, प्रोजेक्ट के सभी सदस्य कस्टम यूआरएल पैटर्न और उनके एग्रीगेट किए गए डेटा को देख सकते हैं.

हर ऐप्लिकेशन के लिए, ज़्यादा से ज़्यादा 400 कस्टम यूआरएल पैटर्न बनाए जा सकते हैं. साथ ही, उस ऐप्लिकेशन के हर डोमेन के लिए, ज़्यादा से ज़्यादा 100 कस्टम यूआरएल पैटर्न बनाए जा सकते हैं.

कस्टम यूआरएल पैटर्न बनाने के लिए, होस्टनेम से शुरू करें. इसके बाद, पाथ सेगमेंट जोड़ें. होस्टनेम में एक मान्य डोमेन शामिल होना चाहिए. इसमें सबडोमेन को शामिल करना ज़रूरी नहीं है. यूआरएल से मैच करने वाला पैटर्न बनाने के लिए, पाथ सेगमेंट के इस सिंटैक्स का इस्तेमाल करें.

सामान्य टेक्स्ट — किसी स्ट्रिंग से पूरी तरह मैच करता है
* — पहले सबडोमेन सेगमेंट या किसी पाथ सेगमेंट में मौजूद किसी भी स्ट्रिंग से मैच करता है
** — किसी भी पाथ के सफ़िक्स से मेल खाता है

इस टेबल में, कस्टम यूआरएल पैटर्न मैचिंग के कुछ संभावित उदाहरण दिए गए हैं.

मिलान करने के लिए...	कस्टम यूआरएल पैटर्न बनाएं, जैसे कि...	इस यूआरएल पैटर्न से मिलते-जुलते उदाहरण
पूरी तरह मेल खाने वाला यूआरएल	`example.com/foo/baz`	`example.com/foo/baz`
कोई भी सिंगल पाथ सेगमेंट (`*`)	`example.com/*/baz`	`example.com/foo/baz` `example.com/bar/baz`
	`example.com///baz`	`example.com/foo/bar/baz` `example.com/bah/qux/baz`
	`example.com/foo/*`	`example.com/foo/baz` `example.com/foo/bar` ध्यान दें: यह पैटर्न `example.com/foo` से मेल नहीं खाएगा.
पाथ का कोई भी सफ़िक्स (`**`)	`example.com/foo/**`	`example.com/foo` `example.com/foo/baz` `example.com/foo/baz/more/segments`
पाथ का कोई भी सफ़िक्स (`**`)	`subdomain.example.com/foo.bar/**`	`subdomain.example.com/foo.bar` `subdomain.example.com/foo.bar/baz` `subdomain.example.com/foo.bar/baz/more/segments`
पहला सबडोमेन सेगमेंट (`*`)	`*.example.com/foo`	`bar.example.com/foo` `baz.example.com/foo`

कस्टम यूआरएल पैटर्न और उनका डेटा देखना

कस्टम यूआरएल पैटर्न सिर्फ़ देखने के लिए, ट्रेस टेबल के नेटवर्क अनुरोध सब-टैब में मौजूद ड्रॉपडाउन मेन्यू से, कस्टम पैटर्न चुनें. ध्यान दें कि अगर किसी कस्टम यूआरएल पैटर्न के लिए कोई एग्रीगेट किया गया डेटा उपलब्ध नहीं है, तो वह सिर्फ़ इस सूची में दिखता है.

जब यूआरएल पैटर्न के तहत इकट्ठा किए गए डेटा के लिए, डेटा के रखरखाव की अवधि खत्म हो जाती है, तो Firebase उस डेटा को यूआरएल पैटर्न से मिटा देता है. अगर कस्टम यूआरएल पैटर्न के तहत इकट्ठा किया गया सारा डेटा मिट जाता है, तो Firebase, Firebase कंसोल से कस्टम यूआरएल पैटर्न को नहीं मिटाता है. इसके बजाय, Firebase, ट्रेस टेबल के नेटवर्क अनुरोध सबटैब की कस्टम पैटर्न सूची में "खाली" कस्टम यूआरएल पैटर्न दिखाता रहता है.

कस्टम यूआरएल पैटर्न हटाना

अपने प्रोजेक्ट से कस्टम यूआरएल पैटर्न हटाए जा सकते हैं. ध्यान दें कि ऑटोमैटिक यूआरएल पैटर्न को हटाया नहीं जा सकता.

परफ़ॉर्मेंस डैशबोर्ड में जाकर, ट्रेस टेबल तक नीचे की ओर स्क्रोल करें. इसके बाद, नेटवर्क अनुरोध सबटैब चुनें.
नेटवर्क अनुरोध सबटैब में मौजूद ड्रॉपडाउन मेन्यू से, कस्टम पैटर्न चुनें.
कस्टम यूआरएल पैटर्न की उस लाइन पर कर्सर घुमाएं जिसे आपको हटाना है.
लाइन के सबसे दाईं ओर मौजूद पर क्लिक करें. इसके बाद, कस्टम पैटर्न हटाएं को चुनें. इसके बाद, डायलॉग में जाकर हटाने की पुष्टि करें.

कस्टम यूआरएल पैटर्न हटाने पर, इन बातों का ध्यान रखें:

आने वाले समय में किए जाने वाले सभी अनुरोध, कस्टम यूआरएल पैटर्न से मेल खाने वाले अगले सबसे सटीक यूआरएल पर मैप किए जाते हैं. अगर Firebase को मिलते-जुलते कस्टम यूआरएल पैटर्न नहीं मिलते हैं, तो वह यूआरएल पैटर्न अपने-आप मैच होने की सुविधा का इस्तेमाल करता है.
कस्टम यूआरएल पैटर्न हटाने से, पिछले अनुरोधों से मिले मैच और कुल डेटा पर कोई असर नहीं पड़ता.

लागू होने वाली डेटा रखरखाव की अवधि खत्म होने तक, हटाए गए कस्टम यूआरएल पैटर्न और उसके एग्रीगेट किए गए डेटा को नेटवर्क अनुरोध सब-टैब में ऐक्सेस किया जा सकता है. इसके लिए, सभी नेटवर्क अनुरोध को चुना गया हो. जब हटाए गए कस्टम यूआरएल पैटर्न के तहत इकट्ठा किए गए सभी डेटा की समयसीमा खत्म हो जाती है, तब Firebase कस्टम यूआरएल पैटर्न को मिटा देता है.
नेटवर्क अनुरोध सबटैब में, हटाए गए कस्टम यूआरएल पैटर्न की कोई सूची नहीं दिखती. इस सबटैब में कस्टम पैटर्न चुना गया है.

अगले चरण

नेटवर्क अनुरोधों के लिए सूचनाएं सेट अप करें. इससे आपको उन अनुरोधों के बारे में पता चलेगा जिनकी वजह से आपके ऐप्लिकेशन की परफ़ॉर्मेंस खराब हो रही है. उदाहरण के लिए, अगर किसी यूआरएल पैटर्न के लिए जवाब देने में लगने वाला समय, आपके सेट किए गए थ्रेशोल्ड से ज़्यादा हो जाता है, तो अपनी टीम के लिए ईमेल सूचना कॉन्फ़िगर की जा सकती है.

सफलता दर का हिसाब लगाने के तरीके को पसंद के मुताबिक बनाना

Firebase, हर नेटवर्क अनुरोध के लिए जिन मेट्रिक की निगरानी करता है उनमें से एक, अनुरोध के पूरा होने की दर है. सफलता दर, कुल जवाबों की तुलना में सफल जवाबों का प्रतिशत होती है. इस मेट्रिक की मदद से, नेटवर्क और सर्वर से जुड़ी गड़बड़ियों को मेज़र किया जा सकता है.

खास तौर पर, Firebase, 100 से 399 के बीच के रिस्पॉन्स कोड वाले नेटवर्क अनुरोधों को सफल रिस्पॉन्स के तौर पर अपने-आप गिनता है.

सफलता की दर के हिसाब लगाने के तरीके को पसंद के मुताबिक बनाया जा सकता है. इसके लिए, कुछ गड़बड़ी कोड को "सफल जवाब" के तौर पर गिना जा सकता है. ऐसा उन रिस्पॉन्स कोड के अलावा किया जा सकता है जिन्हें Firebase अपने-आप सफल जवाब के तौर पर गिनता है.

उदाहरण के लिए, अगर आपके ऐप्लिकेशन में सर्च एंडपॉइंट एपीआई है, तो 404 रिस्पॉन्स को "सफल" के तौर पर गिना जा सकता है. ऐसा इसलिए, क्योंकि सर्च एंडपॉइंट के लिए 404 रिस्पॉन्स मिलने की उम्मीद होती है. मान लें कि हर घंटे इस सर्च एंडपॉइंट के लिए 100 सैंपल हैं. इनमें से 60 सैंपल, 200-रिस्पॉन्स वाले हैं और 40 सैंपल, 404-रिस्पॉन्स वाले हैं. सफलता की दर को कॉन्फ़िगर करने से पहले, यह 60% होगी. 404 रिस्पॉन्स को सफल रिस्पॉन्स के तौर पर गिनने के लिए, सफलता दर के आकलन को कॉन्फ़िगर करने के बाद, सफलता दर 100% हो जाएगी.

सफलता की दर के हिसाब से कैलकुलेशन कॉन्फ़िगर करना

नेटवर्क यूआरएल पैटर्न के लिए, सफलता दर के हिसाब लगाने की सुविधा को कॉन्फ़िगर करने के लिए, आपके पास firebaseperformance.config.update अनुमति होनी चाहिए. इन भूमिकाओं के लिए, यह ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है: Firebase परफ़ॉर्मेंस एडमिन, Firebase क्वालिटी एडमिन, Firebase एडमिन, और प्रोजेक्ट का मालिक या एडिटर.

Firebase कंसोल में, Performance Monitoring डैशबोर्ड टैब पर जाएं. इसके बाद, वह ऐप्लिकेशन चुनें जिसके लिए आपको सफलता दर का हिसाब लगाने की सुविधा कॉन्फ़िगर करनी है.
स्क्रीन पर सबसे नीचे मौजूद, ट्रेस टेबल में नीचे की ओर स्क्रोल करें. इसके बाद, नेटवर्क अनुरोध टैब चुनें.
उस यूआरएल पैटर्न को ढूंढें जिसके लिए आपको सफलता दर की गणना कॉन्फ़िगर करनी है.
लाइन के सबसे दाईं ओर, ओवरफ़्लो मेन्यू () खोलें. इसके बाद, सफलता की दर कॉन्फ़िगर करें चुनें.
स्क्रीन पर दिए गए निर्देशों का पालन करके, वे रिस्पॉन्स कोड चुनें जिन्हें आपको सफल रिस्पॉन्स कोड के तौर पर गिनना है.