۱. قبل از شروع
این آزمایشگاه کد برای شرکا و توسعهدهندگان گوگل هوم با ادغام ابری طراحی شده است تا کیفیت اکوسیستم و تجربه کاربری را بهبود بخشد.
آنچه یاد خواهید گرفت
داشبورد Google Home Vitals به عنوان منبع اصلی اطلاعات برای توسعهدهندگان و شرکا عمل میکند تا سلامت عملیاتی ادغامهای Google Home خود را رصد کنند. در اکوسیستمی که تجربه کاربری با تأخیر و قابلیت اطمینان تعریف میشود، Google Home Vitals پورتال سلف سرویسی است که شامل تمام تجزیه و تحلیلهای عمیق لازم برای گذار از عیبیابی واکنشی به مدیریت کیفیت پیشگیرانه است.
- نحوه محاسبه امتیاز ادغام کیفیت شما
- نحوه خواندن و استفاده از داشبورد
- چگونه معیارهای بیکیفیت را عیبیابی کنیم
آنچه نیاز دارید
- یکپارچهسازی با فضای ابری گوگل هوم
راهاندازی
نحوه دسترسی به داشبورد Google Home Vitals:
- پلتفرم ابری گوگل را باز کنید
- مانیتورینگ > داشبورد
- روی داشبورد «Google Home Vitals (Cloud)» کلیک کنید
۲. نحوه خواندن داشبورد
محاسبه امتیاز کیفیت - استاندارد «خوب» در مقابل «ضعیف»
داشبورد، جزئیات امتیازدهی کیفیت را توضیح میدهد. امتیازهای کیفیت بر اساس نوع دستگاه تعیین میشوند. برای اینکه یک ادغام نوع دستگاه، خوب در نظر گرفته شود، باید چهار معیار همزمان را داشته باشد:
- نرخ موفقیت جهانی: نرخ موفقیت کلی تماسهای شرکا با گوگل باید >=99.5% باشد.
توجه: عدم دستیابی به نرخ موفقیت جهانی (>=99.5%) منجر به رتبهبندی خودکار ضعیف در کل پروژه، صرف نظر از عملکرد تک تک دستگاهها، میشود. - قابلیت اطمینان فرمان: نرخ موفقیت پرسوجو (QUERY) و اجرا (EXECUTE) باید برای هر نوع دستگاه >=99.5٪ باشد.
- تأخیر واکنشگرا: تأخیر صدک نودم برای QUERY و EXECUTE باید برای هر نوع دستگاه <=1000ms باشد.
- یکپارچگی وضعیت: دقت وضعیت باید >=99.5% باشد.
چرا این معیارها مهم هستند؟
- نرخ موفقیت جهانی: تماسهای همکار با گوگل در سطح ادغام، سلامت تماسها از فضای ابری شما به گوگل را اندازهگیری میکند. نرخ موفقیت ≥99.5% تضمین میکند که گوگل هوم از وضعیت صحیح دستگاه استفاده میکند. برخی از نمونهها شامل اطمینان از اضافه و حذف شدن دستگاهها، فعال شدن اتوماسیونها و نمایش رویدادهای تاریخچه در تب فعالیت برنامه گوگل هوم است.
- قابلیت اطمینان دستور: میزان موفقیت پرسوجو و اجرا در سطح نوع دستگاه اندازهگیری میشود، نرخ موفقیت >=99.5% تضمین میکند که دستورات کاربر شما به درستی اجرا میشوند (یعنی از پاسخهای دستیار مانند "من نمیتوانم به دستگاه دسترسی پیدا کنم" یا تأیید نادرست دستوری که اجرا نشده است، جلوگیری میکند).
- تأخیر واکنشگرا: تأخیرهای QUERY و EXECUTE نیز در سطح نوع دستگاه اندازهگیری میشوند، تأخیر کمتر از ۱۰۰۰ میلیثانیه برای هر نوع دستگاه تضمین میکند که کاربر شما مجبور نیست برای رسیدن به عمل مورد نظر خود خیلی منتظر بماند (مثلاً چند ثانیه منتظر خاموش شدن چراغ خود بماند).
- یکپارچگی وضعیت: دقت وضعیت، دقت وضعیت ذخیره شده در سیستمهای گوگل و مورد استفاده برای ارائه درخواستهای کاربر را اندازهگیری میکند. اگر این اعداد پایین باشند، ممکن است کاربران هنگام مشاهده وضعیت دستگاه شما یا استفاده از ویژگیهای هوش مصنوعی مانند «از خانه بپرس» نتایج نادرستی را برای دستگاههای شما مشاهده کنند. ممکن است اتوماسیونها فعال نشوند و ورودیهای تاریخچه در زمان مناسب در بخش فعالیت ظاهر نشوند.
نحوه خواندن داشبورد
از بخش معیارهای امتیاز کیفیت شروع کنید، که به عنوان شاخص اصلی سلامت برای ادغام شما عمل میکند. رتبهبندی سطح دستگاه خوب (GOOD) منوط به این است که تمام معیارهای این بخش معیارهای موفقیت GREEN را برآورده کنند. الزامات فنی دقیق و تعاریف معیارها در مستندات مرکز توسعهدهندگان موجود است.
بخش «امتیاز معیارهای کیفیت» در بالای داشبورد Google Home Vitals، معیارهایی را نشان میدهد که برای محاسبه امتیاز کیفیت ادغام شما استفاده میشوند.
افسانه
- سبز (خوب): معیار، آستانه کیفیت را برآورده میکند.
- قرمز (ضعیف): معیار، آستانه کیفیت را برآورده نمیکند.
مثال
در مثال زیر، میتوانید ببینید که نوع دستگاه AC_UNIT معیارهای کیفیت را در نرخ موفقیت QUERY و EXECUTE و همچنین بخش QUERY Latency برآورده میکند، اما در نوار EXECUTE Latency (قرمز) شکست میخورد. این بدان معناست که دستورات با نرخ قبولی موفق میشوند، اما تأخیر EXECUTE 36 میلیثانیه بسیار کند است. بخش System Health نرخ 98.92٪ شکست را برای روشهای تجمیع شده در سراسر ادغام نشان میدهد، به این معنی که جایی برای بهبود وجود دارد تا از صحت وضعیتهای دستگاه کاربران برای Google Home اطمینان حاصل شود. این بدان معناست که 1.08٪ از تماسها (DeleteAgentUser، Query، ReportStateAndNotification، RequestSyncDevices یا Sync) کدهای پاسخی را برمیگردانند که برابر با 2xx یا 5xx نیستند (مثلاً خطاهای 404). آخرین معیار مورد استفاده برای اندازهگیری کیفیت قبولی/ردی برای نوع دستگاه AC_UNIT، دقت وضعیت است. در این مثال، نرخ موفقیت ۷۷.۴۳٪ را میبینیم، به این معنی که کاربران احتمالاً نتایج نادرستی را برای دستگاهها مشاهده میکنند. با این سه معیار، امتیاز کلی AC_UNIT ضعیف و پایینتر از آستانه کیفیت است.
هر یک از این محاسبات کیفیت مربوط به یک بخش اشکالزدایی در زیر است. برای اشکالزدایی بیشتر، مراحل باز شده را باز کنید.
برای اشکالزدایی نرخ موفقیت و تأخیرهای QUERY/EXECUTE، به «مرحله 1: اعتبارسنجی فراخوانیهای ابری» بروید.
برای بررسی میزان موفقیت همکاری با گوگل، به «مرحله ۲: اعتبارسنجی تماسها با گوگل» بروید.
برای اشکالزدایی دقت حالت برای هر نوع دستگاه، به «مرحله 3: بهبود دقت حالت» بروید.
۳. اشکالزدایی مرحله ۱: اعتبارسنجی فراخوانیهای ابری
مرحله ۱: مرور کلی
این بخش بر روی تماسهای ابری تمرکز دارد - معیارهایی که سلامت ارتباطات از گوگل به بکاند ابری شما را اندازهگیری میکنند (همچنین به عنوان معیارهای Google-to-Partner شناخته میشوند). این شامل دستوراتی مانند Query ، Execute میشود .
ما میزان موفقیت و تأخیر در QUERY و EXECUTE (که در امتیاز کیفیت نوع دستگاه شما تأثیر میگذارند) را پیگیری میکنیم.
نمای کلی زیر، میزان موفقیت و خطاهای QUERY، EXECUTE را در سطح ادغام نشان میدهد. مراحل 1a تا 1d، تفکیک این معیارها را در سطح نوع/ویژگی دستگاه نشان میدهد. 
مراحل ۱a و ۱b روند تعداد درخواستهای تکمیلشده، تعداد خطاها در طول زمان و وضعیتهای خاص خطا را نشان میدهند.
مرحله ۱a: بررسی خطاهای پرس و جو
مرحله ۱ب: بررسی خطاهای اجرا
مراحل 1c و 1d تفکیک صدکهای 90 و 50 را برای این معیارها و همچنین در سطح ادغام و سطح نوع دستگاه نشان میدهند.
مرحله 1c: بررسی تأخیر پرس و جو
مرحله ۱d: بررسی تأخیر اجرا
۴. اشکالزدایی مرحله ۲: اعتبارسنجی فراخوانیها به گوگل
مرحله ۲: مرور کلی
پس از اشکالزدایی تماسهای گوگل به شریک، این مرحله دوم اشکالزدایی تماسهای از فضای ابری شریک به گوگل را پوشش میدهد. این بخش معیارهای سطح ادغام شریک را پوشش میدهد، نه سطح نوع دستگاه - این شامل کدهای پاسخی مانند 400 درخواست بد، 404 یافت نشد و 429 منابع تمام شده است.
مرحله ۲a: رفع مشکلات سهمیهبندی
گوگل هوم تخصیص و استفاده از منابع را محدود میکند و سهمیههای مناسبی را بر اساس هر پروژه اعمال میکند. گوگل محدودیت پیشفرض ۶۰۰۰ درخواست در هر ۶۰ ثانیه را برای مجموع درخواستها، حذف، گزارش وضعیت و فراخوانیهای API همگامسازی ناهمزمان درخواست شما، بر اساس ادغام ابر به ابر، اعمال میکند.
مشکلات مربوط به سهمیه میتواند تأثیر منفی بر دقت گزارش وضعیت داشته باشد، زیرا عدم تکمیل بهروزرسانی وضعیت ممکن است باعث عدم تطابق شود. در زیر نمودارهایی با جزئیات به طور خاص نشان داده شده است که خطاهای گزارش وضعیت و درخواست همگامسازی، تجزیه و تحلیل تعداد و خطاها در روش API و همچنین درصد استفاده از سهمیه را نشان میدهد. اگر این نمودارها افزایش غیرمنتظرهای در ترافیک نشان میدهند، ادغام خود را بررسی کنید تا مشخص شود که آیا تغییری باعث ارسال ترافیک بیشتر به API Home Graph میشود یا خیر.
در برخی سناریوها، مانند رشد طبیعی ترافیک در طول زمان (مثلاً رشد با افزایش تعداد دستگاهها، راهاندازی نوع جدیدی از دستگاه یا برخی دیگر از راهاندازیهای مورد انتظار سازگار است)، افزایش سهمیه برای ادغام شما ممکن است مناسب باشد. برای درخواست افزایش سهمیه، مراحل موجود در مستندات توسعهدهندگان ما را دنبال کنید .
۵. اشکالزدایی مرحله ۳: بهبود دقت حالت
مرحله ۳: مرور کلی
با رفع اشکال هر دو مرحله ۱ و ۲، مرحله ۳ صحت گزارش وضعیت (Report State) را بررسی میکند - وضعیتهای دستگاه ذخیره شده در سیستمهای گوگل که برای ارائه درخواستهای کاربر استفاده میشوند. جزئیات بر اساس ویژگی و نوع دستگاه در زیر نشان داده شده است. مراحل ۳a و ۳b دو خطای رایج برای گزارش وضعیت، خطاهای فیلد گمشده و خطاهای نادرست را پوشش میدهند.
مرحله ۳a: خطاهای «فیلد گمشده»
خطاهای "فیلد گمشده" زمانی ایجاد میشوند که مجموعه فیلدهای بار مفید بین پاسخ QUERY و درخواست وضعیت گزارش شده برای یک دستگاه مشخص متفاوت باشند. مجموعه فیلدهای درون بار مفید هر دستگاه باید یکسان باشد. این میتواند زمانی ایجاد شود که منطق محاسبه بار مفید بین پاسخ QUERY و وضعیت گزارش آن متفاوت باشد. از نمودارهای زیر برای ردیابی اینکه کدام نوع و ویژگی دستگاه دارای پاسخهای QUERY و وضعیت گزارش عدم تطابق هستند، استفاده کنید.
مرحله ۳ب: خطاهای «نادقیق»
خطاهای نادرست زمانی ایجاد میشوند که مجموعه فیلدهای بار مفید بین پاسخ QUERY و درخواست وضعیت گزارششده برای یک دستگاه مشخص یکسان باشند، اما مقادیر وضعیت متفاوت باشند. این میتواند در صورتی ایجاد شود که یک گزارش وضعیت از قلم افتاده باشد یا منطق محاسبه وضعیت بین QUERY و گزارش وضعیت متفاوت باشد. از نمودارهای زیر برای ردیابی اینکه کدام نوع دستگاه و ویژگیها پاسخهای QUERY و وضعیت گزارششده با هم مطابقت ندارند، استفاده کنید.
۶. سایر مستندات و منابع
- برای ارسال بازخورد یا گزارش مشکلات مربوط به این داشبورد، یک مشکل را در ردیاب مشکلات عمومی ما ثبت کنید.
- برای ثبت درخواست تجدیدنظر، با استفاده از فرم تجدیدنظر معیار کیفیت ما، مشکل را ثبت کنید.
- برای اینکه مرتباً از کیفیت ادغام خود آگاه باشید، هشدارهای پلتفرم ابری گوگل را طوری پیکربندی کنید که وقتی معیارهای شما از آستانه قابل قبول پایینتر میآیند، اعلان دریافت کنید. این تضمین میکند که شما اولین کسی باشید که از بروز مشکل مطلع میشوید.
- برای اطلاعات بیشتر، لطفاً به مستندات توسعهدهنده مراجعه کنید - https://developers.home.google.com/tools/analytics/home-vitals