داشبورد نظارت بر کیفیت

این مجموعه داشبوردها و هشدارها به شما کمک می‌کند تا به طور فعال، یکپارچگی با کیفیت بالا را با اکوسیستم گوگل هوم حفظ کنید. گوگل متعهد به حمایت از شرکا در توسعه یک اکوسیستم با کیفیت بالا برای همه مشتریان است.

این داشبورد سه بخش دارد که هر کدام یک بخش کلیدی را پوشش می‌دهند که به کیفیت یکپارچه‌سازی کلی کمک می‌کند.

  1. معیارهای گوگل برای شرکا - سلامت تماس‌ها از گوگل به بک‌اند ابری شما را اندازه‌گیری می‌کند.

  2. سلامت سیستم - شریک Google Metrics - سلامت تماس‌های سیستم شما به گوگل را اندازه‌گیری می‌کند.

  3. سلامت دستگاه - دقت وضعیت - دقت وضعیت‌های ذخیره شده در سیستم‌های گوگل را که برای ارائه درخواست‌های کاربران استفاده می‌شوند، اندازه‌گیری می‌کند.

وقتی معیارها به مقادیر هدف خود نمی‌رسند، با رنگ قرمز برجسته می‌شوند تا مشکلی را که می‌تواند بر تجربه کاربر تأثیر بگذارد، نشان دهند. اطلاعات زیر جزئیاتی در مورد هر هدف و دلیل اهمیت آن برای کاربران شما ارائه می‌دهد.

به داشبورد بروید

معیارهای همکاری گوگل

معیار « نرخ موفقیت پرس‌وجو/اجرا >= 99.5%» میزان موفقیت اجرای صحیح دستورات کاربران را اندازه‌گیری می‌کند، که به جلوگیری از پاسخ‌های دستیار مانند «من نمی‌توانم به دستگاه دسترسی پیدا کنم» یا تأیید نادرست دستوری که اجرا نشده است، کمک می‌کند.

چه چیزی «موفقیت» را تعریف می‌کند؟

اگر پلتفرم گوگل هوم پاسخ معتبری دریافت کند که نشان دهد اقدام مورد نظر انجام شده یا وضعیت درخواستی بازیابی شده است، یک تراکنش به عنوان موفقیت‌آمیز علامت‌گذاری می‌شود.

پاسخ‌هایی که شامل استثنائات غیر مسدودکننده هستند (برای مثال، وضعیت SUCCESS همراه با استثنای lowBattery ) به عنوان تراکنش‌های موفق شمرده می‌شوند. دستور به دستگاه رسیده و هدف با وجود هشدار برآورده شده است.

چه چیزی «شکست» را تعریف می‌کند؟

خطاهای موجود در کدهای خطای پلتفرم مشترک که به عنوان Partner Actionable علامت‌گذاری شده‌اند، هنگام محاسبه نرخ موفقیت QUERY و EXECUTE به عنوان "خطا" در نظر گرفته می‌شوند.

معیار تأخیر درخواست/اجرا (p90) <= 1000ms ، زمان انتظار برای اقدام درخواستی را اندازه‌گیری می‌کند و به کاربران کمک می‌کند تا بیش از حد منتظر نمانند، مثلاً چند ثانیه برای خاموش شدن چراغ خود منتظر نمانند.

معیارهای تأخیر

تأخیر، شاخص مهمی از میزان پاسخگویی یکپارچه‌سازی شما به کاربر نهایی است. داشبورد، تأخیر صدک نودم (P90) را ردیابی می‌کند که نشان دهنده تجربه "کندترین" کاربران شما است (برای مثال، P90 برابر با ۸۰۰ میلی‌ثانیه به این معنی است که ۹۰٪ درخواست‌ها در ۸۰۰ میلی‌ثانیه یا کمتر پاسخ داده می‌شوند).

گوگل برای اطمینان از دقت فنی، میزان تأخیر را برای بررسی وضعیت در مقایسه با دستورات دستگاه، به طور متفاوتی اندازه‌گیری می‌کند.

۱. تأخیر پرس‌وجو (پرسشی)

این مقدار Cloud-to-cloud را زمانی که گوگل وضعیت فعلی دستگاه را درخواست می‌کند، اندازه‌گیری می‌کند.

  • شروع: گوگل یک درخواست action.devices.QUERY را به آدرس اینترنتی (URL) تکمیل درخواست شما ارسال می‌کند.
  • بازه اندازه‌گیری: مدت زمانی که طول می‌کشد تا ابر شما پاسخ کامل HTTP را دریافت، پردازش و به گوگل ارسال کند.
  • پایان: گوگل آخرین بارِ پاسخ را از سرویس شما دریافت و تأیید می‌کند.

۲. اجرای تأخیر (عمل)

این، زمان تأیید فرمان را هنگامی که گوگل یک درخواست کنترل به یک دستگاه ارسال می‌کند، اندازه‌گیری می‌کند.

  • شروع: گوگل یک درخواست action.devices.EXECUTE را به URL تکمیل سفارش شما ارسال می‌کند.
  • پنجره اندازه‌گیری: مدت زمانی که طول می‌کشد تا فضای ابری شما دستور را دریافت کرده و پاسخ تأیید را برگرداند.
  • پایان: گوگل پاسخ وضعیت SUCCESS ، PENDING یا OFFLINE را دریافت می‌کند.
  • محدوده فنی: این معیار، زمان «پاسخ تأیید» (Response Ack) بین ابر گوگل و ابر شما را اندازه‌گیری می‌کند. این معیار، مدت زمانی را که طول می‌کشد تا سخت‌افزار فیزیکی (مثلاً یک لامپ) تغییر حالت فیزیکی را تکمیل کند، اندازه‌گیری نمی‌کند، زیرا این امر اغلب شامل تأخیر شبکه مش محلی در خارج از مسیر ابر به ابر می‌شود.

سلامت سیستم - شریک معیارهای گوگل

حفظ نرخ موفقیت >= 99.5% به شما کمک می‌کند تا از صحت وضعیت دستگاه‌ها در Google Home، اضافه و حذف شدن دستگاه‌ها، فعال شدن اتوماسیون‌ها و نمایش رویدادهای تاریخچه در تب فعالیت Google Home app (GHA) اطمینان حاصل کنید.

نرخ موفقیت بر اساس کدهای پاسخ HTTP که توسط گوگل هنگام ارسال به‌روزرسانی‌های وضعیت توسط ابر شما بازگردانده می‌شود، محاسبه می‌شود. برای اطمینان از اینکه شرکا به دلیل مشکلات زیرساختی سمت گوگل جریمه نشوند، این معیار، خطاهای داخلی گوگل را از تعداد شکست‌ها حذف می‌کند.

چه چیزی «موفقیت» را تعریف می‌کند؟

  • 2xx (موفق): به‌روزرسانی وضعیت با موفقیت دریافت و توسط Home Graph پردازش شد.

چه چیزی «شکست» را تعریف می‌کند؟

  • 4xx (خطای همکار): این کدها نشان‌دهنده‌ی خطا هستند و نشان‌دهنده‌ی مشکلی در درخواست ارسالی از فضای ابری شما می‌باشند. کدهای رایج عبارتند از:
    • ۴۰۰ درخواست نامناسب: سرور به دلیل سینتکس نامعتبر قادر به پردازش درخواست نبود. دلایل رایج شامل JSON ناقص یا استفاده از null به جای "" برای یک مقدار رشته‌ای است.
    • ۴۰۴ یافت نشد: منبع درخواستی یافت نشد. معمولاً این بدان معناست که گوگل نمی‌تواند دستگاه درخواستی را پیدا کند. همچنین ممکن است به این معنی باشد که حساب کاربری مرتبط نیست یا یک agentUserId نامعتبر دریافت شده است. مطمئن شوید که agentUserId با مقدار ارائه شده در پاسخ SYNC شما مطابقت دارد و شما به درستی اهداف DISCONNECT مدیریت می‌کنید.
    • ۴۲۹ منابع تمام شده است: ادغام شما از سهمیه اختصاص داده شده خود فراتر رفته است. برای مدیریت سهمیه، به دستورالعمل‌های بخش «مرحله ۱» در داشبورد بالاتر مراجعه کنید.

سلامت دستگاه - دقت وضعیت

رسیدن به یا فراتر از دقت وضعیت >= 99.5% به کاربران کمک می‌کند تا هنگام مشاهده وضعیت دستگاه یا استفاده از ویژگی‌های هوش مصنوعی مانند «از خانه بپرس» نتایج صحیحی را مشاهده کنند. اگر دقت وضعیت پایین باشد، ممکن است اتوماسیون‌ها فعال نشوند و ورودی‌های تاریخچه در زمان مناسب در برگه فعالیت GHA ظاهر نشوند. برای اطلاعات بیشتر، به «گزارش وضعیت» مراجعه کنید.

داشبورد کیفیت، این موضوع را به صورت ساعتی با استفاده از دو معیار مجزا پیگیری می‌کند: دقت کلی و کمترین نوع/ویژگی ترکیبی .

۱. اجزای دقت

این معیار از «نمونه‌هایی» گرفته شده است که در آن‌ها گوگل می‌تواند وضعیت گزارش‌شده را در برابر یک نتیجه‌ی هدف شناخته‌شده تأیید کند.

۲. معیارهای داشبورد (محاسبه ساعتی)

داشبورد دقت را بر اساس یک بازه ۱ ساعته محاسبه می‌کند. اگر یک ساعت کمتر از ۱۰۰ نمونه کلی داشته باشد (S_Total < 100)، دقت آن ساعت روی N/A تنظیم می‌شود.

نمای ۱: دقت کلی (میانگین جهانی)

این نشان دهنده دقت کلی ادغام شما در تمام انواع دستگاه‌ها و ویژگی‌های ترکیبی است. این یک میانگین وزنی از سلامت کل اکوسیستم شما را ارائه می‌دهد.

  • محاسبه : دقت کل حالت در تمام دستگاه‌ها / مجموع کل حالت در تمام دستگاه‌ها.

نمای ۲: پایین‌ترین ترکیب نوع/صفت

این، غیرقابل اعتمادترین دسته خاص در یکپارچه‌سازی شما را شناسایی می‌کند. این کار مانع از آن می‌شود که دستگاه‌های با حجم بالا که کیفیت بالایی دارند، دستگاه‌های با حجم پایین که کیفیت پایینی دارند را پنهان کنند. به عنوان مثال، اگر حجم بالایی از چراغ‌ها با دقت حالت بالای ۹۹.۵٪ دارید، اما حجم کمی از سوئیچ‌ها با دقت حالت پایین دارید، این امر بهبود مورد نیاز در سوئیچ‌هایی را که ممکن است در مقدار متوسط ​​از دست بروند، برجسته می‌کند.

  • محاسبه : حداقل دقت حالت / مجموع حالت برای همه ترکیبات ویژگی/دستگاه.