Google Maps Platform मॉनिटरिंग

Cloud Monitoring, आपके एपीआई और सेवा के साथ-साथ, आपके इस्तेमाल किए जाने वाले Google Cloud संसाधनों की मेट्रिक इकट्ठा करता है. इस दस्तावेज़ में, Cloud Monitoring को कॉन्फ़िगर करने का तरीका बताया गया है. साथ ही, एपीआई के इस्तेमाल पर नज़र रखने, डैशबोर्ड बनाने, और सूचनाएं बनाने के लिए, इसका इस्तेमाल करने का तरीका बताया गया है.

Cloud Monitoring में कई सुविधाएं और विकल्प मौजूद हैं. इस दस्तावेज़ में, Cloud Monitoring के बारे में बताया गया है और इसके बुनियादी उदाहरण दिए गए हैं. सभी सुविधाओं के बारे में जानकारी पाने के लिए, Cloud Monitoring दस्तावेज़ देखें. इसमें आपको कई और उदाहरण भी मिलेंगे.

Cloud Monitoring को कॉन्फ़िगर करना

मॉनिटरिंग की मदद से, मेट्रिक देखी और मैनेज की जा सकती हैं:

  • किसी एक प्रोजेक्ट के लिए
  • एक ही संगठन के कई प्रोजेक्ट के लिए
  • एक से ज़्यादा संगठनों के कई प्रोजेक्ट के लिए

अपने प्रोजेक्ट की मेट्रिक उपलब्ध कराने के लिए, यह तरीका अपनाएं:

  1. Google Cloud Console में, Monitoring को चुनें:

    'मॉनिटर करें' पर जाएं

  2. पक्का करें कि आपने सही प्रोजेक्ट चुना हो.
  3. मॉनिटरिंग नेविगेशन पैनल में, मेट्रिक स्कोप की दाईं ओर मौजूद, > पर क्लिक करें. इस स्क्रीनशॉट में वह पेज दिखाया गया है जो AllEnvironments प्रोजेक्ट को चुनने पर दिखता है:

    प्रोजेक्ट के लिए मॉनिटर की गई मेट्रिक का स्क्रीनशॉट. हर प्रोजेक्ट, उसके प्रोजेक्ट आईडी और भूमिका के साथ सूची में शामिल होता है.

इस प्रोजेक्ट से मॉनिटर की जाने वाली मेट्रिक लेबल वाली टेबल में, उन प्रोजेक्ट की सूची होती है जिनकी मेट्रिक को मौजूदा मेट्रिक स्कोप से ऐक्सेस किया जा सकता है. टेबल की हर लाइन में, एक प्रोजेक्ट और उस प्रोजेक्ट की भूमिका की जानकारी होती है:

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

यहां दिए गए प्रोजेक्ट, इस प्रोजेक्ट की मेट्रिक देख सकते हैं लेबल वाली टेबल में, उन प्रोजेक्ट की सूची होती है जिनके मेट्रिक स्कोप में मौजूदा प्रोजेक्ट शामिल होता है. पिछले स्क्रीनशॉट से पता चलता है कि कोई अन्य प्रोजेक्ट, AllEnvironments प्रोजेक्ट में सेव की गई मेट्रिक को ऐक्सेस नहीं कर सकता.

प्रोजेक्ट जोड़ने और हटाने के तरीके के साथ-साथ ज़्यादा जानकारी के लिए, Cloud Monitoring को कॉन्फ़िगर करना लेख पढ़ें.

मेट्रिक एक्सप्लोर करना

मेट्रिक डेटा को एक्सप्लोर करने के लिए, मेट्रिक एक्सप्लोरर का इस्तेमाल करके चार्ट बनाएं. यह Cloud Monitoring में शामिल होता है. उदाहरण के लिए, अगर आपको किसी एपीआई के कोटे के इस्तेमाल की जानकारी देखनी है, तो मेट्रिक एक्सप्लोरर का इस्तेमाल करके, सबसे हाल का डेटा दिखाने वाला चार्ट बनाया जा सकता है.

इस इमेज में, Maps API के लिए कोटे के इस्तेमाल की जानकारी देने वाला चार्ट दिखाया गया है:

सभी Maps API के लिए, कोटा मेट्रिक के डेटा का स्क्रीनशॉट. यह एक बार चार्ट दिखाता है, जिसमें बार का हर सेगमेंट एक अलग एपीआई से जुड़ा होता है.

इस उदाहरण में, स्टैक किया गया बार चार्ट दिखाया गया है. इसमें हर एपीआई को बार के एक सेक्शन से दिखाया गया है. अलग-अलग तरह के चार्ट बनाए जा सकते हैं. जैसे, लाइन चार्ट, बार चार्ट, और हीट मैप. एक ऐसा चार्ट भी बनाया जा सकता है जिसमें ज़्यादा से ज़्यादा 10 अलग-अलग मेट्रिक दिखें.

इस इमेज में:

  • चार्ट के बाईं ओर मौजूद संसाधन का टाइप और मेट्रिक फ़ील्ड, चार्ट में दिखने वाले मेट्रिक डेटा को तय करते हैं.
  • चार्ट के ऊपर मौजूद चार्ट टाइप ड्रॉप-डाउन से, चार्ट का टाइप चुना जा सकता है. इस उदाहरण में, इसे स्टैक किया गया बार चार्ट पर सेट किया गया है.
  • चार्ट के ऊपर मौजूद समयावधि को 1W (एक हफ़्ते) पर सेट किया गया हो.
  • चार्ट के नीचे service, quota_metrics, एपीआई method, और मेट्रिक value की सूची दी गई है. इससे चार्ट के डेटा के बारे में पता चलता है. दिखाए गए डेटा को बेहतर बनाने के लिए, इस जानकारी का इस्तेमाल करें. इसके लिए, फ़िल्टर जोड़ें को चुनें.

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

किसी एक मेट्रिक को चार्ट में दिखाना

मेट्रिक एक्सप्लोरर का इस्तेमाल करके चार्ट को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

  1. Cloud Console में, Monitoring को चुनें:

    'मॉनिटर करें' पर जाएं

  2. नेविगेशन पैनल में, मेट्रिक एक्सप्लोरर को चुनें.
  3. टूलबार में, चार्ट टाइप ड्रॉप-डाउन से स्टैक किया गया बार चार्ट चुनें, ताकि मेट्रिक डेटा को बार चार्ट के तौर पर देखा जा सके.
  4. कोई समयावधि चुनें, जैसे कि 1W (एक हफ़्ता).
  5. चार्ट पर दिखने वाला डेटा तय करें. मेन्यू पर आधारित इंटरफ़ेस का इस्तेमाल करने या फ़िल्टर डालने के लिए, कॉन्फ़िगरेशन टैब को चुनें. मॉनिटरिंग क्वेरी लैंग्वेज (एमक्यूएल) का इस्तेमाल करने के लिए, MQL टैब को चुनें.
    1. कोटा के इस्तेमाल का चार्ट बनाने के लिए, संसाधन के टाइप के तौर पर उपभोक्ता कोटा चुनें. इसके अलावा, अगर आपको एपीआई के इस्तेमाल के लिए चार्ट बनाना है, तो इस्तेमाल किया गया एपीआई या Google Maps API चुनें. Google Maps Platform के एपीआई के लिए उपलब्ध इस्तेमाल की मेट्रिक के बारे में ज़्यादा जानकारी के लिए, इस्तेमाल की मेट्रिक सेक्शन देखें. हर संसाधन टाइप की जानकारी देखने के लिए, उस पर कर्सर घुमाएं.
    2. मेट्रिक के लिए, कोटा के इस्तेमाल की दर चुनें. चार्ट अपने-आप अपडेट हो जाता है और मेट्रिक का डेटा दिखाता है. ध्यान दें कि मेट्रिक के लिए, कोटे के अन्य विकल्प भी मौजूद हैं. हर मेट्रिक के बारे में जानकारी देखने के लिए, उस पर कर्सर घुमाएं. मेट्रिक एक्सप्लोरर के फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, मेट्रिक चुनना और चार्ट में डेटा दिखाने का तरीका चुनना लेख पढ़ें.
  6. (ज़रूरी नहीं) डिसप्ले को बेहतर बनाने के लिए, इन विकल्पों का इस्तेमाल करें:
    1. डेटा के किसी सबसेट को दिखाने के लिए, फ़िल्टर जोड़ें. कोई फ़िल्टर जोड़ने के लिए, फ़िल्टर जोड़ें को चुनें और डायलॉग बॉक्स में जानकारी भरें. ज़्यादा जानकारी के लिए, चार्ट में मौजूद डेटा को फ़िल्टर करना लेख पढ़ें. उदाहरण के लिए, किसी एक एपीआई का डेटा देखने के लिए:
      1. लेबल फ़ील्ड में, तरीका चुनें.
      2. तुलना फ़ील्ड में, = (बराबर है) चुनें.
      3. वैल्यू फ़ील्ड में, किसी खास तरीके का नाम चुनें. आपको डेटा दिखाने के लिए, किसी तरीके का नाम चुनने के लिए कहा जाएगा.
      4. चार्ट को अपडेट करने के लिए, हो गया को चुनें.
    2. टाइम सीरीज़ को किसी लेबल के हिसाब से ग्रुप करने के लिए, इसके हिसाब से ग्रुप बनाएं फ़ील्ड का इस्तेमाल करें. इस फ़ील्ड के लिए कोई वैल्यू चुनने पर, एग्रीगेटर फ़ील्ड के लिए कोई वैल्यू अपने-आप चुन ली जाती है.
    3. टाइम सीरीज़ को जोड़ने का तरीका बताने के लिए, एग्रीगेटर फ़ील्ड सेट करें. उदाहरण के लिए, अगर इसके हिसाब से ग्रुप बनाएं फ़ील्ड खाली है और एग्रीगेटर फ़ील्ड को मीन पर सेट किया गया है, तो चार्ट में टाइम सीरीज़ का औसत दिखता है.
    4. अलग-अलग टाइम सीरीज़ को प्रोसेस करने का तरीका कॉन्फ़िगर करने के लिए, बेहतर विकल्प चुनें. ज़्यादा जानकारी के लिए, मेट्रिक एक्सप्लोरर का इस्तेमाल करते समय मेट्रिक चुनना लेख पढ़ें.

  7. चाहें, तो इसे डैशबोर्ड में जोड़ें.

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

एक से ज़्यादा मेट्रिक को चार्ट में दिखाना

कुछ मामलों में, आपको एक ही चार्ट पर कई मेट्रिक दिखानी पड़ सकती हैं. उदाहरण के लिए, हो सकता है कि आपको कोटा के इस्तेमाल को दिखाने वाले चार्ट पर ही, कोटा की सीमा दिखानी हो. किसी चार्ट में ज़्यादा से ज़्यादा 10 मेट्रिक दिखाई जा सकती हैं.

किसी मौजूदा चार्ट में मेट्रिक जोड़ने के लिए, यह तरीका अपनाएं:

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

मेट्रिक एक्सप्लोर करने के बारे में ज़्यादा जानने के लिए, ये लेख पढ़ें:

डैशबोर्ड बनाना

डैशबोर्ड की मदद से, टाइम-सीरीज़ डेटा को चार्ट के कलेक्शन के तौर पर देखा और मॉनिटर किया जा सकता है. Cloud Monitoring में, पहले से तय डैशबोर्ड और कस्टम डैशबोर्ड का इस्तेमाल किया जा सकता है:

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

कस्टम डैशबोर्ड बनाने के लिए, Cloud Console या Cloud Monitoring API का इस्तेमाल किया जा सकता है. इस इमेज में, दो चार्ट वाला कस्टम डैशबोर्ड दिखाया गया है:

  • बाईं ओर कोटा चार्ट
  • दाईं ओर, एपीआई की संख्या दिखाने वाला चार्ट

कस्टम डैशबोर्ड का स्क्रीनशॉट, जिसमें दो चार्ट दिख रहे हैं. बाईं ओर मौजूद चार्ट, कोटा चार्ट है. वहीं, दाईं ओर मौजूद चार्ट, एपीआई के इस्तेमाल का चार्ट है. दोनों चार्ट के हॉरिज़ॉन्टल ऐक्सिस पर, समय के पॉइंट की सूची होती है.

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

अगर आपने Cloud Monitoring API का इस्तेमाल करके कस्टम डैशबोर्ड मैनेज करने का विकल्प चुना है, तो मेट्रिक एक्सप्लोरर आपको दो काम की सुविधाएं देता है:

  • डैशबोर्ड में जोड़े जाने वाले चार्ट के लिए JSON फ़ॉर्मैट जनरेट करने के लिए, मेट्रिक एक्सप्लोरर की मदद से चार्ट को कॉन्फ़िगर करें. इसके बाद, मेट्रिक एक्सप्लोरर टूलबार में मौजूद ज़्यादा विकल्प मेन्यू आइटम से, JSON कोड को ऐक्सेस किया जा सकता है.
  • Cloud Monitoring API के साथ इस्तेमाल किए जाने वाले मॉनिटरिंग फ़िल्टर के सिंटैक्स की पहचान करने के लिए, मेट्रिक एक्सप्लोरर के मेन्यू-ड्रिवन इंटरफ़ेस का इस्तेमाल करके चार्ट को कॉन्फ़िगर करें. मेट्रिक और फ़िल्टर चुनने के बाद, डायरेक्ट फ़िल्टर मोड पर स्विच करें, ताकि आपको इसके बराबर का मॉनिटरिंग फ़िल्टर दिखे.

कस्टम डैशबोर्ड बनाना

कस्टम डैशबोर्ड बनाने के लिए, यह तरीका अपनाएं:

  1. Cloud Console में, Monitoring को चुनें:

    'मॉनिटर करें' पर जाएं

  2. नेविगेशन पैनल में, डैशबोर्ड को चुनें.
  3. डैशबोर्ड की खास जानकारी वाले पेज पर, डैशबोर्ड बनाएं पर क्लिक करें.
  4. डैशबोर्ड में जोड़े जाने वाले हर चार्ट के लिए, यह तरीका अपनाएं:

    1. चार्ट जोड़ें में जाकर, चार्ट का कोई टाइप चुनें या लाइब्रेरी से किसी चार्ट को खींचकर ग्राफ़ एरिया में छोड़ें.

      चुने गए टाइप का पहले से कॉन्फ़िगर किया गया चार्ट दिखता है. इस उदाहरण में, एक लाइन चार्ट और उसका कॉन्फ़िगरेशन पैनल दिखाया गया है:

      मेट्रिक एक्सप्लोरर का स्क्रीनशॉट, जिसका इस्तेमाल करके डैशबोर्ड में जोड़ने के लिए चार्ट बनाया जाता है.

    2. संसाधन का टाइप और मेट्रिक चुनें. इसके बाद, कोई भी फ़िल्टर लागू करें, जैसा कि आपने चार्ट बनाते समय किया था.

      अपने विकल्पों के बारे में ज़्यादा जानने के लिए, डैशबोर्ड विजेट जोड़ना लेख पढ़ें.

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

डैशबोर्ड देखना

डैशबोर्ड देखने के लिए, यह तरीका अपनाएं:

  1. Cloud Console में, Monitoring को चुनें:

    'मॉनिटर करें' पर जाएं

  2. नेविगेशन पैनल में, डैशबोर्ड को चुनें.
  3. सूची से अपना कस्टम डैशबोर्ड या पहले से तय डैशबोर्ड चुनें.

डैशबोर्ड बनाने के बारे में ज़्यादा जानकारी के लिए, यह लेख पढ़ें:

इस्तेमाल से जुड़ी मेट्रिक

Google Maps Platform API के इस्तेमाल पर नज़र रखने के लिए, मेट्रिक के दो ग्रुप उपलब्ध हैं: सर्विस रनटाइम मेट्रिक (संसाधन टाइप consumed_api), जो ज़्यादातर Google Cloud API के लिए उपलब्ध हैं और Google Maps Platform मेट्रिक, जो Google Maps Platform API के लिए खास मेट्रिक हैं (संसाधन टाइप maps.googleapis.com/Api).

दोनों मेट्रिक, एपीआई के इस्तेमाल से जुड़े ट्रैफ़िक को बांटने के लिए, संसाधन लेबल के एक ही सेट के साथ काम करती हैं: project_id, service, method, version, location, और credential_id. संसाधन लेबल के ब्यौरे देखने के लिए, मेट्रिक संसाधन के दस्तावेज़ में जाएं:

मेट्रिक के हर ग्रुप में, इस्तेमाल की निगरानी के लिए दो तरह की मेट्रिक होती हैं: अनुरोध की संख्या और अनुरोध में लगने वाला समय.

अनुरोधों की संख्या मेट्रिक में, इस्तेमाल के ट्रैफ़िक को protocol, grpc_status_code, response_code, और response_code_class मेट्रिक लेबल के हिसाब से बांटा जा सकता है. इसके अलावा, Google Maps Platform की मेट्रिक में, platform_type के हिसाब से डेटा को अलग-अलग किया जा सकता है.

अनुरोध में लगने वाले समय की मेट्रिक में, इस्तेमाल के ट्रैफ़िक को protocol, platform_type, response_code, और response_code_class मेट्रिक लेबल के हिसाब से बांटा जा सकता है. हालांकि, ऐसा सिर्फ़ Google Maps Platform की मेट्रिक में किया जा सकता है.

मेट्रिक टाइप और लेबल के बारे में ज़्यादा जानकारी के लिए, मेट्रिक ग्रुप के दस्तावेज़ देखें:

रिस्पॉन्स स्टेटस और रिस्पॉन्स कोड लेबल की मैपिंग

नीचे दी गई टेबल में, रिस्पॉन्स स्टेटस कोड और एचटीटीपी रिस्पॉन्स कोड के बीच की मैपिंग दिखाई गई है. यह कोड, Google Maps Platform API के अनुरोधों और Cloud Monitoring में उपलब्ध रिस्पॉन्स कोड लेबल के जवाब में मिलता है: एचटीटीपी रिस्पॉन्स कोड, एचटीटीपी रिस्पॉन्स कोड क्लास, जीआरपीसी स्टेटस कोड. gRPC स्टेटस कोड, gRPC अनुरोधों के लिए gRPC रिस्पॉन्स कोड या एचटीटीपी अनुरोधों के लिए gRPC के बराबर का कोड होता है.

एपीआई से मिली जानकारी में दिखाए गए रिस्पॉन्स कोड मॉनिटरिंग को रिपोर्ट किए गए रिस्पॉन्स कोड
Maps API का स्टेटस एचटीटीपी रिस्पॉन्स कोड एचटीटीपी रिस्पॉन्स कोड एचटीटीपी रिस्पॉन्स कोड क्लास gRPC स्टेटस कोड
ठीक है 200,
204,
302		 200,
204,
302		 2xx,
3xx		 0 (ठीक है)
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS		 200 200, 404(1) 2xx,
4xx(1)		 5 (नहीं मिला)(1)
INVALID_REQUEST (अमान्य पैरामीटर वैल्यू),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
वगैरह.		 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
INVALID_REQUEST (अमान्य/पैरामीटर मौजूद नहीं है, अनुरोध पार्स करने में गड़बड़ी) 200,
400		 400 4xx 3 (INVALID_ARGUMENT)
REQUEST_DENIED 200, 403,
200, 400		 403,
401(1)		 4xx(1) 7 (PERMISSION_DENIED),
16 (UNAUTHENTICATED)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded 		200,
403,
429		 429(1) 4xx(1) 8 (RESOURCE_EXHAUSTED)
UNKNOWN_ERROR 200, 500,
503		 500(1),
503		 5xx(1) 2 (UNKNOWN)/13 (INTERNAL)(1),
14 (UNAVAILABLE)
1 गड़बड़ी के कोड की रिपोर्टिंग को बेहतर बनाने के लिए, Google Maps Platform एपीआई को माइग्रेट किया जा रहा है: 1) Maps API के स्टेटस DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status के लिए, एचटीटीपी रिस्पॉन्स कोड/क्लास 200/2xx से 404/4xx पर (और GRPC स्टेटस कोड को 0 (OK) से 5 (NOT_FOUND) पर), 2) Maps API के स्टेटस REQUEST_DENIED के लिए, एचटीटीपी रिस्पॉन्स कोड/क्लास 200/2xx,400/4xx से 403/4xx पर (और GRPC स्टेटस कोड को 7 (PERMISSION_DENIED) पर), 3) Maps API के स्टेटस REQUEST_DENIED के लिए, एचटीटीपी रिस्पॉन्स कोड/क्लास 200/2xx,403/4xx से 401/4xx पर (GRPC स्टेटस कोड को 16 (UNAUTHENTICATED) पर), 4) Maps API के स्टेटस OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded के लिए, एचटीटीपी रिस्पॉन्स कोड/क्लास 200/2xx,403/4xx से 429/4xx पर, 5) Maps API के स्टेटस UNKNOWN_ERROR के लिए, एचटीटीपी रिस्पॉन्स कोड/क्लास 200/2xx से 500/5xx पर (और GRPC स्टेटस कोड को 2 (UNKNOWN), 13 (INTERNAL) पर). ट्रांज़िशन की अवधि के दौरान, दोनों रिस्पॉन्स कोड देखे जा सकते हैं. Maps API से मिले जवाबों में मौजूद रिस्पॉन्स कोड नहीं बदल रहे हैं. मेट्रिक एक्सप्लोरर में जाकर, समय के हिसाब से रिपोर्ट किए गए रिस्पॉन्स कोड का ब्रेकडाउन देखा जा सकता है.

सूचनाएं बनाएं

अलर्ट की सुविधा से, आपको अपने ऐप्लिकेशन में आने वाली समस्याओं की जानकारी समय पर मिलती है. इससे आपको समस्याओं को तुरंत हल करने में मदद मिलती है. Cloud Monitoring में, सूचना देने की नीति से पता चलता है कि आपको किन स्थितियों में और कैसे सूचना दी जाए.

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

  • जब किसी एपीआई के लिए अनुरोधों की संख्या, हर पांच मिनट में 1,000 से ज़्यादा हो जाए, तो मुझे सूचना दें.
  • जब तीन या इससे ज़्यादा एपीआई के लिए, एचटीटीपी 200 रिस्पॉन्स का 90वां पर्सेंटाइल 100 मिलीसेकंड की इंतज़ार की अवधि से ज़्यादा हो, तब ऑन-कॉल टीम को सूचना दें.

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

सूचना की परिभाषा का स्क्रीनशॉट. इसमें सभी Maps API के लिए, एपीआई अनुरोधों की संख्या को अलग-अलग लाइनों के तौर पर दिखाया गया है. साथ ही, सूचना की थ्रेशोल्ड को हॉरिज़ॉन्टल लाइन के तौर पर दिखाया गया है.

इस इमेज में:

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

जब चेतावनी देने वाली नीति की शर्तें पूरी हो जाती हैं, तो Cloud Monitoring एक घटना खोलता है और सूचनाएं जारी करता है:

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

सूचनाओं के टाइप

Cloud Monitoring में कई तरह की सूचनाएं मिलती हैं. उदाहरण के लिए, ये तय किए जा सकते हैं:

  • मेट्रिक थ्रेशोल्ड की सूचनाएं: अगर कोई मेट्रिक किसी खास समयावधि के लिए, किसी वैल्यू से ऊपर या नीचे जाती है या कोई मेट्रिक पहले से तय प्रतिशत के हिसाब से बढ़ती या घटती है, तो सूचना ट्रिगर करें.
  • बजट से जुड़ी सूचनाएं: थ्रेशोल्ड के नियम सेट करें, ताकि आपकी लागत (असल लागत या अनुमानित लागत) आपके बजट के तय प्रतिशत से ज़्यादा होने पर सूचनाएं ट्रिगर हों. यह प्रतिशत, आपके सेट किए गए नियमों के आधार पर तय होता है. यह सूचना, एपीआई के इस्तेमाल को सीमित नहीं करती. यह आपको सिर्फ़ तब सूचना देती है, जब आपका खर्च, तय की गई रकम के करीब पहुंच जाता है.
  • कोटे से जुड़ी सूचनाएं: Google Cloud, अलग-अलग कोटे तय करता है. इनका इस्तेमाल करके, किसी प्रोजेक्ट या संगठन के इस्तेमाल किए गए संसाधनों को ट्रैक और सीमित किया जा सकता है. जब आपका इस्तेमाल, कोटे की सीमा के करीब पहुंच जाए, तब सूचनाएं भेजने के लिए चेतावनियों का इस्तेमाल करें.

ज़्यादा जानकारी के लिए, चेतावनी देने वाली नीतियों के टाइप देखें.

सूचना देने से जुड़ी नीतियां मैनेज करना

Cloud Console या Cloud Monitoring API का इस्तेमाल करके, अपने प्रोजेक्ट में चेतावनी देने वाली नीति जोड़ी जा सकती है. अपने प्रोजेक्ट की मेट्रिक पर आधारित सूचना देने वाली नीतियों की सूची देखने और उनमें बदलाव करने का तरीका जानने के लिए, यहां दी गई जानकारी देखें:

एक अलर्ट बनाएं

कोई सूचना बनाते समय:

  • मेट्रिक डेटा के आधार पर, सूचनाएं ट्रिगर करने वाली शर्तें तय करें.
  • सूचनाएं भेजने के लिए चैनल तय करें.

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

सूचना बनाने के लिए, यह तरीका अपनाएं:

  1. Cloud Console में, Monitoring को चुनें:

    'मॉनिटर करें' पर जाएं

  2. सूचनाएं को चुनें.
  3. सूचना चैनल में बदलाव करें को चुनें, ताकि यह तय किया जा सके कि सूचना कैसे जारी की जाए. इस उदाहरण में, आपको अपने ईमेल पते का इस्तेमाल करना होगा.
    1. ईमेल चैनल के लिए, नया जोड़ें को चुनें.
    2. ईमेल पता और डिसप्ले नेम डालें.
    3. सेव करें को चुनें.
  4. सूचनाएं को चुनें.
  5. नीति बनाएं को चुनें.
  6. कोई समयावधि चुनें, जैसे कि सात दिन.
  7. सूचना पाने की शर्तें में जाकर, नई शर्त चुनें:
    1. कोई मेट्रिक चुनें पर क्लिक करें. इसके बाद, संसाधन के तौर पर इस्तेमाल किया गया एपीआई और मेट्रिक के तौर पर अनुरोध की संख्या चुनें. इसके बाद, लागू करें को चुनें.
    2. (ज़रूरी नहीं) चार्ट के नीचे, सेवा, quota_metrics, एपीआई तरीका, और मेट्रिक वैल्यू की सूची दी गई है. इस जानकारी के आधार पर डेटा को फ़िल्टर करने के लिए, फ़िल्टर जोड़ें को चुनें. उदाहरण के लिए, फ़िल्टर का इस्तेमाल करके यह तय किया जा सकता है कि चेतावनी ट्रिगर करने के लिए, तरीका, google.places.Autocomplete.http के बराबर होना चाहिए.
    3. डेटा ट्रांसफ़ॉर्म करें में जाकर, रोलिंग विंडो के लिए 5 मिनट और रोलिंग विंडो फ़ंक्शन के लिए मीन चुनें.
    4. आगे बढ़ें को चुनें.
  8. सूचना ट्रिगर को कॉन्फ़िगर करें में जाकर, थ्रेशोल्ड वैल्यू को 2 पर सेट करें. इससे यह तय होगा कि पांच मिनट की विंडो में दो से ज़्यादा अनुरोध होने पर सूचना ट्रिगर हो. ध्यान दें कि चार्ट में अब लाल लाइन दिख रही है. यह लाइन, चुनी गई समयावधि के लिए सूचना की सीमा दिखाती है. चार्ट से यह देखा जा सकता है कि सूचना कहां ट्रिगर हुई होगी. इस चार्ट का इस्तेमाल करके, ज़रूरत के हिसाब से सीमा में बदलाव किया जा सकता है.
  9. आगे बढ़ें पर क्लिक करें.
  10. सूचनाएं कॉन्फ़िगर करें और सूचना को फ़ाइनल करें पेज पर:
    1. सूचना चैनल के लिए बनाया गया ईमेल पता चुनें.
    2. सूचना को नाम दें में जाकर, मेरी टेस्ट सूचना डालें.
    3. नीति बनाएं को चुनें.
  11. कुछ एपीआई अनुरोध करें. यह पक्का करें कि आपने पांच मिनट के अंदर दो से ज़्यादा एपीआई अनुरोध किए हों, ताकि सूचना वाला ईमेल जनरेट हो सके.
  12. सूचना मिलने के बाद, सूचना पेज पर जाएं.
    1. सूचनाओं की सूची वाली टेबल में, ज़्यादा जानकारी देखने के लिए सूचना पर क्लिक करें.
    2. सूचना के बारे में जानकारी देखने के लिए, सूचना के नाम पर क्लिक करें. इसमें एक चार्ट भी शामिल है, जो सूचना को ट्रिगर करने वाले इवेंट को दिखाता है.

अलर्ट के बारे में ज़्यादा जानने के लिए, ये लेख पढ़ें: