Matter इंटिग्रेशन की गड़बड़ियों को हल करना

refresh_date: 2023-01-06

Google Cloud आपको ऐसे टूल उपलब्ध कराता है जिनकी मदद से, Google Cloud Monitoring की मदद से अपने प्रोजेक्ट की भरोसेमंदता को मॉनिटर किया जा सकता है. साथ ही, Google Cloud Logging गड़बड़ी के लॉग की मदद से समस्याओं को डीबग किया जा सकता है. जब भी उपयोगकर्ता के अनुरोध पूरे नहीं किए जा पाते हैं, तब Google Home Analytics पाइपलाइन आपकी मेट्रिक में उस गड़बड़ी को रिकॉर्ड करती है. साथ ही, आपके प्रोजेक्ट के लॉग में गड़बड़ी का लॉग पब्लिश करती है.

गड़बड़ियों को ठीक करने के लिए, ये दो तरीके अपनाएं:

  1. स्मार्ट होम मेट्रिक की मदद से, अपने प्रोजेक्ट की स्थिति को मॉनिटर करें.
  2. गड़बड़ी के लॉग में, गड़बड़ी की पूरी जानकारी देखकर समस्याओं की जांच करें.

गड़बड़ियों को मॉनिटर करना

अपने प्रोजेक्ट की मेट्रिक ऐक्सेस करने के लिए, Google Cloud Monitoring dashboards का इस्तेमाल करें. यहां कुछ मुख्य चार्ट दिए गए हैं. ये चार्ट, क्वालिटी को मॉनिटर करने और डीबग करने के लिए खास तौर पर फ़ायदेमंद होते हैं:

  • सक्सेस रेट चार्ट, प्रोजेक्ट की विश्वसनीयता को मॉनिटर करते समय सबसे पहले दिखता है. इस चार्ट में गिरावट से पता चल सकता है कि आपके उपयोगकर्ता आधार के कुछ या सभी हिस्सों के लिए, सेवा बंद है. हमारा सुझाव है कि अपने प्रोजेक्ट में हर बदलाव या अपडेट के बाद, इस चार्ट को ध्यान से देखें, ताकि किसी भी अनियमितता का पता लगाया जा सके.
  • गड़बड़ी की जानकारी वाले चार्ट, इंटिग्रेशन से जुड़ी समस्याओं को हल करने के लिए सबसे ज़्यादा मददगार होते हैं. सफलता के प्रतिशत वाले चार्ट में हाइलाइट की गई हर गड़बड़ी के लिए, गड़बड़ी के ब्यौरे में गड़बड़ी का कोड दिखता है. नीचे दी गई टेबल में, Google Home platform की ओर से फ़्लैग की गई गड़बड़ियां और उन्हें ठीक करने का तरीका देखा जा सकता है.

प्लैटफ़ॉर्म से जुड़ी गड़बड़ियों के सामान्य कोड

यहां कुछ सामान्य गड़बड़ी कोड दिए गए हैं. ये कोड, आपको अपने प्रोजेक्ट के लॉग में दिख सकते हैं. इनसे Google Home platform की ओर से पकड़ी गई समस्याओं की पहचान की जा सकती है. समस्या हल करने से जुड़ी जानकारी के लिए, यहां दी गई टेबल देखें. गड़बड़ी के कोड की पूरी सूची देखने के लिए, गड़बड़ियां और अपवाद देखें.

गड़बड़ी कोड ब्यौरा आपके लिए ज़रूरी स्टेप
ACTION_NOT_AVAILABLE यह कमांड, डिवाइस की मौजूदा स्थिति के लिए मान्य नहीं है. उदाहरण के लिए, डिवाइस बंद होने पर "तापमान सेट करो" कमांड देना.

अपने फ़ुलफ़िलमेंट में, डिवाइस की विशेषताओं और मौजूदा स्थिति के लॉजिक की पुष्टि करें.
हां
AGENT_ISSUE पार्टनर के क्लाउड एजेंट में कोई सामान्य समस्या हुई है.

फ़ुलफ़िलमेंट लॉग में, ऐसे अपवाद या क्रैश की जांच करें जिन्हें हैंडल नहीं किया गया है.
हां
AGENT_UNAVAILABLE_ERROR Google, पार्टनर के फ़ुलफ़िलमेंट यूआरएल तक नहीं पहुंच सका.

पक्का करें कि आपका सर्वर ऑनलाइन हो, फ़ायरवॉल Google को ब्लॉक न कर रहा हो, और यूआरएल सही हो.
हां
APP_LAUNCH_FAILED चुने गए डिवाइस पर तीसरे पक्ष का ऐप्लिकेशन लॉन्च नहीं किया जा सका.

appId की पुष्टि करें. साथ ही, यह पुष्टि करें कि ऐप्लिकेशन, टारगेट किए गए हार्डवेयर पर काम करता हो.
हां
AUTH_EXPIRED OAuth ऐक्सेस टोकन की समयसीमा खत्म हो गई है और इसे रीफ़्रेश नहीं किया जा सकता.

रिफ़्रेश टोकन रोटेशन की जांच करें और पक्का करें कि उपयोगकर्ता ने ऐक्सेस वापस न लिया हो.
हां
BACKEND_FAILURE_URL_TIMEOUT आपकी सेवा तक पहुंचने के दौरान, Google के अनुरोध का समय खत्म हो गया.

पुष्टि करें कि आपकी सेवा ऑनलाइन है, कनेक्शन स्वीकार कर रही है, और उसकी क्षमता से ज़्यादा इस्तेमाल नहीं किया जा रहा है. इसके अलावा, यह भी पुष्टि करें कि टारगेट डिवाइस चालू हो, इंटरनेट से कनेक्ट हो, और सिंक किया गया हो.
BACKEND_FAILURE_URL_UNREACHABLE Google को आपकी सेवा से एचटीटीपी 5xx गड़बड़ी का कोड मिला है.

Google Cloud Logging में requestId का इस्तेमाल करके, स्मार्ट होम सेवा के लॉग देखें. सर्वर क्रैश होने, टाइमआउट होने या 502/503 गेटवे से जुड़ी गड़बड़ियों की जांच करें.
CHANNEL_SWITCH_FAILED डिवाइस, अनुरोध किए गए मीडिया चैनल पर स्विच नहीं कर सका.

उपयोगकर्ता के लिए, चैनल के नाम/नंबर और सदस्यता की स्थिति की पुष्टि करें.
हां
CHARGER_ISSUE डिवाइस, चार्जिंग सिस्टम में हार्डवेयर से जुड़ी समस्या की सूचना देता है.

पार्टनर को हार्डवेयर-लेवल की टेलीमेट्री और बैटरी की परफ़ॉर्मेंस की जांच करनी चाहिए.
हां
CHECK_PARTNER_APP इस गड़बड़ी को ठीक करने के लिए, उपयोगकर्ता को पार्टनर का ऐप्लिकेशन खोलना होगा.

इस कोड का इस्तेमाल उन गड़बड़ियों के लिए करें जिनके लिए यूज़र इंटरफ़ेस (यूआई) के साथ जटिल इंटरैक्शन की ज़रूरत होती है. उदाहरण के लिए, फ़र्मवेयर अपडेट.
हां
COMMAND_FAILED किसी कमांड को पूरा करते समय कोई सामान्य गड़बड़ी हुई.

requestId से जुड़ी समस्या की वजह जानने के लिए, फ़ुलफ़िलमेंट लॉग देखें.
हां
COMMAND_INSERT_FAILED Google, डिवाइस के लिए दिए गए निर्देश को प्रोसेस नहीं कर सका या उसे लाइन में नहीं लगा सका.

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

पक्का करें कि आपका बैकएंड, होम ग्राफ़ को हमेशा सिंक करके रखता हो. डिवाइसों को जोड़ने या हटाने पर, requestSync को कॉल करें.
हां
ERROR_STATUS जवाब में, कोड के बिना "ERROR" स्टेटस दिखाया गया है.

उपयोगकर्ता के टीटीएस और डैशबोर्ड के डेटा को बेहतर बनाने के लिए, हमेशा एक खास errorCode स्ट्रिंग शामिल करें.
हां
EXECUTION_BACKEND_FAILURE_URL_ERROR Google को आपके फ़ुलफ़िलमेंट से, 401 के अलावा कोई और एचटीटीपी 4xx गड़बड़ी मिली है.

403, 404 या 400 रिस्पॉन्स के लिए, अपने वेब सर्वर लॉग देखें.
हां
EXECUTION_BACKEND_FAILURE_URL_ROBOTED फ़ुलफ़िलमेंट यूआरएल को robots.txt या सुरक्षा फ़िल्टर ने ब्लॉक किया है.

पक्का करें कि Google के क्रॉलर/सेवाएं, आपके फ़ुलफ़िलमेंट एंडपॉइंट को ऐक्सेस कर सकती हों.
हां
EXECUTION_BACKEND_FAILURE_URL_UNREACHABLE Google को आपकी फ़ुलफ़िलमेंट सेवा से एचटीटीपी 5xx गड़बड़ी मिली है.

पक्का करें कि एंडपॉइंट यूआरएल सेवा स्थिर हो, सही हो, और सभी के लिए उपलब्ध हो. साथ ही, सेवा चालू हो. स्वास्थ्य की जांच करने और फिर से कोशिश करने की सुविधा जोड़ें. सर्वर क्रैश होने, टाइमआउट होने या 502/503 गेटवे से जुड़ी गड़बड़ियों की जांच करें.
हां
EXECUTION_BAILOUT_INVALID_RESPONSE JSON रिस्पॉन्स इतना खराब था कि उसे प्रोसेस नहीं किया जा सका.

JSON वैलिडेटर का इस्तेमाल करके पक्का करें कि आपका जवाब, इंटेंट स्कीमा का पूरी तरह से पालन करता हो.
हां
EXECUTION_GAL_BAD_3P_RESPONSE टोकन रिस्पॉन्स में अमान्य फ़ॉर्मैट की वजह से, खाता लिंक नहीं किया जा सका.

पुष्टि करें कि आपके OAuth सर्वर के जवाब का फ़ॉर्मैट, Google की ज़रूरी शर्तों के मुताबिक हो.
हां
EXECUTION_GAL_INSUFFICIENT_CAPABILITIES उपयोगकर्ता के खाते के पास यह कार्रवाई करने के लिए ज़रूरी अनुमतियां नहीं हैं.

OAuth के दौरान अनुरोध किए गए स्कोप की जांच करें और पक्का करें कि वे ज़रूरी ट्रेट से मेल खाते हों.
हां
EXECUTION_GAL_MAYBE_UNLINKED_BY_3P पार्टनर क्लाउड से पता चलता है कि उपयोगकर्ता ने अपना खाता अनलिंक कर दिया है.

पक्का करें कि आपकी agentUserId मैपिंग स्थिर हो और उसे हटाया न गया हो.
हां
EXECUTION_GAL_READ_ONLY_MODE_FOR_3P पार्टनर के प्लैटफ़ॉर्म पर इंटिग्रेशन, सिर्फ़ पढ़ने वाले मोड में है.

देखें कि उपयोगकर्ता का खाता निलंबित तो नहीं है या "सिर्फ़ देखें" मोड में तो नहीं है.
हां
EXECUTION_GAL_UNLINKED_BY_3P तीसरे पक्ष की सेवा ने खाते को पहले से ही अनलिंक कर दिया हो.

जांच करें कि उपयोगकर्ता का कनेक्शन क्यों टूटा. उदाहरण के लिए, सुरक्षा रीसेट. पक्का करें कि पार्टनर का OAuth सर्वर, Google के refresh_token अनुरोधों का सही तरीके से जवाब देता हो, ताकि नए ऐक्सेस टोकन आसानी से जारी किए जा सकें.
हां
EXECUTION_INVALID_JSON Google, JSON रिस्पॉन्स पेलोड को पार्स नहीं कर सका.

जवाब में सिंटैक्स से जुड़ी गड़बड़ियों, ब्रैकेट के न होने या अमान्य वर्णों की जांच करें.
हां
FAULTY_BATTERY डिवाइस के हार्डवेयर से पता चलता है कि बैटरी खराब हो गई है या खत्म हो गई है.

उपयोगकर्ता को टीटीएस या ऐप्लिकेशन का इस्तेमाल करके, बैटरी बदलने के लिए निर्देश दें.
हां
FUNCTION_NOT_SUPPORTED अनुरोध किया गया मोड या फ़ंक्शन, डिवाइस पर काम नहीं करता.

पक्का करें कि SYNC से मिले जवाब में, डिवाइस की क्षमताओं के बारे में सटीक जानकारी दी गई हो.
HARD_ERROR यह ऐसी समस्या है जो कुछ समय के लिए नहीं है. इसे मैन्युअल तरीके से ठीक करना होगा.

इस विकल्प का इस्तेमाल तब करें, जब हार्डवेयर में हमेशा के लिए खराबी आ गई हो या खाते को वापस नहीं लाया जा सकता हो.
हां
INVALID_AUTH_TOKEN Google को आपकी सेवा से एचटीटीपी 401 गड़बड़ी कोड मिला है.

ऐक्सेस टोकन की समयसीमा खत्म नहीं हुई है, लेकिन आपकी सेवा ने इसे अमान्य कर दिया है. Google Cloud Logging में मौजूद requestId का इस्तेमाल करके, स्मार्ट होम सेवा के लॉग देखें.
INVALID_JSON जवाब का स्ट्रक्चर अमान्य है. उदाहरण के लिए, ज़रूरी फ़ील्ड मौजूद नहीं हैं.

इरादे के JSON स्कीमा के हिसाब से अपने जवाब की पुष्टि करें.
हां
LOCK_FAILURE स्मार्ट लॉक को अनुरोध की गई स्थिति में नहीं बदला जा सका.

लॉक के हार्डवेयर में किसी तरह की रुकावट, कम पावर या मोटर के खराब होने की जांच करें.
हां
MALFORMED_JSON JSON स्ट्रक्चर में गड़बड़ी है. उदाहरण के लिए, स्ट्रिंग या ऑब्जेक्ट बंद नहीं किए गए हैं.

पक्का करें कि फ़ुलफ़िलमेंट, रिस्पॉन्स को सीरियलाइज़ करने के लिए स्टैंडर्ड JSON लाइब्रेरी का इस्तेमाल करता हो.
हां
MISSING_STATE QUERY रिस्पॉन्स में, डिवाइस की अनुरोध की गई स्थिति शामिल नहीं थी.

पक्का करें कि SYNC में तय की गई सभी सुविधाओं को हर QUERY या EXECUTE जवाब में शामिल किया गया हो. साथ ही, सभी ज़रूरी सुविधाओं की स्थितियां वापस भेजें, भले ही उनमें कोई बदलाव न हुआ हो.
हां
NETWORK_PROFILE_NOT_RECOGNIZED डिवाइस को अनुरोध की गई नेटवर्क प्रोफ़ाइल के बारे में जानकारी नहीं है.

पुष्टि करें कि प्रोफ़ाइल के नाम वाली स्ट्रिंग, SYNC जवाब में दी गई उन प्रोफ़ाइलों से मेल खाती हो जिनके साथ काम किया जा सकता है.
हां
NOT_IMPLEMENTED पार्टनर ने अनुरोध किए गए इंटेंट या ट्रेट को लागू नहीं किया है.

SYNC के जवाब में सिर्फ़ वे सुविधाएं शामिल करें जिन्हें आपने पूरी तरह से लागू किया है.
हां
OAUTH_RECONNECT_CALL_TO_ACTION इससे उपयोगकर्ता को सूचना मिलती है, ताकि वह अपना खाता फिर से लिंक कर सके.

इसका इस्तेमाल तब करें, जब किसी उपयोगकर्ता का सेशन अमान्य हो गया हो और उसे मैन्युअल तरीके से OAuth की पुष्टि फिर से करनी हो.
हां
OPEN_AUTH_FAILURE उपयोगकर्ता का ऐक्सेस टोकन खत्म हो गया है और Google उसे रीफ़्रेश नहीं कर पा रहा है या Google को आपकी सेवा से एचटीटीपी 401 गड़बड़ी का कोड मिला है.

अगर आपको इस कोड के इस्तेमाल में बढ़ोतरी दिखती है, तो देखें कि क्या आपको स्मार्ट होम इंटेंट या रीफ़्रेश टोकन के अनुरोधों से जुड़ी गड़बड़ियों में भी बढ़ोतरी दिख रही है.
PARTNER_RESPONSE_INVALID_ERROR_CODE errorCode स्ट्रिंग, Google की अनुमति वाली सूची में शामिल नहीं है.

अपनी अंदरूनी गड़बड़ियों को गड़बड़ियों की आधिकारिक सूची में मैप करें.
हां
PARTNER_RESPONSE_INVALID_PAYLOAD जवाब में मौजूद payload फ़ील्ड, मान्य JSON ऑब्जेक्ट नहीं है.

फ़ुलफ़िलमेंट के जवाब के रूट स्ट्रक्चर की पुष्टि करें.
हां
PARTNER_RESPONSE_INVALID_STATUS जवाब status की वैल्यू SUCCESS, ERROR या OFFLINE नहीं थी.

पक्का करें कि आपके जवाब में शामिल हर डिवाइस के लिए, स्थिति की मान्य स्ट्रिंग मौजूद हो.
हां
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES जवाब में, अनुरोध की गई सभी कमांड/डिवाइसों के नतीजे शामिल नहीं थे.

Google Home डेवलपर के दस्तावेज़ के हिसाब से, अपने जवाब के स्ट्रक्चर की पुष्टि करें. पक्का करें कि सर्वर में कोई गड़बड़ी होने की वजह से, रिस्पॉन्स को छोटा न किया गया हो या वह खाली न हो. अनुरोध की commands कैटगरी में मौजूद हर आइटम के लिए, जवाब की एक एंट्री होनी चाहिए.
हां
PARTNER_RESPONSE_MISSING_DEVICE Google ने जिस डिवाइस के बारे में जानकारी मांगी थी उसे जवाब में शामिल नहीं किया गया.

पक्का करें कि आपके जवाब में, अनुरोध के पेलोड में दिए गए हर ID की जानकारी शामिल हो.
हां
PARTNER_RESPONSE_MISSING_PAYLOAD जवाब में ज़रूरी payload फ़ील्ड मौजूद नहीं है.

पक्का करें कि आपके टॉप-लेवल JSON ऑब्जेक्ट में payload कुंजी शामिल हो.
हां
PARTNER_RESPONSE_NOT_OBJECT पूरे रिस्पॉन्स को JSON ऑब्जेक्ट के तौर पर पार्स नहीं किया जा सका.

अपने एचटीटीपी रिस्पॉन्स के मुख्य भाग में, आखिर में मौजूद वर्णों या JSON के अलावा किसी अन्य कॉन्टेंट की जांच करें. पक्का करें कि payload.commands[] एक सही JSON ऑब्जेक्ट हो. इसमें आईडी, स्टेटस, और वैकल्पिक स्थितियां शामिल हों.
हां
PROTOCOL_ERROR कम्यूनिकेशन प्रोटोकॉल में कोई गड़बड़ी हुई है.

एचटीटीपी हेडर से जुड़ी समस्याओं या एसएसएल/टीएलएस हैंडशेक से जुड़ी गड़बड़ियों की जांच करें.
हां
RELINK_REQUIRED उपयोगकर्ता को इंटिग्रेशन का इस्तेमाल जारी रखने के लिए, अपने खाते को फिर से लिंक करना होगा.

पक्का करें कि रीफ़्रेश टोकन के हमेशा के लिए अमान्य होने पर, आपका सर्वर यह कोड दिखाए.
हां
REQUEST_ID_NOT_FOUND Google को अनुरोध के लिए इंटरनल ट्रैकिंग आईडी नहीं मिला.

आम तौर पर, यह प्लैटफ़ॉर्म में हुई कोई गड़बड़ी होती है. इस पर नज़र रखें और सहायता टीम से संपर्क करें.
हां
RESOURCE_UNAVAILABLE अनुरोध किया गया संसाधन (डिवाइस या ट्रेट) उपलब्ध नहीं है.

देखें कि डिवाइस "व्यस्त है" या उसे कुछ समय के लिए बंद कर दिया गया है.
हां
RESPONSE_TIMEOUT फ़ुलफ़िलमेंट सेवा, नौ सेकंड के अंदर जवाब नहीं दे पाई.

बैकएंड के इंतज़ार के समय को ऑप्टिमाइज़ करें; धीमी डीबी क्वेरी या रीजनल नेटवर्क लैग की जांच करें.
हां
RESPONSE_UNAVAILABLE पार्टनर के फ़ुलफ़िलमेंट यूआरएल से कोई जवाब नहीं मिला.

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

पार्टनर क्लाउड पर, उपयोगकर्ता के सीन की परफ़ॉर्मेंस की जांच करें.
हां
STREAM_UNPLAYABLE कैमरे की स्ट्रीम शुरू नहीं हो सकी या शुरू नहीं हुई.

WebRTC/HLS सिग्नलिंग की पुष्टि करें और पक्का करें कि स्ट्रीम का यूआरएल मान्य हो.
हां
TIMEOUT इंटेंट को प्रोसेस करते समय, सामान्य टाइम आउट की समस्या हुई.

अपने क्लाउड और डिवाइस हब के बीच, सेवा के टाइमआउट के लिए लॉग देखें.
हां
TRANSIENT_ERROR कुछ समय के लिए होने वाली गड़बड़ी ऐसी गड़बड़ी होती है जो अपने-आप ठीक हो जाती है.

आम तौर पर, ये गड़बड़ियां किसी डिवाइस या सेवा से कनेक्शन के बंद होने के तौर पर दिखती हैं. साथ ही, अगर सर्वर से नए कनेक्शन नहीं खोले जा सकते.
UNABLE_TO_LOCATE_DEVICE लोकेटर ट्रेट का इस्तेमाल करके डिवाइस का पता नहीं लगाया जा सका. उदाहरण के लिए, पिंग नहीं हो सका.

डिवाइस के लोकल कनेक्टिविटी (वाई-फ़ाई/ब्लूटूथ) की जांच करें.
हां
UNABLE_TO_RING_DEVICE डिवाइस तक पहुंचा गया, लेकिन उसमें घंटी/सूचना बजाने की सुविधा चालू नहीं की जा सकी.

हार्डवेयर के सूचना/स्पीकर की स्थिति और वॉल्यूम लेवल की पुष्टि करें.
हां
UNABLE_TO_SILENCE_DEVICE डिवाइस पर बज रही घंटी या सूचना को बंद नहीं किया जा सका.

क्लाउड और फ़िज़िकल डिवाइस के बीच कम्यूनिकेशन में होने वाली गड़बड़ियों की जांच करें.
हां
UNEXPECTED_ERROR_CHECK_DEVICE_APP कोई अप्रत्याशित गड़बड़ी हुई; उपयोगकर्ता को पार्टनर ऐप्लिकेशन की जांच करनी चाहिए.

इस कोड का इस्तेमाल उन गड़बड़ियों के लिए करें जिनके लिए Google के साथ काम करने वाला कोई खास कोड उपलब्ध नहीं है.
हां
UNKNOWN_ERROR यह एक सामान्य गड़बड़ी है. इसके बारे में कोई अतिरिक्त जानकारी नहीं दी गई है.

गड़बड़ी की सही मैपिंग, सुरक्षा से जुड़ी जांच, और लॉगिंग की सुविधा जोड़ें, ताकि गड़बड़ियों के बारे में पता चलने पर, सामान्य कोड के बजाय गड़बड़ी के खास कोड दिखें.
हां
UNLOCK_FAILURE स्मार्ट लॉक, "खुला है" स्थिति पर नहीं पहुंच सका.

हार्डवेयर के जाम होने, बैटरी कम होने या गलत पिन डालने की जांच करें.
हां

खोज लॉग

मेट्रिक का इस्तेमाल करके इंटिग्रेशन की निगरानी करने के बाद, अगला चरण Cloud Logging का इस्तेमाल करके, किसी गड़बड़ी को ठीक करना है. गड़बड़ी का लॉग, JSON जैसी एंट्री होती है. इसमें समय, गड़बड़ी कोड, और स्मार्ट होम इंटेंट से जुड़ी जानकारी जैसे फ़ील्ड होते हैं.

Google Cloud में कई सिस्टम होते हैं, जो आपके प्रोजेक्ट को हर समय लॉग भेजते हैं. आपको अपने लॉग फ़िल्टर करने के लिए क्वेरी लिखनी होंगी और अपनी ज़रूरत के हिसाब से लॉग ढूंढने होंगे. क्वेरी, समयसीमा, संसाधन, लॉग गंभीरता या कस्टम एंट्री के आधार पर की जा सकती हैं.

क्लाउड लॉग क्वेरी करना

कस्टम फ़िल्टर बनाने के लिए, क्वेरी बटन का इस्तेमाल किया जा सकता है.

Cloud Log Queries बनाना

समयसीमा तय करने के लिए, समयसीमा चुनने वाले बटन पर क्लिक करें और दिए गए विकल्पों में से कोई एक विकल्प चुनें. इससे लॉग फ़िल्टर हो जाएंगे और सिर्फ़ वे लॉग दिखेंगे जो चुनी गई समयावधि के दौरान जनरेट हुए हैं.

संसाधन तय करने के लिए, संसाधन ड्रॉपडाउन पर क्लिक करें. इसके बाद, Google Assistant ऐक्शन प्रोजेक्ट चुनें. इससे आपकी क्वेरी में एक फ़िल्टर जुड़ जाता है. इससे आपके प्रोजेक्ट से जनरेट हुए लॉग दिखते हैं.

गंभीरता बटन का इस्तेमाल करके, आपातकालीन, जानकारी, डीबग, और अन्य गंभीरता वाले लॉग लेवल के हिसाब से फ़िल्टर करें.

कस्टम एंट्री डालने के लिए, Logs Explorer में क्वेरी फ़ील्ड का भी इस्तेमाल किया जा सकता है. इस फ़ील्ड के लिए इस्तेमाल किया जाने वाला क्वेरी इंजन, बुनियादी क्वेरी और ज़्यादा बेहतर क्वेरी, दोनों के साथ काम करता है. बुनियादी क्वेरी में स्ट्रिंग मैचिंग जैसी क्वेरी शामिल होती हैं. वहीं, ज़्यादा बेहतर क्वेरी में तुलना करने वाले ऑपरेटर (<, >=, !=) और बूलियन ऑपरेटर (AND, OR, NOT) शामिल होते हैं.

उदाहरण के लिए, नीचे दी गई कस्टम एंट्री से ऐसी गड़बड़ियां दिखेंगी जो LIGHT डिवाइस टाइप से जुड़ी हैं:

resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"

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

समस्याओं को ठीक करने के लिए टेस्टिंग

गड़बड़ियों का पता लगाने और उन्हें ठीक करने के लिए अपडेट लागू करने के बाद, हमारा सुझाव है कि आप Google Home Test Suite की मदद से, गड़बड़ियों को ठीक करने के लिए किए गए बदलावों की अच्छी तरह से जांच करें. हम Test Suite को इस्तेमाल करने के तरीके के बारे में उपयोगकर्ता गाइड उपलब्ध कराते हैं. इसमें, बदलावों को असरदार तरीके से टेस्ट करने के बारे में बताया गया है.

सीखने के लिए संसाधन

इस दस्तावेज़ में, स्मार्ट होम ऐक्शन में आने वाली गड़बड़ियों को ठीक करने का तरीका बताया गया है. डीबग करने के बारे में ज़्यादा जानने के लिए, हमारे कोडलैब भी देखे जा सकते हैं: