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

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

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

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

  1. परफ़ॉर्मेंस डैशबोर्ड में जाकर, ट्रेस टेबल तक नीचे की ओर स्क्रोल करें. इसके बाद, नेटवर्क अनुरोध सबटैब चुनें.

  2. नेटवर्क अनुरोध सबटैब में मौजूद ड्रॉपडाउन मेन्यू से, कस्टम पैटर्न चुनें.

  3. कस्टम यूआरएल पैटर्न की उस लाइन पर कर्सर घुमाएं जिसे आपको हटाना है.

  4. लाइन के सबसे दाईं ओर मौजूद पर क्लिक करें. इसके बाद, कस्टम पैटर्न हटाएं को चुनें. इसके बाद, डायलॉग में जाकर हटाने की पुष्टि करें.

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

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

  • कस्टम यूआरएल पैटर्न हटाने से, पिछले अनुरोधों से मिले मैच और कुल डेटा पर कोई असर नहीं पड़ता.

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

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

अगले चरण

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

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

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

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

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

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

सक्सेस रेट कैलकुलेशन कॉन्फ़िगर करना

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

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