Firebase Performance Monitoring एक जैसे नेटवर्क अनुरोधों के डेटा को अपने-आप एग्रीगेट करता है इससे आपको नेटवर्क अनुरोध की परफ़ॉर्मेंस के रुझानों को समझने में मदद मिलती है.
हालांकि, कभी-कभी आपको यह तय करना होता है कि Firebase, खास नेटवर्क अनुरोधों के डेटा को कैसे एग्रीगेट करे. इससे आपको अपने ऐप्लिकेशन के इस्तेमाल के मामलों को बेहतर तरीके से समझने में मदद मिलती है. हम नेटवर्क अनुरोधों के लिए, डेटा एग्रीगेशन को पसंद के मुताबिक बनाने के दो तरीके उपलब्ध कराते हैं: कस्टम यूआरएल पैटर्न के तहत डेटा एग्रीगेट करना और सफलता की दर का हिसाब लगाने के तरीके को पसंद के मुताबिक बनाना.
कस्टम यूआरएल पैटर्न के तहत डेटा एग्रीगेट करना
हर अनुरोध के लिए, Firebase यह जांचता है कि नेटवर्क अनुरोध का यूआरएल, किसी यूआरएल पैटर्न से मेल खाता है या नहीं. अगर अनुरोध का यूआरएल, किसी यूआरएल पैटर्न से मेल खाता है, तो Firebase उस अनुरोध के डेटा को यूआरएल पैटर्न के तहत अपने-आप एग्रीगेट कर लेता है.
कस्टम यूआरएल पैटर्न बनाकर, उन खास यूआरएल पैटर्न की निगरानी की जा सकती है जिन्हें Firebase, अपने-आप जनरेट होने वाले यूआरएल पैटर्न मैचिंग की सुविधा से कैप्चर नहीं कर रहा है. उदाहरण के लिए, किसी खास यूआरएल की समस्या हल करने या समय के साथ-साथ यूआरएल के किसी खास सेट की निगरानी करने के लिए, कस्टम यूआरएल पैटर्न का इस्तेमाल किया जा सकता है.
Firebase console के Firebase डैशबोर्ड में सबसे नीचे मौजूद, ट्रेस की टेबल के नेटवर्क अनुरोध सबटैब में, Firebase सभी यूआरएल पैटर्न (कस्टम यूआरएल पैटर्न भी शामिल हैं) और उनके एग्रीगेट किए गए डेटा को दिखाता है.
कस्टम यूआरएल पैटर्न मैचिंग की सुविधा कैसे काम करती है?
Firebase, यूआरएल पैटर्न मैचिंग की सुविधा को अपने-आप इस्तेमाल करने से पहले, कॉन्फ़िगर किए गए किसी भी कस्टम यूआरएल पैटर्न से अनुरोध के यूआरएल को मैच करने की कोशिश करता है. कस्टम यूआरएल पैटर्न से मैच होने वाले किसी भी अनुरोध के लिए, Firebase उस अनुरोध के डेटा को कस्टम यूआरएल पैटर्न के तहत एग्रीगेट करता है.
अगर किसी अनुरोध का यूआरएल, एक से ज़्यादा कस्टम यूआरएल पैटर्न से मैच होता है, तो Firebase उस
अनुरोध को सिर्फ़ सबसे ज़्यादा मिलते-जुलते कस्टम यूआरएल पैटर्न से मैप करता है. इसके लिए, वह
मिलते-जुलते पैटर्न की प्राथमिकता के इस क्रम का इस्तेमाल करता है: सादा टेक्स्ट > * > ** पाथ में बाएं से
दाएं. उदाहरण के लिए, example.com/books/dog के लिए किए गए अनुरोध, दो कस्टम यूआरएल पैटर्न से मैच होते हैं:
example.com/books/*example.com/*/dog
हालांकि, पैटर्न
example.com/books/* _सबसे ज़्यादा मिलते-जुलते_ यूआरएल पैटर्न से मैच होता है. ऐसा इसलिए, क्योंकि
सबसे बाईं ओर मौजूद सेगमेंट books में example.com/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/bazexample.com/bar/baz
|
example.com/*/*/baz |
example.com/foo/bar/bazexample.com/bah/qux/baz
|
|
example.com/foo/* |
example.com/foo/bazexample.com/foo/bar
ध्यान दें: यह पैटर्न,
से मैच नहीं होगा |
|
कोई भी पाथ सफ़िक्स (**) |
example.com/foo/** |
example.com/fooexample.com/foo/bazexample.com/foo/baz/more/segments
|
subdomain.example.com/foo.bar/** |
subdomain.example.com/foo.barsubdomain.example.com/foo.bar/bazsubdomain.example.com/foo.bar/baz/more/segments
|
|
पहला सबडोमेन सेगमेंट (*) |
*.example.com/foo |
bar.example.com/foobaz.example.com/foo |
कस्टम यूआरएल पैटर्न और उनका डेटा देखना
Firebase console के Firebase डैशबोर्ड में सबसे नीचे मौजूद, ट्रेस की टेबल के नेटवर्क अनुरोध सबटैब में, Firebase सभी यूआरएल पैटर्न (कस्टम यूआरएल पैटर्न भी शामिल हैं) और उनके एग्रीगेट किए गए डेटा को दिखाता है.
सिर्फ़ कस्टम यूआरएल पैटर्न देखने के लिए, ट्रेस की टेबल के नेटवर्क अनुरोध सबटैब में मौजूद ड्रॉपडाउन मेन्यू से, कस्टम पैटर्न चुनें. ध्यान दें कि अगर किसी कस्टम यूआरएल पैटर्न का कोई एग्रीगेट किया गया डेटा नहीं है, तो वह सिर्फ़ इस सूची में दिखता है.
किसी यूआरएल पैटर्न के तहत एग्रीगेट किए गए डेटा के लिए, डेटा बनाए रखने की अवधि खत्म होने पर, Firebase उस डेटा को यूआरएल पैटर्न से मिटा देता है. अगर किसी कस्टम यूआरएल पैटर्न के तहत एग्रीगेट किया गया सारा डेटा खत्म हो जाता है, तो Firebase, Firebase console से उस कस्टम यूआरएल पैटर्न को नहीं मिटाता. इसके बजाय, Firebase, ट्रेस की टेबल के नेटवर्क अनुरोध सबटैब की कस्टम पैटर्न सूची में, "खाली" कस्टम यूआरएल पैटर्न को दिखाता रहता है.
कस्टम यूआरएल पैटर्न हटाना
अपने प्रोजेक्ट से कस्टम यूआरएल पैटर्न हटाए जा सकते हैं. ध्यान दें कि अपने-आप जनरेट होने वाले यूआरएल पैटर्न को नहीं हटाया जा सकता.
परफ़ॉर्मेंस डैशबोर्ड में, ट्रेस की टेबल पर जाएं. इसके बाद, नेटवर्क अनुरोध सबटैब चुनें.
नेटवर्क अनुरोध सबटैब में मौजूद ड्रॉपडाउन मेन्यू से, कस्टम पैटर्न चुनें.
उस कस्टम यूआरएल पैटर्न की लाइन पर कर्सर घुमाएं जिसे आपको हटाना है.
लाइन के सबसे दाईं ओर मौजूद, पर क्लिक करें. इसके बाद, कस्टम पैटर्न हटाएं को चुनें. फिर, डायलॉग बॉक्स में जाकर, हटाने की पुष्टि करें.
कस्टम यूआरएल पैटर्न हटाने पर, इन बातों का ध्यान रखें:
आने वाले सभी अनुरोधों को, सबसे ज़्यादा मिलते-जुलते अगले कस्टम यूआरएल पैटर्न से मैप किया जाता है. अगर Firebase को मैच होने वाला कोई कस्टम यूआरएल पैटर्न नहीं मिलता है, तो वह यूआरएल पैटर्न मैचिंग की सुविधा को अपने-आप इस्तेमाल करता है.
कस्टम यूआरएल पैटर्न हटाने से, पहले के अनुरोधों से मिले मैच और एग्रीगेट किए गए डेटा पर कोई असर नहीं पड़ता.
हटाए गए कस्टम यूआरएल पैटर्न और उसके एग्रीगेट किए गए डेटा को, नेटवर्क अनुरोध सबटैब में (जब तक सभी नेटवर्क अनुरोध चुने गए हों) तब तक ऐक्सेस किया जा सकता है, जब तक कि डेटा बनाए रखने की अवधि खत्म न हो जाए. हटाए गए कस्टम यूआरएल पैटर्न के तहत एग्रीगेट किया गया सारा डेटा खत्म होने पर, Firebase उस कस्टम यूआरएल पैटर्न को मिटा देता है.
नेटवर्क अनुरोध सबटैब में (जब तक कस्टम पैटर्न चुने गए हों), हटाए गए कस्टम यूआरएल पैटर्न नहीं दिखते.
अगले चरण
- अपने ऐप्लिकेशन की परफ़ॉर्मेंस को खराब करने वाले नेटवर्क अनुरोधों के लिए, चेतावनियां सेट अप करें. उदाहरण के लिए, अगर किसी खास यूआरएल पैटर्न के लिए जवाब मिलने में लगने वाला समय, आपके सेट किए गए थ्रेशोल्ड से ज़्यादा हो जाता है, तो अपनी टीम के लिए ईमेल से मिलने वाली चेतावनी कॉन्फ़िगर की जा सकती है.
सफलता की दर का हिसाब लगाने के तरीके को पसंद के मुताबिक बनाना
Firebase, हर नेटवर्क अनुरोध के लिए जिन मेट्रिक की निगरानी करता है उनमें से एक, अनुरोध की सफलता की दर है. सफलता की दर, कुल जवाबों के मुकाबले सफल जवाबों का प्रतिशत होती है. इस मेट्रिक से, नेटवर्क और सर्वर की गड़बड़ियों को मेज़र करने में मदद मिलती है.
खास तौर पर, Firebase, 100 से 399 के बीच के रिस्पॉन्स कोड वाले नेटवर्क अनुरोधों को सफल जवाब के तौर पर अपने-आप गिनता है.
सफलता की दर का हिसाब लगाने के तरीके को पसंद के मुताबिक बनाया जा सकता है. इसके लिए, कुछ गड़बड़ी कोड को "सफल जवाब" के तौर पर गिना जा सकता है. इसके अलावा, उन रिस्पॉन्स कोड को भी गिना जा सकता है जिन्हें Firebase, सफल जवाब के तौर पर अपने-आप गिनता है.
उदाहरण के लिए, अगर आपके ऐप्लिकेशन में खोज एंडपॉइंट एपीआई है, तो 404 रिस्पॉन्स को "सफल" के तौर पर गिना जा सकता है. ऐसा इसलिए, क्योंकि खोज एंडपॉइंट के लिए 404 रिस्पॉन्स मिलने की उम्मीद होती है. मान लें कि हर घंटे इस खोज एंडपॉइंट के लिए 100 सैंपल मिलते हैं. इनमें से 60, 200-रिस्पॉन्स हैं और 40, 404-रिस्पॉन्स हैं. सफलता की दर को कॉन्फ़िगर करने से पहले, सफलता की दर 60% होगी. सफलता की दर का हिसाब लगाने के तरीके को कॉन्फ़िगर करने के बाद, 404 रिस्पॉन्स को सफल के तौर पर गिना जाएगा. इसके बाद, सफलता की दर 100% होगी.
सफलता की दर का हिसाब लगाने के तरीके को कॉन्फ़िगर करना
किसी नेटवर्क यूआरएल पैटर्न के लिए, सफलता की दर का हिसाब लगाने के तरीके को कॉन्फ़िगर करने के लिए, आपके पास firebaseperformance.config.update अनुमति होनी चाहिए. इन रोल में, ज़रूरी अनुमति डिफ़ॉल्ट रूप से शामिल होती है:
Firebase Performance का एडमिन,
Firebase Quality का एडeral एडमिन,
Firebase का एडमिन,
और प्रोजेक्ट का मालिक या एडिटर.
- Performance Monitoring console में, डैशबोर्ड टैब पर जाएं. इसके बाद, वह ऐप्लिकेशन चुनें जिसके लिए आपको सफलता की दर का हिसाब लगाने का तरीका कॉन्फ़िगर करना है.Firebase
- स्क्रीन पर सबसे नीचे मौजूद, ट्रेस की टेबल पर जाएं और नेटवर्क अनुरोध टैब चुनें.
- वह यूआरएल पैटर्न ढूंढें जिसके लिए आपको सफलता की दर का हिसाब लगाने का तरीका कॉन्फ़िगर करना है.
- लाइन के सबसे दाईं ओर मौजूद, ओवरफ़्लो मेन्यू () खोलें और सफलता की दर कॉन्फ़िगर करें को चुनें.
- स्क्रीन पर दिए गए निर्देशों का पालन करके, वे रिस्पॉन्स कोड चुनें जिन्हें आपको सफल रिस्पॉन्स कोड के तौर पर गिनना है.