Google Home नेटवर्क के लिए क्लाउड लॉगिंग

क्लाउड-टू-क्लाउड    Matter

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

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

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

Cloud Logging पर जाएं

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

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

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

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 इंटेंट से जुड़ी गड़बड़ियां
	Notifications 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 भी करता है, ताकि क्वेरी बनाने में आपकी मदद की जा सके.

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

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

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

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

इसी विषय से जुड़े लिंक

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

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