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

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

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

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

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

Cloud Logging पर जाएं

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

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

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

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

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

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

Cloud-to-cloud प्रोजेक्ट, Cloud Logging में इन इवेंट के साथ काम करते हैं:

Cloud Logging संसाधन	इवेंट
Google Assistant ऐक्शन प्रोजेक्ट	SYNC इंटेंट से जुड़ी गड़बड़ियां
	QUERY इंटेंट से जुड़ी गड़बड़ियां
	EXECUTE इंटेंट से जुड़ी गड़बड़ियां
	सूचनाएं गड़बड़ियां
	खाता लिंक करने से जुड़ी गड़बड़ियां
	लोकल होम एसडीके 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 console पर जाएं

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

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

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

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

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

इस गाइड में, एक्सक्लूज़न फ़िल्टर बनाने का तरीका बताया गया है. _Default सिंक के लिए एक्सक्लूज़न फ़िल्टर कॉन्फ़िगर करें.

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

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

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

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

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

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