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

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

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

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

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

Cloud Logging पर जाएं

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

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

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

Cloud Logging से इस तरह के संसाधन मिलते हैं:

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

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

Cloud-to-cloud प्रोजेक्ट, क्लाउड में लॉग इन करने के दौरान इन इवेंट के साथ काम करते हैं:

क्लाउड लॉगिंग संसाधन इवेंट
Google Assistant ऐक्शन प्रोजेक्ट सिंक इंटेंट से जुड़ी गड़बड़ियां
QUERY इंटेंट से जुड़ी गड़बड़ियां
इंटेंट से जुड़ी EXECUTE गड़बड़ियां
सूचनाओं से जुड़ी गड़बड़ियां
खाता लिंक करने से जुड़ी गड़बड़ियां
लोकल होम SDK टूल हैंडलर गड़बड़ी

लॉग सिंक करें

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

प्रॉपर्टी ब्यौरा
requestId स्मार्ट होम इंटेंट अनुरोध आईडी.
httpLatencyMsec जवाब मिलने में काफ़ी समय बीत चुका है.
status यह इंटेंट के जवाब का स्टेटस दिखाता है.

एक्ज़ीक्यूशन लॉग

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

प्रॉपर्टी ब्यौरा
requestId यूनीक अनुरोध आईडी, जैसे कि 5325511189174727525.
latencyMsec जवाब मिलने से पहले बीत चुका समय. उदाहरण के लिए, 6000.
executionType अनुरोध के लिए इस्तेमाल किया गया ट्रांसपोर्ट, जैसे कि CLOUD या MATTER. यह आपके इंटिग्रेशन के हिसाब से तय होता है.
actionType इस बात की जानकारी देना ज़रूरी नहीं है कि उपयोगकर्ता ने क्या कार्रवाई की है, जैसे कि QUERY या EXECUTE. EXECUTE कार्रवाइयों के लिए, इसमें इस्तेमाल किए जा सकने वाले Trait को पूरा करने के लिए जारी किया गया निर्देश शामिल है. उदाहरण के लिए, 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 सिंक के लिए, एक्सक्लूज़न फ़िल्टर कॉन्फ़िगर करें).

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

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

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

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

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