क्लाउड-टू-क्लाउड के लिए Cloud Logging

अपने इंटिग्रेशन के लिए इवेंट लॉग, Google Cloud Logging से ऐक्सेस किए जा सकते हैं. Cloud Logging का इस्तेमाल करके, लॉग एक्सप्लोर करें, मेट्रिक और सूचनाएं बनाएं या Google Cloud Pub/Sub का इस्तेमाल करके, लॉग को दूसरे ऐप्लिकेशन पर एक्सपोर्ट करें.

ऐक्सेस लॉगिंग

Google Cloud Console से Cloud Logging को ऐक्सेस करने के लिए, सभी प्रॉडक्ट देखें पर क्लिक करें. इसके बाद, ऑपरेशन > लॉगिंग पर जाएं.

Cloud Logging पर जाएं

आपके Actions प्रोजेक्ट के उपयोगकर्ताओं के लिए, लॉगिंग डेटा का ऐक्सेस, Identity and Access Management (IAM) के ज़रिए मैनेज किया जाता है. लॉगिंग डेटा के लिए भूमिकाओं और अनुमतियों के बारे में ज़्यादा जानने के लिए, Cloud Logging का ऐक्सेस कंट्रोल लेख पढ़ें.

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

समस्या हल करने की गाइड के 'लॉग खोजना' सेक्शन में जाकर, लॉग का असरदार तरीके से इस्तेमाल करने के बारे में ज़्यादा जानें.

Cloud Logging में ये रिसॉर्स टाइप उपलब्ध हैं:

संसाधन किस तरह का है डिसप्ले नाम ब्यौरा लेबल
assistant_action_project Google Assistant का ऐक्शन प्रोजेक्ट यह Assistant ऐक्शन से जुड़े Google Cloud प्रोजेक्ट के लिए कंटेनर है.
  • project_id: आपके मौजूदा प्रोजेक्ट का आइडेंटिफ़ायर, जो इस संसाधन से जुड़ा है. उदाहरण के लिए, my-project.

गतिविधियों का ब्यौरा

Cloud-to-cloud प्रोजेक्ट में, Cloud Logging में मौजूद इन इवेंट का इस्तेमाल किया जा सकता है:

Cloud Logging संसाधन इवेंट
Google Assistant का ऐक्शन प्रोजेक्ट SYNC इंटेंट से जुड़ी गड़बड़ियां
QUERY इंटेंट से जुड़ी गड़बड़ियां
EXECUTE इंटेंट से जुड़ी गड़बड़ियां
सूचनाएं errors
खाता लिंक करने से जुड़ी गड़बड़ियां
Local Home SDK HandlerError

लॉग सिंक करना

नीचे दी गई टेबल में, syncLog एंट्री का स्कीमा दिया गया है:

प्रॉपर्टी ब्यौरा
requestId स्मार्ट होम इंटेंट के अनुरोध का आईडी.
httpLatencyMsec जवाब मिलने से पहले बीता हुआ समय.
status इससे इंटेंट के जवाब की स्थिति के बारे में पता चलता है.

ऑटोमेशन लागू होने के लॉग

नीचे दी गई टेबल में, executionLog एंट्री का स्कीमा दिया गया है:

प्रॉपर्टी ब्यौरा
requestId अनुरोध का यूनीक आईडी. उदाहरण के लिए, 5325511189174727525.
latencyMsec जवाब मिलने में लगा समय. उदाहरण के लिए, 6000.
executionType अनुरोध के लिए इस्तेमाल किया गया ट्रांसपोर्ट, जैसे कि आपके इंटिग्रेशन के हिसाब से CLOUD या MATTER.
actionType उपयोगकर्ता की ओर से की गई कार्रवाई का वैकल्पिक इंडिकेटर. उदाहरण के लिए, QUERY या EXECUTE. EXECUTE कार्रवाइयों के लिए, इसमें उन सुविधाओं के लिए ऑर्डर पूरा करने से जुड़ी कमांड शामिल होती है जिनके लिए यह सुविधा उपलब्ध है. उदाहरण के लिए, ONOFF_OFF
trait यह इस उपयोगकर्ता की कार्रवाई से जुड़ी वैकल्पिक विशेषता है.
deviceTypes इवेंट से प्रभावित डिवाइस टाइप की सूची. उदाहरण के लिए, LIGHT.
isSuccess अनुरोध का जवाब मिला या नहीं.
fallbackToCloud क्या स्थानीय तौर पर ऑर्डर पूरा करने में हुई गड़बड़ी के बाद, अनुरोध को क्लाउड फ़ुलफ़िलमेंट पर रीडायरेक्ट किया गया है.
statusType यह इंटेंट रिस्पॉन्स का स्टेटस दिखाता है. जैसे, SUCCESS, PENDING या OFFLINE. ERROR जवाबों के लिए, इस प्रॉपर्टी में फ़ुलफ़िलमेंट से मिला errorCode शामिल होता है.
externalDebugString इस उपयोगकर्ता की कार्रवाई से जुड़ा, डीबग करने के लिए ज़्यादा जानकारी वाला मैसेज. यह मैसेज देना ज़रूरी नहीं है.
locale अनुरोध से जुड़ा भाषा कोड.

सूचना लॉग

नीचे दी गई टेबल में, notificationLog एंट्री का स्कीमा दिया गया है:

प्रॉपर्टी ब्यौरा
requestId सूचना पाने के अनुरोध का आईडी.
structName सूचना स्ट्रक्चर का नाम, जैसे कि "ObjectDetection".
status इससे सूचना की स्थिति के बारे में पता चलता है.

लॉग लेवल की सेटिंग

Cloud-to-cloud प्रोजेक्ट के लिए, गड़बड़ी के लॉग पाने की सुविधा डिफ़ॉल्ट रूप से चालू होती है. हालांकि, डेवलपर के पास सफलता के लॉग पाने की सुविधा चालू करने का विकल्प भी होता है. यह सुविधा, डेवलपमेंट के दौरान खास तौर पर तब काम आती है, जब आपको कुछ एजेंट से सभी लॉग कैप्चर करने हों. अगर आपने लॉगिंग कोटा से ज़्यादा का इस्तेमाल किया है, तो आपके प्रोजेक्ट पर अतिरिक्त शुल्क लग सकता है.

अपने प्रोजेक्ट के लिए लॉग लेवल को कंट्रोल करने के लिए, यह तरीका अपनाएं:

  1. Actions on Google Console में, प्रोजेक्ट पेज पर जाएं.

    Actions on Google कंसोल पर जाएं

  2. अपना स्मार्ट होम प्रोजेक्ट चुनें.

  3. डेवलप करें टैब चुनें. इसके बाद, साइड बार में मौजूद कार्रवाइयां पर क्लिक करें.

  4. लॉग कंट्रोल करने की सुविधा ड्रॉपडाउन सूची में, सभी चुनें.

लॉग एक्सक्लूज़न

डेवलपर, लॉगिंग क्वेरी लैंग्वेज का इस्तेमाल करके लॉग एक्सक्लूज़न बना सकते हैं. इससे वे अपने लॉग को ज़्यादा बेहतर तरीके से पसंद के मुताबिक बना सकते हैं. लॉगिंग क्वेरी लैंग्वेज का इस्तेमाल Logs Explorer भी करता है. इसलिए, क्वेरी बनाने के लिए Logs Explorer का इस्तेमाल किया जा सकता है.

अपवर्जन फ़िल्टर बनाने के लिए, इस गाइड में दिया गया तरीका अपनाएं. _Default सिंक के लिए अपवर्जन फ़िल्टर कॉन्फ़िगर करें.

लॉग पर आधारित मेट्रिक

डेवलपर, लॉग पर आधारित मेट्रिक का इस्तेमाल करके, अपने लॉग में पैटर्न को ट्रैक और उनका विश्लेषण कर सकते हैं. लॉग पर आधारित मेट्रिक के लिए, कस्टम चार्ट बनाए जा सकते हैं. साथ ही, सूचनाएं सेट अप की जा सकती हैं.

स्मार्ट होम के लिए, लॉग पर आधारित मेट्रिक का इस्तेमाल शुरू करने के लिए, काउंटर लॉग पर आधारित मेट्रिक बनाने से जुड़ी गाइड देखें.

अपने प्रोजेक्ट में Cloud Logging का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, यहां दिया गया दस्तावेज़ देखें:

  • कीमत: अलॉटमेंट और अतिरिक्त इस्तेमाल के शुल्क की जानकारी.
  • कोटा और सीमाएं: इस्तेमाल की जानकारी को लॉग करने से जुड़ी सीमाओं और रखरखाव की नीतियों के बारे में जानकारी.
  • लॉग से जुड़ी बेहतर क्वेरी: लॉग डेटा को क्वेरी करने और उसका विश्लेषण करने के लिए, बेहतर एक्सप्रेशन इस्तेमाल करने के बारे में गाइड.