इस पेज पर, Cloud Monitoring मेट्रिक का इस्तेमाल करके, Cloud Firestore अपने डेटाबेस की निगरानी करने का तरीका बताया गया है.
Cloud Monitoring के लिए Cloud Firestore की मेट्रिक
यहां दिए गए सेक्शन में, Cloud Firestoreके लिए उपलब्ध मेट्रिक की खास जानकारी दी गई है.
निगरानी किए जाने वाले संसाधन
Cloud Monitoring में, निगरानी किए जाने वाले संसाधन, लॉजिकल या फ़िज़िकल एंटिटी को दिखाते हैं. जैसे, वर्चुअल मशीन, डेटाबेस या कोई ऐप्लिकेशन. निगरानी किए जाने वाले संसाधनों में, मेट्रिक का यूनीक सेट होता है. इसे एक्सप्लोर किया जा सकता है, डैशबोर्ड के ज़रिए रिपोर्ट किया जा सकता है या चेतावनियां बनाने के लिए इस्तेमाल किया जा सकता है. हर संसाधन के लिए, संसाधन के लेबल का एक सेट भी होता है. ये कुंजी-वैल्यू के ऐसे जोड़े होते हैं जिनमें संसाधन के बारे में अतिरिक्त जानकारी होती है. संसाधन से जुड़ी सभी मेट्रिक के लिए, संसाधन के लेबल उपलब्ध होते हैं.
Cloud Monitoring API का इस्तेमाल करके, Cloud Firestore परफ़ॉर्मेंस की निगरानी, इस संसाधन की मदद से की जाती है:
| संसाधन | ब्यौरा |
firestore.googleapis.com/Database | निगरानी किए जाने वाले संसाधन का टाइप. इससे project,
location, और database_id के बारे में जानकारी मिलती है. |
मेट्रिक
Cloud Firestore के लिए मेट्रिक की पूरी सूची देखने के लिए, Cloud Firestore मेट्रिक देखें. यहां दिए गए सेक्शन में, उपलब्ध कुछ मेट्रिक के बारे में बताया गया है.
सेवा के रनटाइम की मेट्रिक
serviceruntime
मेट्रिक से, किसी प्रोजेक्ट के ट्रैफ़िक की खास जानकारी मिलती है. ये मेट्रिक,
ज़्यादातर Google Cloud एपीआई के लिए उपलब्ध हैं. निगरानी किए जाने वाले संसाधन के टाइप में, ये सामान्य मेट्रिक शामिल होती हैं.consumed_api इन मेट्रिक का सैंपल हर 30 मिनट में लिया जाता है. इससे डेटा को स्मूद किया जाता है.
serviceruntime मेट्रिक के लिए, method एक अहम संसाधन लेबल है. यह लेबल, कॉल किए गए आरपीसी के बुनियादी तरीके को दिखाता है. यह ज़रूरी नहीं है कि आपके कॉल किए गए SDK टूल के तरीके का नाम, आरपीसी के बुनियादी तरीके के नाम जैसा ही हो. इसकी वजह यह है कि SDK टूल, एपीआई का हाई-लेवल ऐब्स्ट्रैक्शन उपलब्ध कराता है. हालांकि, यह समझने के लिए कि आपका ऐप्लिकेशन, Cloud Firestore के साथ कैसे इंटरैक्ट करता है, आरपीसी के तरीके के नाम के आधार पर मेट्रिक को समझना ज़रूरी है.
अगर आपको यह जानना है कि किसी दिए गए SDK टूल के तरीके के लिए, आरपीसी का बुनियादी तरीका क्या है, तो एपीआई का दस्तावेज़ देखें.
api/request_latencies
api/request_latencies मेट्रिक, पूरे किए गए सभी अनुरोधों के लिए, इंतज़ार के समय के डिस्ट्रिब्यूशन की जानकारी देती है.
Cloud Firestore Cloud Firestore Service कॉम्पोनेंट से मेट्रिक रिकॉर्ड करता है. इंतज़ार के समय की मेट्रिक में, वह समय शामिल होता है जब Cloud Firestore को अनुरोध मिलता है और जब Cloud Firestore स्टोरेज लेयर के साथ इंटरैक्शन के साथ-साथ जवाब भेजना पूरा करता है. इस वजह से, क्लाइंट और Cloud Firestore सेवा के बीच राउंड-ट्रिप इंतज़ार का समय (आरटीटी) इन मेट्रिक में शामिल नहीं होता.
दस्तावेज़ की कार्रवाई से जुड़ी मेट्रिक
Cloud Firestore पढ़ने, लिखने, और मिटाने की संख्या की जानकारी देता है. लिखने की मेट्रिक, 'CREATE' और 'UPDATE' कार्रवाई के बीच का ब्रेकडाउन उपलब्ध कराती है. ये मेट्रिक, सीआरयूडी कार्रवाइयों के मुताबिक होती हैं.
इन मेट्रिक का इस्तेमाल करके, यह समझा जा सकता है कि आपका डेटाबेस, पढ़ने के लिए ज़्यादा इस्तेमाल किया जाता है या लिखने के लिए. साथ ही, नए दस्तावेज़ों की संख्या की तुलना में मिटाए गए दस्तावेज़ों की संख्या कितनी है.
document/delete_ops_count: दस्तावेज़ों को मिटाने की कार्रवाइयों की संख्या.document/read_ops_count: क्वेरी या लुकअप से, दस्तावेज़ों को पढ़ने की कार्रवाइयों की संख्या.document/write_ops_count: दस्तावेज़ों को लिखने की कार्रवाइयों की संख्या.
बिलिंग की मेट्रिक
बिलिंग के इस्तेमाल को समझने के लिए, इन मेट्रिक का इस्तेमाल करें. इन मेट्रिक में, एडमिन की कार्रवाइयों (इंडेक्सिंग, इंपोर्ट, एक्सपोर्ट, और बल्क में मिटाना) से जुड़ी बिलिंग शामिल नहीं होती.
api/billable_read_units: बिल किए जा सकने वाले रीड यूनिट की संख्या. सेवा के नाम और एपीआई के तरीके के हिसाब से, इस्तेमाल को बांटा जा सकता है.api/billable_realtime_read_units: रीयल-टाइम अपडेट से, बिल किए जा सकने वाले रीयल-टाइम अपडेट यूनिट की संख्या. यह सिर्फ़ नेटिव मोड में Cloud Firestore पर लागू होता है.api/billable_write_units: बिल किए जा सकने वाले राइट यूनिट की संख्या. सेवा के नाम और एपीआई के तरीके के हिसाब से, इस्तेमाल को बांटा जा सकता है.document/billable_managed_delete_write_units: मैनेज की गई मिटाने की सेवाओं (जैसे, टीटीएल) से, बिल किए जा सकने वाले राइट यूनिट की संख्या.
इंडेक्स की मेट्रिक
इंडेक्स के फ़ैनआउट को समझने के लिए, इंडेक्स के लिखने की दर की तुलना document/write_ops_count मेट्रिक से की जा सकती है.
index/write_count: इंडेक्स के लिखने की संख्या.
टीटीएल की मेट्रिक
Cloud Firestore की मेट्रिक के लिए, टीटीएल की मेट्रिक का इस्तेमाल, लागू की गई टीटीएल नीति के असर की निगरानी करने के लिए किया जाता है.
document/ttl_deletion_count: टीटीएल सेवाओं से मिटाए गए दस्तावेज़ों की कुल संख्या.document/ttl_expiration_to_deletion_delays: टीटीएल वाले किसी दस्तावेज़ के एक्सपायर होने और उसके मिटाए जाने के बीच बीता समय.
पहले से तय डैशबोर्ड देखना और पसंद के मुताबिक डैशबोर्ड बनाना
Cloud Firestore पहले से तय डैशबोर्ड के साथ काम करता है. इनमें Cloud Monitoring की मेट्रिक का इस्तेमाल किया जाता है. पसंद के मुताबिक डैशबोर्ड भी बनाए जा सकते हैं.
डेटाबेस के इस्तेमाल की मेट्रिक देखना
समय के साथ-साथ दस्तावेज़ों को पढ़ने, लिखने, और मिटाने की जानकारी देखने के लिए, Google Cloud Console में इस्तेमाल के डैशबोर्ड खोलें.
ऐक्सेस कंट्रोल
इस्तेमाल के डैशबोर्ड के लिए, Identity and Access Management (IAM) की monitoring.timeSeries.list अनुमति ज़रूरी है.
प्रोजेक्ट के मालिक, एडिटर, और दर्शक की भूमिकाओं के पास यह अनुमति होती है. Cloud Monitoring की भूमिका या पसंद के मुताबिक भूमिका के ज़रिए भी यह अनुमति दी जा सकती है.Cloud Monitoring
डेटाबेस के इस्तेमाल का डैशबोर्ड
Cloud Firestore डेटाबेस के इस्तेमाल की मेट्रिक देखने के लिए, यह तरीका अपनाएं.
Google Cloud Console में, डेटाबेस पेज पर जाएं.
डेटाबेस की सूची में से, ज़रूरी डेटाबेस चुनें.
नेविगेशन मेन्यू में, इस्तेमाल पर क्लिक करें.
इस्तेमाल का डैशबोर्ड और बिलिंग की रिपोर्ट
कंसोल में, Cloud Firestore इस्तेमाल के डैशबोर्ड में इस्तेमाल का अनुमान दिखता है. इनकी मदद से, इस्तेमाल में होने वाली बढ़ोतरी की पहचान की जा सकती है. हालांकि, डैशबोर्ड में बिल की गई कार्रवाइयों की सटीक जानकारी नहीं दिखती. बिल किए गए इस्तेमाल की जानकारी, डैशबोर्ड में दिखने वाली जानकारी से ज़्यादा हो सकती है. बिलिंग की निगरानी करने के लिए, बिलिंग की मेट्रिक देखें.
किसी भी तरह की गड़बड़ी होने पर, बिलिंग रिपोर्ट को इस्तेमाल के डैशबोर्ड से ज़्यादा प्राथमिकता दी जाती है.
इंपोर्ट और एक्सपोर्ट की कार्रवाइयों की वजह से, इस्तेमाल के डैशबोर्ड और बिल किए गए इस्तेमाल के बीच गड़बड़ियां होती हैं. इन कार्रवाइयों से किए गए रीड और राइट, इस्तेमाल के डैशबोर्ड में नहीं दिखते.
डेटाबेस की परफ़ॉर्मेंस की मेट्रिक देखना
Google Cloud Console के Cloud Firestore सेक्शन में मौजूद Monitoring पेज पर, निगरानी के पहले से तय डैशबोर्ड शामिल होते हैं. जैसे, अनुरोधों में लगने वाला समय (पी50 और पी99), जवाब के कोड, और क्वेरी के आंकड़े (पी50). पसंद के मुताबिक एक डैशबोर्ड भी बनाया जा सकता है. किसी डेटाबेस के लिए Monitoring पेज को ऐक्सेस करने के लिए, यह तरीका अपनाएं:
Google Cloud Console में, Cloud Firestore डेटाबेस पेज खोलें.
सूची में से कोई डेटाबेस चुनें.
डैशबोर्ड खोलने के लिए, नेविगेशन मेन्यू में Monitoring पर क्लिक करें.
पसंद के मुताबिक Cloud Monitoring डैशबोर्ड बनाना
Cloud Monitoring में, पसंद के मुताबिक डैशबोर्ड की मदद से, आपके काम की जानकारी को व्यवस्थित तरीके से दिखाया जा सकता है. उदाहरण के लिए, प्रोडक्शन एनवायरमेंट में अपने प्रोजेक्ट के लिए, परफ़ॉर्मेंस की मेट्रिक और चेतावनियों की नीतियां दिखाने के लिए, डैशबोर्ड बनाया जा सकता है.
पसंद के मुताबिक डैशबोर्ड सेट अप करने के बारे में ज़्यादा जानने के लिए, पसंद के मुताबिक डैशबोर्ड मैनेज करना और डैशबोर्ड में विजेट जोड़ना देखें.
चेतावनी की नीति बनाना
Cloud Monitoring में, चेतावनी बनाई जा सकती हैं. इससे, मेट्रिक की किसी शर्त में बदलाव होने पर आपको सूचना मिलती है. इन चेतावनियों का इस्तेमाल करके, उपयोगकर्ताओं पर असर पड़ने से पहले ही संभावित समस्याओं के बारे में सूचना पाई जा सकती है.
चेतावनियां बनाने के बारे में ज़्यादा जानने के लिए, मेट्रिक-थ्रेशोल्ड वाली चेतावनियों की नीतियां बनाना देखें.
यहां दिए गए उदाहरण पर ध्यान दें. इसमें, हम इंतज़ार के समय की चेतावनी की नीति बनाते हैं. चेतावनी की नीति, पांच मिनट की रोलिंग विंडो में पी99 इंतज़ार के समय की जांच करती है. अगर पी99 इंतज़ार का समय, पांच मिनट तक 250 मिसेकंड से ज़्यादा रहता है, तो चेतावनी ट्रिगर हो जाती है.
कंसोल
Google Cloud Console में, Monitoring पेज पर जाएं. इसके बाद notifications चेतावनी को चुनें.
नीति बनाएं को चुनें.
इस्तेमाल किए गए एपीआई संसाधन से, अनुरोधों में लगने वाला समय मेट्रिक चुनें.
नेटिव मोड में Firestore के डेटाबेस के लिए,
firestore.googleapis.comका सेवा फ़िल्टर जोड़ें.ट्रिगर कॉन्फ़िगर करने के लिए, आगे बढ़ें पर क्लिक करें.
कंडिशन टाइप के तौर पर, थ्रेशोल्ड चुनें.
थ्रेशोल्ड की कंडिशन, 250 मिसेकंड की थ्रेशोल्ड वैल्यू पर सेट होती है. रोलिंग विंडो (पांच मिनट) की पूरी अवधि के लिए, पी99 इंतज़ार के समय की वैल्यू एक जैसी रहने पर, चेतावनी ट्रिगर हो जाती है.
थ्रेशोल्ड वैल्यू को 250 पर सेट करें.
सूचनाएं कॉन्फ़िगर करने के लिए, आगे बढ़ें पर क्लिक करें.
चेतावनी की नीति का नाम सेट करें और आगे बढ़ें पर क्लिक करें.
चेतावनी के कॉन्फ़िगरेशन की समीक्षा करें और नीति बनाएं पर क्लिक करें.
एमक्यूएल
Monitoring Query Language (MQL) की क्वेरी का इस्तेमाल करके, इंतज़ार के समय की चेतावनी की वही नीति लागू की जा सकती है. एमक्यूएल का इस्तेमाल करने के ज़्यादा उदाहरणों के लिए, एमक्यूएल की सैंपल क्वेरी देखें.
fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
[value_request_latencies_percentile:
percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'