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 प्रोजेक्ट, CloudLogging में इन इवेंट के साथ काम करते हैं:

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

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