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

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

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

लॉगिंग ऐक्सेस करना

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

पर जाएंCloud Logging

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

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

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

Cloud Logging इन संसाधन टाइप की सुविधा देता है:

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

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

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

Cloud Logging का संसाधन इवेंट
Google Assistant का Actions प्रोजेक्ट 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` शामिल होता है.ERRORerrorCode
externalDebugString इस उपयोगकर्ता की कार्रवाई से जुड़ा, डीबग करने वाला वैकल्पिक मैसेज.
locale अनुरोध से जुड़ा भाषा कोड.

सूचनाओं से जुड़े लॉग

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

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

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

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

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

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

    Actions on Google Console पर जाएं

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

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

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

लॉग को बाहर रखना

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

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

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

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

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

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

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