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

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 उस कस्टम यूआरएल पैटर्न को मिटा देता है.
नेटवर्क अनुरोध सब-टैब (कस्टम पैटर्न चुने गए हैं) में, हटाए गए किसी भी कस्टम यूआरएल पैटर्न की सूची नहीं दिखती.

अगले चरण

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

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

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

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

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

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

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

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

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

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