১. শুরু করার আগে
এই কোডল্যাবটি গুগল হোম পার্টনার এবং ক্লাউড ইন্টিগ্রেশনসহ ডেভেলপারদের জন্য ইকোসিস্টেমের মান ও ব্যবহারকারীর অভিজ্ঞতা উন্নত করার লক্ষ্যে ডিজাইন করা হয়েছে।
আপনি যা শিখবেন
গুগল হোম ভাইটালস ড্যাশবোর্ড ডেভেলপার এবং পার্টনারদের জন্য তাদের গুগল হোম ইন্টিগ্রেশনগুলোর কার্যক্ষম অবস্থা নিরীক্ষণের একটি কেন্দ্রীয় নির্ভরযোগ্য উৎস হিসেবে কাজ করে। এমন একটি ইকোসিস্টেমে যেখানে ব্যবহারকারীর অভিজ্ঞতা ল্যাটেন্সি এবং নির্ভরযোগ্যতা দ্বারা নির্ধারিত হয়, সেখানে গুগল হোম ভাইটালস হলো সেই সেলফ-সার্ভিস পোর্টাল, যেখানে তাৎক্ষণিক সমস্যা সমাধান থেকে সক্রিয় মান ব্যবস্থাপনায় উত্তরণের জন্য প্রয়োজনীয় সমস্ত গভীর বিশ্লেষণমূলক তথ্য রয়েছে।
- আপনার কোয়ালিটি ইন্টিগ্রেশন স্কোর কীভাবে গণনা করা হয়
- ড্যাশবোর্ড কীভাবে পড়তে ও ব্যবহার করতে হয়
- নিম্নমানের মেট্রিক্স কীভাবে ডিবাগ করবেন
আপনার যা যা লাগবে
- গুগল হোম ক্লাউড ইন্টিগ্রেশন আছে
সেটআপ
গুগল হোম ভাইটালস ড্যাশবোর্ডে কীভাবে যাবেন:
- গুগল ক্লাউড প্ল্যাটফর্ম খুলুন
- পর্যবেক্ষণ > ড্যাশবোর্ড
- 'Google Home Vitals (Cloud)' ড্যাশবোর্ডে ক্লিক করুন
২. ড্যাশবোর্ডটি কীভাবে পড়বেন
গুণমান স্কোর গণনা – 'ভালো' বনাম 'খারাপ' মানদণ্ড
ড্যাশবোর্ডটি কোয়ালিটি স্কোরিংয়ের বিস্তারিত বিবরণ ব্যাখ্যা করে। ডিভাইসের ধরন অনুযায়ী সূক্ষ্মভাবে কোয়ালিটি স্কোর নির্ধারণ করা হয়। কোনো একটি ডিভাইসের ধরনের ইন্টিগ্রেশনকে 'ভালো' হিসেবে বিবেচিত হতে হলে, সেটিকে একই সাথে চারটি মানদণ্ড পূরণ করতে হবে:
- বৈশ্বিক সাফল্যের হার: পার্টনার থেকে গুগলে করা কলের সামগ্রিক সাফল্যের হার অবশ্যই ৯৯.৫% বা তার বেশি হতে হবে।
দ্রষ্টব্য: বৈশ্বিক সাফল্যের হার (>=৯৯.৫%) পূরণে ব্যর্থ হলে, স্বতন্ত্র ডিভাইসের কর্মক্ষমতা নির্বিশেষে, পুরো প্রকল্প জুড়ে স্বয়ংক্রিয়ভাবে একটি 'দুর্বল' (POOR) রেটিং দেওয়া হবে। - কমান্ডের নির্ভরযোগ্যতা: প্রতিটি ডিভাইসের ধরনের জন্য QUERY এবং EXECUTE সফলতার হার অবশ্যই >=৯৯.৫% হতে হবে।
- রেসপন্সিভ ল্যাটেন্সি: প্রতিটি ডিভাইসের ধরনের জন্য QUERY এবং EXECUTE-এর ৯০তম পার্সেন্টাইল ল্যাটেন্সি অবশ্যই ১০০০ms বা তার কম হতে হবে।
- অবস্থার অখণ্ডতা: অবস্থার নির্ভুলতা অবশ্যই ৯৯.৫% বা তার বেশি হতে হবে।
কেন এই মেট্রিকগুলো গুরুত্বপূর্ণ
- গ্লোবাল সাকসেস রেট: ইন্টিগ্রেশন-লেভেলে পার্টনার-টু-গুগল কল আপনার ক্লাউড থেকে গুগলে করা কলের অবস্থা পরিমাপ করে। >= ৯৯.৫% সফলতার হার নিশ্চিত করে যে গুগল হোম ডিভাইসের সঠিক অবস্থা ব্যবহার করছে। এর কিছু উদাহরণ হলো, ডিভাইস যুক্ত ও অপসারণ করা হচ্ছে কিনা, অটোমেশনগুলো চালু হচ্ছে কিনা, এবং হিস্ট্রি ইভেন্টগুলো গুগল হোম অ্যাপের অ্যাক্টিভিটি ট্যাবে দেখা যাচ্ছে কিনা তা নিশ্চিত করা।
- কমান্ডের নির্ভরযোগ্যতা: QUERY এবং EXECUTE-এর সফলতার হার ডিভাইস টাইপ লেভেলে পরিমাপ করা হয়, >=৯৯.৫% সফলতার হার নিশ্চিত করে যে আপনার ব্যবহারকারীর কমান্ডগুলো সঠিকভাবে সম্পন্ন হয়েছে (অর্থাৎ, এটি অ্যাসিস্ট্যান্টের "আমি ডিভাইসটিতে পৌঁছাতে পারছি না" বা সম্পন্ন না হওয়া কোনো কমান্ড ভুলভাবে নিশ্চিত করার মতো প্রতিক্রিয়া এড়িয়ে চলে)।
- রেসপন্সিভ ল্যাটেন্সি: QUERY এবং EXECUTE ল্যাটেন্সি ডিভাইস টাইপ লেভেলেও পরিমাপ করা হয়, প্রতি ডিভাইস টাইপে <=1000ms ল্যাটেন্সি নিশ্চিত করে যে আপনার ব্যবহারকারীকে তাদের কাঙ্ক্ষিত কাজটি করার জন্য খুব বেশি সময় অপেক্ষা করতে হবে না (যেমন, তাদের লাইট বন্ধ হওয়ার জন্য কয়েক সেকেন্ড অপেক্ষা করা)।
- স্টেট ইন্টিগ্রিটি: স্টেট অ্যাকুরেসি গুগল সিস্টেমে সংরক্ষিত এবং ব্যবহারকারীর কোয়েরি পূরণের জন্য ব্যবহৃত স্টেটের নির্ভুলতা পরিমাপ করে। এই সংখ্যাগুলো কম হলে, ব্যবহারকারীরা আপনার ডিভাইসের স্টেট দেখার সময় বা আস্ক হোম-এর মতো এআই ফিচার ব্যবহার করার সময় ভুল ফলাফল দেখতে পারেন। অটোমেশনগুলো চালু নাও হতে পারে এবং হিস্ট্রি এন্ট্রিগুলো সঠিক সময়ে অ্যাক্টিভিটিতে নাও দেখা যেতে পারে।
ড্যাশবোর্ডটি কীভাবে পড়বেন
কোয়ালিটি স্কোর মেট্রিক্স বিভাগ থেকে শুরু করুন, যা আপনার ইন্টিগ্রেশনের প্রাথমিক স্বাস্থ্য সূচক হিসেবে কাজ করে। একটি ‘গুড’ ডিভাইস-স্তরের রেটিং নির্ভর করে এই বিভাগের সমস্ত মেট্রিক্স ‘গ্রিন’ সফলতার মানদণ্ড পূরণ করার উপর। বিস্তারিত প্রযুক্তিগত প্রয়োজনীয়তা এবং মেট্রিক্সের সংজ্ঞা ডেভেলপার সেন্টার ডকুমেন্টেশনে পাওয়া যাবে।
গুগল হোম ভাইটালস ড্যাশবোর্ডের শীর্ষে থাকা 'কোয়ালিটি মেট্রিক্স স্কোর' বিভাগটি আপনার ইন্টিগ্রেশন কোয়ালিটি স্কোর গণনা করতে ব্যবহৃত মেট্রিক্সগুলো প্রতিফলিত করে।
কিংবদন্তি
- সবুজ (ভালো): মেট্রিকটি গুণমানের মানদণ্ড পূরণ করে।
- লাল (নিম্নমানের): মেট্রিকটি গুণমানের নির্ধারিত মান পূরণ করে না।
উদাহরণ
নিচের উদাহরণে, আপনি দেখতে পাচ্ছেন যে AC_UNIT ডিভাইস টাইপটি QUERY এবং EXECUTE Success Rate-এর পাশাপাশি QUERY Latency সেকশনেও কোয়ালিটি ক্রাইটেরিয়া পূরণ করছে, কিন্তু EXECUTE Latency বারটিতে (লাল) ব্যর্থ হচ্ছে। এর মানে হলো, কমান্ডগুলো পাসিং রেটে সফল হচ্ছে, কিন্তু EXECUTE ল্যাটেন্সি ৩৬ms বেশি ধীর। সিস্টেম হেলথ সেকশনটি ইন্টিগ্রেশন জুড়ে অ্যাগ্রিগেটেড মেথডগুলোর জন্য ৯৮.৯২% ব্যর্থতার হার দেখাচ্ছে, যার মানে হলো Google Home-এ ব্যবহারকারীদের ডিভাইসের অবস্থার নির্ভুলতা নিশ্চিত করার জন্য উন্নতির সুযোগ রয়েছে। এর মানে হলো ১.০৮% কল (DeleteAgentUser, Query, ReportStateAndNotification, RequestSyncDevices, বা Sync) এমন রেসপন্স কোড ফেরত দিচ্ছে যা 2xx বা 5xx-এর সমান নয় (যেমন, 404 এরর)। AC_UNIT ডিভাইস টাইপের পাস/ফেল কোয়ালিটি পরিমাপ করার জন্য ব্যবহৃত শেষ মেট্রিকটি হলো স্টেট অ্যাকুরেসি। এই উদাহরণে, আমরা ৭৭.৪৩% সফলতার হার দেখতে পাচ্ছি, যার মানে হলো ব্যবহারকারীরা সম্ভবত ডিভাইসগুলোর জন্য ভুল ফলাফল দেখছেন। এই তিনটি মেট্রিক অনুসারে, AC_UNIT-এর সামগ্রিক স্কোর দুর্বল এবং গুণমানের প্রান্তসীমার নিচে।
এই প্রতিটি কোয়ালিটি ক্যালকুলেশন নিচের একটি ডিবাগিং সেকশনের সাথে সম্পর্কিত। আরও ডিবাগিংয়ের জন্য সংকুচিত ধাপগুলো খুলুন।
QUERY/EXECUTE-এর সফলতার হার এবং বিলম্ব ডিবাগ করতে, "ধাপ ১: ক্লাউড কল যাচাই করুন"-এ যান।
পার্টনার টু গুগল সফলতার হার ডিবাগ করতে, 'ধাপ ২: গুগল-এ কল যাচাই করুন'-এ যান।
প্রতিটি ডিভাইস টাইপের জন্য স্টেট অ্যাকুরেসি ডিবাগ করতে, 'ধাপ ৩: স্টেট অ্যাকুরেসি উন্নত করুন'-এ যান।
৩. ডিবাগিং ধাপ ১: ক্লাউড কল যাচাই করুন
ধাপ ১: সংক্ষিপ্ত বিবরণ
এই বিভাগে ক্লাউড কল-এর উপর আলোকপাত করা হয়েছে — যা গুগল থেকে আপনার ক্লাউড ব্যাকএন্ডে যোগাযোগের অবস্থা পরিমাপ করে (এটি গুগল-টু-পার্টনার মেট্রিক্স নামেও পরিচিত)। এর মধ্যে Query , Execute এর মতো কমান্ড অন্তর্ভুক্ত।
আমরা QUERY এবং EXECUTE-এর সফলতার হার ও লেটেন্সি ট্র্যাক করি (যা আপনার ডিভাইস-টাইপ কোয়ালিটি স্কোরে প্রভাব ফেলে)।
নিচের ওভারভিউটি ইন্টিগ্রেশন লেভেলে সামগ্রিক QUERY ও EXECUTE সফলতার হার এবং ত্রুটিগুলো দেখায়। ধাপ ১ক-১ঘ ডিভাইস টাইপ/ট্রেট লেভেলে এই মেট্রিকগুলোর বিস্তারিত বিভাজন দেখায়। 
ধাপ ১ক এবং ১খ-তে পূরণকৃত অনুরোধের সংখ্যা, সময়ের সাথে সাথে ত্রুটির সংখ্যা এবং নির্দিষ্ট ত্রুটির স্থিতির প্রবণতা দেখানো হয়েছে।
ধাপ ১ক: কোয়েরির ত্রুটিগুলো পর্যালোচনা করুন
ধাপ ১খ: নির্বাহ ত্রুটি পর্যালোচনা করুন
ধাপ ১সি এবং ১ডি-তে ইন্টিগ্রেশন লেভেল এবং ডিভাইস টাইপ লেভেল উভয় ক্ষেত্রেই এই মেট্রিকগুলোর ৯০তম এবং ৫০তম পার্সেন্টাইলের বিভাজন দেখানো হয়েছে।
ধাপ ১গ: কোয়েরি লেটেন্সি পর্যালোচনা করুন
ধাপ ১ডি: এক্সিকিউট ল্যাটেন্সি পর্যালোচনা করুন
৪. ডিবাগিং ধাপ ২: গুগলে করা কলগুলো যাচাই করুন
ধাপ ২: সংক্ষিপ্ত বিবরণ
গুগল থেকে পার্টনারের কাছে করা কল ডিবাগ করার পর, এই দ্বিতীয় ধাপে পার্টনার ক্লাউড থেকে গুগলের কাছে করা কল ডিবাগ করা হয়। এই বিভাগে পার্টনার-ইন্টিগ্রেশন স্তরের মেট্রিক্স আলোচনা করা হয়েছে, ডিভাইস টাইপ স্তরের নয় – এর মধ্যে 400 Bad Request, 404 Not Found, এবং 429 Resource Exhausted-এর মতো রেসপন্স কোডগুলো অন্তর্ভুক্ত।
ধাপ ২ক: কোটা সংক্রান্ত সমস্যা সমাধান করুন
গুগল হোম রিসোর্স বরাদ্দ ও ব্যবহার সীমিত করে এবং প্রজেক্ট-ভিত্তিক যথাযথ কোটা প্রয়োগ করে। গুগল প্রতিটি ক্লাউড-টু-ক্লাউড ইন্টিগ্রেশনের ভিত্তিতে আপনার কোয়েরি, ডিলিট, রিপোর্ট স্টেট এবং অ্যাসিঙ্ক্রোনাস রিকোয়েস্ট সিঙ্ক এপিআই কলগুলোর সমষ্টির উপর প্রতি ৬০ সেকেন্ডে ৬,০০০ রিকোয়েস্টের ডিফল্ট সীমা প্রয়োগ করে।
কোটা সংক্রান্ত সমস্যা রিপোর্ট স্টেট অ্যাকুরেসি-কে নেতিবাচকভাবে প্রভাবিত করতে পারে, কারণ স্টেট আপডেট সম্পূর্ণ করতে ব্যর্থ হলে একটি অমিল দেখা দিতে পারে। নিচে চার্ট দেওয়া হলো যেখানে বিশেষভাবে রিপোর্ট স্টেট এবং রিকোয়েস্ট সিঙ্ক এরর, এপিআই মেথড অনুযায়ী সংখ্যা ও এররের বিভাজন এবং কোটা ব্যবহারের শতাংশ দেখানো হয়েছে। যদি এই চার্টগুলোতে ট্র্যাফিকের অপ্রত্যাশিত বৃদ্ধি দেখা যায়, তবে আপনার ইন্টিগ্রেশন পর্যালোচনা করে দেখুন কোনো পরিবর্তনের কারণে হোম গ্রাফ এপিআই-তে বেশি ট্র্যাফিক পাঠানো হচ্ছে কিনা।
কিছু পরিস্থিতিতে, যেমন সময়ের সাথে সাথে ট্র্যাফিকের স্বাভাবিক বৃদ্ধির ক্ষেত্রে (উদাহরণস্বরূপ, ডিভাইসের সংখ্যা বৃদ্ধি, নতুন ধরনের ডিভাইস চালু হওয়া, বা অন্য কোনো প্রত্যাশিত লঞ্চের সাথে এই বৃদ্ধি সামঞ্জস্যপূর্ণ), আপনার ইন্টিগ্রেশনের জন্য কোটা বৃদ্ধি করা উপযুক্ত হতে পারে। কোটা বৃদ্ধির জন্য অনুরোধ করতে, আমাদের ডেভেলপার ডকুমেন্টেশনে দেওয়া ধাপগুলো অনুসরণ করুন ।
৫. ডিবাগিং ধাপ ৩: স্টেটের নির্ভুলতা উন্নত করা
ধাপ ৩: সংক্ষিপ্ত বিবরণ
ধাপ ১ এবং ধাপ ২ উভয়ই ডিবাগ করার পর, ধাপ ৩-এ রিপোর্ট স্টেটের নির্ভুলতা যাচাই করা হয় – এটি হলো গুগল সিস্টেমে সংরক্ষিত ডিভাইসের অবস্থা, যা ব্যবহারকারীর কোয়েরি পরিবেশন করতে ব্যবহৃত হয়। বৈশিষ্ট্য এবং ডিভাইসের ধরন অনুযায়ী বিভাজন নিচে দেখানো হলো। ধাপ ৩ক এবং ৩খ-তে রিপোর্ট স্টেটের দুটি সাধারণ ত্রুটি, যথা—মিসিং ফিল্ড ত্রুটি এবং ইনঅ্যাকুরেট ত্রুটি নিয়ে আলোচনা করা হয়েছে।
ধাপ ৩ক: "ফিল্ড অনুপস্থিত" ত্রুটি
কোনো নির্দিষ্ট ডিভাইসের জন্য একটি QUERY রেসপন্স এবং একটি রিপোর্টেড স্টেট রিকোয়েস্টের পেলোড ফিল্ডের সেট ভিন্ন হলে "Missing Field" এরর দেখা দেয়। প্রতিটি ডিভাইসের পেলোডের ভেতরের ফিল্ডের সেট অবশ্যই একই হতে হবে। এর QUERY এবং রিপোর্ট স্টেট রেসপন্সের মধ্যে পেলোড গণনা করার লজিক ভিন্ন হলে এমনটা হতে পারে। কোন কোন ডিভাইসের ধরন এবং বৈশিষ্ট্যের QUERY ও রিপোর্ট স্টেট রেসপন্সের মধ্যে অমিল রয়েছে তা খুঁজে বের করতে নিচের চার্টগুলো ব্যবহার করুন।
ধাপ ৩খ: "ভুল" ত্রুটি
যখন কোনো নির্দিষ্ট ডিভাইসের জন্য একটি QUERY রেসপন্স এবং একটি রিপোর্ট করা স্টেট রিকোয়েস্টের পেলোড ফিল্ডগুলো একই থাকে, কিন্তু স্টেটের মান ভিন্ন হয়, তখন অসঠিক ত্রুটি দেখা দেয়। এমনটা হতে পারে যদি কোনো স্টেট রিপোর্ট বাদ পড়ে যায় অথবা যদি QUERY এবং একটি স্টেট রিপোর্টের মধ্যে স্টেট গণনা করার লজিক ভিন্ন হয়। কোন কোন ডিভাইসের ধরন এবং বৈশিষ্ট্যের QUERY ও রিপোর্ট করা স্টেট রেসপন্সের মধ্যে অমিল রয়েছে তা খুঁজে বের করতে নিচের চার্টগুলো ব্যবহার করুন।
৬. অন্যান্য নথিপত্র ও সম্পদ
- এই ড্যাশবোর্ড সম্পর্কে মতামত জানাতে বা কোনো সমস্যা রিপোর্ট করতে, আমাদের পাবলিক ইস্যু ট্র্যাকারে একটি ইস্যু ফাইল করুন।
- আপিলের অনুরোধ দাখিল করতে, আমাদের কোয়ালিটি মেট্রিক আপিল ফর্ম ব্যবহার করে একটি সমস্যা নথিভুক্ত করুন।
- আপনার ইন্টিগ্রেশনের মান সম্পর্কে নিয়মিত অবগত থাকতে, আপনার মেট্রিক্স একটি গ্রহণযোগ্য সীমার নিচে নেমে গেলে বিজ্ঞপ্তি পাওয়ার জন্য গুগল ক্লাউড প্ল্যাটফর্ম অ্যালার্ট কনফিগার করুন। এটি নিশ্চিত করে যে কোনো সমস্যা দেখা দিলে আপনিই প্রথম জানতে পারবেন।
- অন্যান্য সকল তথ্যের জন্য, অনুগ্রহ করে ডেভেলপারের ডকুমেন্টেশন দেখুন – https://developers.home.google.com/tools/analytics/home-vitals