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 दिनों तक सेव करके रखा जाता है. इसके बाद, उन्हें मिटाने के लिए शेड्यूल किया जाता है. मांग पर, लॉग एक्सप्लोरर इंटरफ़ेस का इस्तेमाल करके भी एंट्री मिटाई जा सकती हैं.

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

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. लॉग कंट्रोल इनजेस्ट करने की सुविधा ड्रॉपडाउन सूची में, सभी चुनें.

लॉग शामिल न करने की सुविधा

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

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

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

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

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

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

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

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