1. शुरू करने से पहले
यह कोडलैब, Google Home के उन पार्टनर और डेवलपर के लिए है जो Cloud के साथ इंटिग्रेशन करते हैं. इससे इकोसिस्टम की क्वालिटी और उपयोगकर्ता अनुभव को बेहतर बनाया जा सकेगा.
आपको क्या सीखने को मिलेगा
Google Home Vitals डैशबोर्ड , डेवलपर और पार्टनर के लिए, Google Home के इंटिग्रेशन की परफ़ॉर्मेंस की निगरानी करने का मुख्य सोर्स है. ऐसे इकोसिस्टम में जहां उपयोगकर्ता अनुभव को लेटेंसी और भरोसेमंद तरीके से तय किया जाता है, Google Home Vitals एक ऐसा सेल्फ़-सर्विस पोर्टल है जिसमें डीप-डाइव विश्लेषण की सभी जानकारी होती है. इसकी मदद से, समस्याओं को ठीक करने के लिए प्रतिक्रिया देने के बजाय, क्वालिटी को बेहतर तरीके से मैनेज किया जा सकता है.
- क्वालिटी इंटिग्रेशन स्कोर का हिसाब कैसे लगाया जाता है
- डैशबोर्ड को पढ़ने और इस्तेमाल करने का तरीका
- खराब क्वालिटी वाली मेट्रिक में मौजूद गड़बड़ियों को ठीक करने का तरीका
आपको किन चीज़ों की ज़रूरत होगी
- Google Home के साथ Cloud इंटिग्रेशन की सुविधा
सेटअप
Google Home Vitals डैशबोर्ड पर जाने का तरीका:
- Google Cloud Platform खोलें
- मॉनिटरिंग > डैशबोर्ड
- "Google Home Vitals (Cloud)" डैशबोर्ड पर क्लिक करें
2. डैशबोर्ड को पढ़ने का तरीका
क्वालिटी स्कोर का हिसाब लगाना – "अच्छा" बनाम "खराब" स्टैंडर्ड
डैशबोर्ड में, क्वालिटी स्कोरिंग के ब्रेकडाउन के बारे में बताया गया है. क्वालिटी स्कोर, डिवाइस टाइप के हिसाब से तय किए जाते हैं. किसी डिवाइस टाइप के इंटिग्रेशन को अच्छा माना जाने के लिए, उसे एक साथ चार शर्तें पूरी करनी होंगी:
- ग्लोबल सक्सेस रेट: पार्टनर से Google को किए जाने वाले कॉल का कुल सक्सेस रेट, 99.5% या इससे ज़्यादा होना चाहिए.
ध्यान दें: अगर ग्लोबल सक्सेस रेट (99.5% या इससे ज़्यादा) पूरा नहीं होता है, तो पूरे प्रोजेक्ट के लिए अपने-आप खराब रेटिंग असाइन हो जाती है. भले ही, हर डिवाइस की परफ़ॉर्मेंस अच्छी हो. - कमांड की भरोसेमंद परफ़ॉर्मेंस: हर डिवाइस टाइप के लिए, QUERY और EXECUTE का सक्सेस रेट 99.5% या इससे ज़्यादा होना चाहिए.
- रिस्पॉन्सिव लेटेंसी: हर डिवाइस टाइप के लिए, QUERY और EXECUTE की 90वें पर्सेंटाइल वाली लेटेंसी, 1000 मि॰से॰ या इससे कम होनी चाहिए.
- स्टेट इंटिग्रिटी: स्टेट की सटीक जानकारी का रेट, 99.5% या इससे ज़्यादा होना चाहिए.
ये मेट्रिक अहम क्यों हैं
- ग्लोबल सक्सेस रेट: इंटिग्रेशन लेवल पर, पार्टनर से Google को किए जाने वाले कॉल की मेट्रिक से पता चलता है कि आपके क्लाउड से Google को किए जाने वाले कॉल की परफ़ॉर्मेंस कैसी है. अगर सक्सेस रेट 99.5% या इससे ज़्यादा है, तो इसका मतलब है कि Google Home, डिवाइस की सही स्थितियों का इस्तेमाल करता है. उदाहरण के लिए, यह पक्का करना कि डिवाइस जोड़े और हटाए गए हों, ऑटोमेशन ट्रिगर हों, और Google Home ऐप्लिकेशन के 'गतिविधि' टैब में इतिहास के इवेंट दिखें.
- कमांड की भरोसेमंद परफ़ॉर्मेंस: QUERY और EXECUTE का सक्सेस रेट, डिवाइस टाइप के लेवल पर मेज़र किया जाता है. अगर सक्सेस रेट 99.5% या इससे ज़्यादा है, तो इसका मतलब है कि आपके उपयोगकर्ता के कमांड सही तरीके से पूरे किए जा रहे हैं. जैसे, "मैं डिवाइस से कनेक्ट नहीं हो पा रहा/रही हूं" जैसे Assistant के जवाब नहीं मिलते या ऐसे कमांड की पुष्टि नहीं होती जो पूरे नहीं हुए हैं.
- रिस्पॉन्सिव लेटेंसी: QUERY और EXECUTE की लेटेंसी भी डिवाइस टाइप के लेवल पर मेज़र की जाती है.हर डिवाइस टाइप के लिए, 1000 मि॰से॰ या इससे कम की लेटेंसी से यह पक्का होता है कि आपके उपयोगकर्ता को अपनी पसंद की कार्रवाई करने के लिए ज़्यादा इंतज़ार न करना पड़े. जैसे, लाइट बंद करने के लिए कुछ सेकंड इंतज़ार करना.
- स्टेट इंटिग्रिटी: स्टेट की सटीक जानकारी, Google के सिस्टम में सेव की गई स्टेट की सटीक जानकारी को मेज़र करती है. इसका इस्तेमाल, उपयोगकर्ता की क्वेरी के जवाब देने के लिए किया जाता है. अगर ये नंबर कम हैं, तो हो सकता है कि उपयोगकर्ता को आपके डिवाइस की स्टेट देखने या एआई की सुविधाओं का इस्तेमाल करने पर, गलत नतीजे दिखें. जैसे, 'Ask Home' का इस्तेमाल करने पर. ऑटोमेशन ट्रिगर नहीं हो सकते और इतिहास की एंट्री, गतिविधि में सही समय पर नहीं दिख सकती हैं.
डैशबोर्ड को पढ़ने का तरीका
क्वालिटी स्कोर मेट्रिक सेक्शन से शुरू करें. यह आपके इंटिग्रेशन के लिए, परफ़ॉर्मेंस का मुख्य इंडिकेटर है. डिवाइस लेवल पर अच्छी रेटिंग पाने के लिए, इस सेक्शन में मौजूद सभी मेट्रिक को, हरे रंग के सक्सेस क्राइटेरिया के मुताबिक होना चाहिए. ज़रूरी तकनीकी शर्तों और मेट्रिक की परिभाषाओं के बारे में ज़्यादा जानकारी, डेवलपर सेंटर के दस्तावेज़ में उपलब्ध है.
Google Home Vitals डैशबोर्ड में सबसे ऊपर मौजूद "क्वालिटी मेट्रिक स्कोर" सेक्शन में, आपके इंटिग्रेशन की क्वालिटी स्कोर का हिसाब लगाने के लिए इस्तेमाल की जाने वाली मेट्रिक दिखती हैं.
लेजेंड
- हरा (अच्छा): मेट्रिक, क्वालिटी थ्रेशोल्ड के मुताबिक है.
- लाल (खराब): मेट्रिक, क्वालिटी थ्रेशोल्ड के मुताबिक नहीं है.
उदाहरण
नीचे दिए गए उदाहरण में, आपको दिखेगा कि AC_UNIT डिवाइस टाइप, QUERY और EXECUTE के सक्सेस रेट के साथ-साथ, QUERY की लेटेंसी सेक्शन में क्वालिटी के क्राइटेरिया को पूरा करता है. हालांकि, EXECUTE की लेटेंसी बार (लाल) में यह क्राइटेरिया पूरा नहीं करता. इसका मतलब है कि कमांड, पासिंग रेट पर काम कर रहे हैं. हालांकि, EXECUTE की लेटेंसी 36 मि॰से॰ ज़्यादा है. सिस्टम की परफ़ॉर्मेंस सेक्शन में, इंटिग्रेशन के सभी तरीकों के लिए 98.92% का फ़ेलिंग रेट दिखता है. इसका मतलब है कि Google Home को उपयोगकर्ताओं के डिवाइस की स्टेट की सटीक जानकारी देने के लिए, इसमें सुधार किया जा सकता है. इसका मतलब है कि 1.08% कॉल (DeleteAgentUser, Query, ReportStateAndNotification, RequestSyncDevices या Sync) ऐसे रिस्पॉन्स कोड दिखा रहे हैं जो 2xx या 5xx के बराबर नहीं हैं. जैसे, 404 कोड वाली गड़बड़ियां. AC_UNIT डिवाइस टाइप के लिए, पास/फ़ेल क्वालिटी को मेज़र करने के लिए इस्तेमाल की जाने वाली आखिरी मेट्रिक, स्टेट की सटीक जानकारी है. इस उदाहरण में, हमें 77.43% का सक्सेस रेट दिखता है. इसका मतलब है कि उपयोगकर्ताओं को डिवाइसों के लिए गलत नतीजे दिख रहे हैं. इन तीन मेट्रिक के हिसाब से, AC_UNIT का कुल स्कोर खराब है और यह क्वालिटी थ्रेशोल्ड से कम है.
क्वालिटी के हर कैलकुलेशन के लिए, नीचे गड़बड़ी ठीक करने का एक सेक्शन दिया गया है. गड़बड़ी ठीक करने के लिए, कोलैप्स किए गए चरणों को खोलें.
QUERY/EXECUTE के सक्सेस रेट और लेटेंसी में मौजूद गड़बड़ियों को ठीक करने के लिए, "पहला चरण: Cloud कॉल की पुष्टि करना" पर जाएं.
पार्टनर से Google को किए जाने वाले कॉल के सक्सेस रेट में मौजूद गड़बड़ियों को ठीक करने के लिए, "दूसरा चरण: Google को किए जाने वाले कॉल की पुष्टि करना" पर जाएं.
हर डिवाइस टाइप के लिए, स्टेट की सटीक जानकारी में मौजूद गड़बड़ियों को ठीक करने के लिए, "तीसरा चरण: स्टेट की सटीक जानकारी को बेहतर बनाना" पर जाएं.
3. गड़बड़ी ठीक करने का पहला चरण: Cloud कॉल की पुष्टि करना
पहला चरण: खास जानकारी
इस सेक्शन में, Cloud कॉल पर फ़ोकस किया गया है. ये मेट्रिक, Google से आपके क्लाउड बैकएंड (इसे Google-to-Partner मेट्रिक भी कहा जाता है) को होने वाले कम्यूनिकेशन की परफ़ॉर्मेंस को मेज़र करती हैं. इसमें, Query, Execute जैसे कमांड शामिल हैं.
हम QUERY और EXECUTE के सक्सेस रेट और लेटेंसी को ट्रैक करते हैं. ये आपके डिवाइस-टाइप के क्वालिटी स्कोर में शामिल होते हैं.
नीचे दी गई खास जानकारी में, इंटिग्रेशन लेवल पर QUERY, EXECUTE के कुल सक्सेस रेट और गड़बड़ियां दिखती हैं. पहले चरण के 1a-1d में, डिवाइस टाइप/ट्रेट लेवल पर इन मेट्रिक का ब्रेकडाउन दिखता है. 
पहले चरण के 1a और 1b में, समय के साथ-साथ पूरे किए गए अनुरोधों की संख्या, गड़बड़ियों की संख्या, और गड़बड़ियों की खास स्थितियों का ट्रेंड दिखता है.
पहला चरण का पहला हिस्सा: क्वेरी में मौजूद गड़बड़ियां देखना
पहले चरण का दूसरा हिस्सा: EXECUTE में मौजूद गड़बड़ियां देखना
पहले चरण के 1c और 1d में, इंटिग्रेशन लेवल और डिवाइस टाइप लेवल, दोनों पर इन मेट्रिक के लिए 90वें और 50वें पर्सेंटाइल का ब्रेकडाउन दिखता है.
पहले चरण का तीसरा हिस्सा: क्वेरी की लेटेंसी देखना
पहले चरण का चौथा हिस्सा: EXECUTE की लेटेंसी देखना
4. गड़बड़ी ठीक करने का दूसरा चरण: Google को किए जाने वाले कॉल की पुष्टि करना
दूसरा चरण: खास जानकारी
Google से पार्टनर को किए जाने वाले कॉल में मौजूद गड़बड़ियों को ठीक करने के बाद, दूसरे चरण में पार्टनर के क्लाउड से Google को किए जाने वाले कॉल में मौजूद गड़बड़ियों को ठीक करने के बारे में बताया गया है. इस सेक्शन में, डिवाइस टाइप लेवल पर नहीं, बल्कि पार्टनर-इंटिग्रेशन लेवल पर मेट्रिक शामिल हैं. इनमें, 400 Bad Request, 404 Not Found, और 429 Resource Exhausted जैसे रिस्पॉन्स कोड शामिल हैं.
दूसरे चरण का पहला हिस्सा: कोटा से जुड़ी गड़बड़ियों को ठीक करना
Google Home, संसाधन के बंटवारे और इस्तेमाल को सीमित करता है. साथ ही, हर प्रोजेक्ट के लिए सही कोटा लागू करता है. Google, क्लाउड-टू-क्लाउड इंटिग्रेशन के आधार पर, आपकी क्वेरी, मिटाने, स्टेट की रिपोर्ट, और एसिंक्रोनस अनुरोध सिंक एपीआई कॉल के कुल योग पर, हर 60 सेकंड में 6,000 अनुरोधों की डिफ़ॉल्ट सीमा लागू करता है.
कोटा से जुड़ी गड़बड़ियों की वजह से, स्टेट की रिपोर्ट की सटीक जानकारी पर बुरा असर पड़ सकता है. ऐसा इसलिए, क्योंकि स्टेट के अपडेट को पूरा न कर पाने की वजह से, डेटा में अंतर आ सकता है. यहां चार्ट दिए गए हैं. इनमें, खास तौर पर स्टेट की रिपोर्ट और अनुरोध सिंक की गड़बड़ियां, संख्या और गड़बड़ियों का एपीआई तरीके से ब्रेकडाउन, और कोटा के इस्तेमाल का प्रतिशत दिखाया गया है. अगर इन चार्ट में ट्रैफ़िक में अचानक बढ़ोतरी दिख रही है, तो अपने इंटिग्रेशन की समीक्षा करें. इससे यह पता चलेगा कि किसी बदलाव की वजह से, Home Graph API को ज़्यादा ट्रैफ़िक भेजा जा रहा है या नहीं.
कुछ स्थितियों में, आपके इंटिग्रेशन के लिए कोटा बढ़ाना सही हो सकता है. जैसे, समय के साथ-साथ ट्रैफ़िक में स्वाभाविक बढ़ोतरी (उदाहरण के लिए, डिवाइसों की संख्या में बढ़ोतरी, नए डिवाइस टाइप के लॉन्च या किसी अन्य लॉन्च के साथ बढ़ोतरी). कोटा बढ़ाने का अनुरोध करने के लिए, हमारे डेवलपर दस्तावेज़ में दिया गया तरीका अपनाएं.
5. गड़बड़ी ठीक करने का तीसरा चरण: स्टेट की सटीक जानकारी को बेहतर बनाना
तीसरा चरण: खास जानकारी
पहले और दूसरे चरण में गड़बड़ियों को ठीक करने के बाद, तीसरे चरण में स्टेट की रिपोर्ट की सटीक जानकारी के बारे में बताया गया है. इसमें, Google के सिस्टम में सेव की गई डिवाइस की स्टेट शामिल होती हैं. इनका इस्तेमाल, उपयोगकर्ता की क्वेरी के जवाब देने के लिए किया जाता है. यहां, ट्रेट और डिवाइस टाइप के हिसाब से ब्रेकडाउन दिखाया गया है. तीसरे चरण के 3a और 3b में, स्टेट की रिपोर्ट में होने वाली दो सामान्य गड़बड़ियों के बारे में बताया गया है. ये हैं, 'फ़ील्ड मौजूद नहीं है' गड़बड़ियां और 'गलत जानकारी' गड़बड़ियां.
तीसरे चरण का पहला हिस्सा: "फ़ील्ड मौजूद नहीं है" गड़बड़ियां
"फ़ील्ड मौजूद नहीं है" गड़बड़ियां तब होती हैं, जब किसी डिवाइस के लिए, QUERY के रिस्पॉन्स और रिपोर्ट की गई स्टेट के अनुरोध के पेलोड फ़ील्ड के सेट में अंतर होता है. हर डिवाइस के पेलोड में फ़ील्ड का सेट एक जैसा होना चाहिए. ऐसा तब हो सकता है, जब पेलोड का हिसाब लगाने की लॉजिक, QUERY और रिपोर्ट की गई स्टेट के रिस्पॉन्स के बीच अलग-अलग हो. यह पता लगाने के लिए कि किन डिवाइस टाइप और ट्रेट में, QUERY और रिपोर्ट की गई स्टेट के रिस्पॉन्स मेल नहीं खाते, नीचे दिए गए चार्ट देखें.
तीसरे चरण का दूसरा हिस्सा: "गलत जानकारी" गड़बड़ियां
"गलत जानकारी" गड़बड़ियां तब होती हैं, जब किसी डिवाइस के लिए, QUERY के रिस्पॉन्स और रिपोर्ट की गई स्टेट के अनुरोध के पेलोड फ़ील्ड के सेट एक जैसे होते हैं. हालांकि, स्टेट की वैल्यू अलग-अलग होती हैं. ऐसा तब हो सकता है, जब स्टेट की रिपोर्ट न मिले या स्टेट का हिसाब लगाने की लॉजिक, QUERY और स्टेट की रिपोर्ट के बीच अलग-अलग हो. यह पता लगाने के लिए कि किन डिवाइस टाइप और ट्रेट में, QUERY और रिपोर्ट की गई स्टेट के रिस्पॉन्स मेल नहीं खाते, नीचे दिए गए चार्ट देखें.
6. अन्य दस्तावेज़ और संसाधन
- इस डैशबोर्ड के लिए सुझाव/राय देने या गड़बड़ियों की शिकायत करने के लिए, हमारे सार्वजनिक समस्या ट्रैकर में कोई समस्या दर्ज करें.
- अपील का अनुरोध करने के लिए, क्वालिटी मेट्रिक के लिए अपील करने वाले हमारे फ़ॉर्म का इस्तेमाल करके, कोई समस्या दर्ज करें.
- अपने इंटिग्रेशन की क्वालिटी के बारे में नियमित तौर पर जानकारी पाने के लिए, Google Cloud Platform के अलर्ट कॉन्फ़िगर करें. इससे, आपकी मेट्रिक, स्वीकार किए जा सकने वाले थ्रेशोल्ड से कम होने पर आपको सूचनाएं मिलेंगी. इससे यह पक्का होता है कि समस्या होने पर, आपको सबसे पहले पता चले.
- अन्य सभी जानकारी के लिए, कृपया डेवलपर के दस्तावेज़ में ज़्यादा जानकारी देखें – https://developers.home.google.com/tools/analytics/home-vitals