تساعدك هذه المجموعة من لوحات البيانات والتنبيهات في الحفاظ بشكل استباقي على تكامل عالي الجودة مع منظومة Google Home المتكاملة. تلتزم Google بتقديم الدعم للشركاء في تطوير منظومة متكاملة عالية الجودة لجميع العملاء
تتضمّن لوحة البيانات ثلاثة أقسام، يغطّي كل قسم جزءًا رئيسيًا يساهم في جودة عملية الدمج بشكل عام.
مقاييس Google إلى الشريك: تقيس هذه المقاييس سلامة المكالمات من Google إلى الخلفية السحابية.
سلامة النظام - مقاييس الشريك إلى Google: تقيس سلامة المكالمات من نظامك إلى Google.
سلامة الجهاز - دقة الحالة: تقيس هذه السمة دقة الحالات المخزّنة في أنظمة Google والتي تُستخدم للرد على طلبات المستخدمين.
عندما لا تستوفي المقاييس القيم المستهدَفة، يتم تمييزها باللون الأحمر للإشارة إلى مشكلة قد تؤثّر في تجربة المستخدم. تقدّم المعلومات التالية تفاصيل عن كل هدف وأهميته للمستخدمين.
مقاييس "شركاء Google"
يقيس مقياس نسبة نجاح الطلبات/التنفيذ >=%99.5 عدد المرات التي يتم فيها تنفيذ طلبات المستخدمين بشكل صحيح، ما يساعد في تجنُّب ردود "مساعد Google" مثل "لا يمكنني الوصول إلى الجهاز" أو التأكيد بشكل غير صحيح على طلب لم يتم تنفيذه.
ما الذي يحدّد حالة "نجاح"؟
يتم وضع علامة "ناجحة" على المعاملة إذا تلقّت منصة Google Home ردًا صالحًا يشير إلى أنّه تم تنفيذ الإجراء المطلوب أو تم استرداد الحالة المطلوبة.
يتم احتساب الاستجابات التي تتضمّن استثناءات غير حظر (على سبيل المثال، الحالة SUCCESS مصحوبة بالاستثناء lowBattery) كمعاملات ناجحة.
وصل الأمر إلى الجهاز وتم تنفيذ الطلب على الرغم من ظهور التحذير.
ما الذي يحدّد حالة "تعذُّر"؟
تُعتبر الأخطاء التي تم العثور عليها في رموز الأخطاء الشائعة في المنصات وتم تصنيفها على أنّها تتطلّب إجراءً من الشريك "عمليات غير ناجحة" عند احتساب معدّلات النجاح في QUERY وEXECUTE.
يقيس المقياس وقت الاستجابة لطلب البحث/التنفيذ (p90) <= 1000 ملي ثانية وقت انتظار الإجراء المطلوب ويساعد في ضمان عدم اضطرار المستخدمين إلى الانتظار لفترة طويلة، مثل الانتظار لبضع ثوانٍ لإطفاء الضوء.
مقاييس وقت الاستجابة
يُعدّ وقت الاستجابة مؤشرًا مهمًا على مدى سرعة استجابة عملية الدمج للمستخدم النهائي. تتتبّع لوحة البيانات وقت الاستجابة عند الشريحة المئوية التسعين (P90)، والذي يمثّل تجربة المستخدمين "الأبطأ" (على سبيل المثال، يعني P90 البالغ 800 ملي ثانية أنّه يتم تلقّي% 90 من الطلبات في 800 ملي ثانية أو أقل).
تقيس Google وقت الاستجابة بشكل مختلف عند التحقّق من الحالة مقارنةً بأوامر الجهاز لضمان الدقة الفنية.
1. وقت استجابة طلب البحث (استفهامي)
يقيس هذا المقياس وقت الاستجابة Cloud-to-cloud عندما تطلب Google الحالة الحالية لجهاز.
- البداية: ترسل Google طلب
action.devices.QUERYإلى عنوان URL الخاص بخدمة التنفيذ. - فترة القياس: هي الوقت الذي يستغرقه خادمك السحابي في تلقّي استجابة HTTP الكاملة ومعالجتها وإرسالها مرة أخرى إلى Google.
- النهاية: تتلقّى Google حمولة الاستجابة النهائية وتؤكّد استلامها من خدمتك.
2. وقت استجابة EXECUTE (الإجراء)
يقيس هذا المقياس وقت تأكيد استلام الأمر عندما ترسل Google طلب تحكّم إلى أحد الأجهزة.
- البداية: ترسل Google طلب
action.devices.EXECUTEإلى عنوان URL الخاص بخدمة التنفيذ. - فترة القياس: هي الوقت الذي يستغرقه السحابة الإلكترونية لتلقّي الأمر وإرجاع ردّ إقرار.
- وقت الانتهاء: تتلقّى Google الردّ الذي يتضمّن الحالة
SUCCESSأوPENDINGأوOFFLINE. - النطاق الفني: يقيس هذا المقياس وقت "إقرار الاستلام" بين سحابة Google وسحابتك. ولا تقيس هذه المقاييس الوقت الذي تستغرقه الأجهزة المادية (مثل المصباح الكهربائي) لإكمال تغيير الحالة المادية، لأنّ ذلك غالبًا ما يتضمّن وقت استجابة شبكة متداخلة محلية خارج مسار الاتصال بين السحابتين.
سلامة النظام - مقاييس الشريك إلى Google
يساعد الحفاظ على معدّل نجاح أكبر من أو يساوي%99.5 في ضمان صحة حالات الأجهزة في Google Home، وإضافة الأجهزة وإزالتها، وتشغيل عمليات التشغيل الآلي، وظهور أحداث السجلّ في علامة التبويب "النشاط" في Google Home app (GHA).
يتم احتساب "معدّل النجاح" استنادًا إلى رموز استجابة HTTP التي تعرضها Google عند إرسال تحديثات الحالة من السحابة الإلكترونية. لضمان عدم معاقبة الشركاء على مشاكل البنية الأساسية من جهة Google، يستبعد المقياس الأخطاء الداخلية في Google من عدد الأخطاء.
ما الذي يحدّد حالة "نجاح"؟
- 2xx (تمت العملية بنجاح): تلقّى Home Graph تعديل الحالة وعالجه بنجاح.
ما الذي يحدّد حالة "تعذُّر"؟
- 4xx (خطأ الشريك): تمثّل هذه الرموز حالات تعذُّر وتشير إلى مشكلة في الطلب المُرسَل من السحابة الإلكترونية. تشمل الرموز الشائعة ما يلي:
- 400 Bad Request: تعذّر على الخادم معالجة الطلب بسبب صياغة غير صالحة. تشمل الأسباب الشائعة JSON غير صالح أو استخدام قيمة فارغة بدلاً من "" لقيمة السلسلة.
- 404 لم يتم العثور على الصفحة: يتعذّر العثور على المورد المطلوب. يعني ذلك عادةً أنّه يتعذّر على Google العثور على الجهاز المطلوب. وقد يعني ذلك أيضًا أنّ حساب المستخدم غير مرتبط أو تم تلقّي
agentUserIdغير صالح. تأكَّد من أنّagentUserIdيتطابق مع القيمة المقدَّمة في ردّ SYNC وأنّك تعالج نواياDISCONNECTبشكل صحيح. - 429 Resource Exhausted: تجاوزت عملية الدمج الحصة المخصّصة لها. اطّلِع على التعليمات في القسم "الخطوة 1" في أعلى لوحة البيانات لمعرفة كيفية إدارة الحصة.
سلامة الجهاز - دقة الحالة
يساعد استيفاء معيار دقة الحالة >=%99.5 أو تجاوزه في ضمان حصول المستخدمين على نتائج صحيحة عند عرض حالات الأجهزة أو استخدام ميزات الذكاء الاصطناعي، مثل "اسأل Google Home". إذا كانت دقة الحالة منخفضة، قد لا يتم تشغيل عمليات التشغيل الآلي وقد لا تظهر إدخالات السجلّ في علامة التبويب "النشاط" الخاصة بـ GHA في الوقت المناسب. لمزيد من المعلومات، يُرجى الاطّلاع على حالة التقرير.
تتتبّع لوحة بيانات الجودة هذه البيانات كل ساعة باستخدام مقياسَين مختلفَين: الدقة الإجمالية وأدنى مجموعة من الأنواع/السمات.
1. مكوّنات الدقة
يتم استخلاص المقياس من "عيّنات" يمكن فيها لـ Google التحقّق من الحالة المُبلغ عنها مقارنةً بنتيجة هدف معروف.
2. مقاييس لوحة البيانات (الاحتساب كل ساعة)
تحتسب لوحة البيانات الدقة استنادًا إلى فترة زمنية مدتها ساعة واحدة. إذا كان عدد العيّنات الإجمالي في الساعة أقل من 100 عيّنة (S_Total < 100)، يتم ضبط دقة تلك الساعة على لا ينطبق.
طريقة العرض 1: الدقة الإجمالية (المتوسط العالمي)
يمثّل هذا المقياس إجمالي دقة عملية الدمج على جميع أنواع الأجهزة والسمات معًا. تقدّم هذه السمة متوسطًا مرجّحًا لحالة النظام المتكامل بأكمله.
- طريقة الاحتساب: إجمالي دقة الحالة على جميع الأجهزة / إجمالي عدد الحالات على جميع الأجهزة
طريقة العرض 2: أقل مجموعة من النوع/السمة
يحدّد هذا الحقل الفئة المحدّدة الأقل موثوقية في عملية الدمج. ويمنع هذا الإعداد الأجهزة ذات مستوى الصوت المرتفع والجودة العالية من إخفاء الأجهزة ذات مستوى الصوت المنخفض والجودة المنخفضة. على سبيل المثال، إذا كان لديك عدد كبير من الأضواء التي تتجاوز دقة الحالة فيها% 99.5، ولكن عدد قليل من المفاتيح التي تكون دقة الحالة فيها منخفضة، يشير ذلك إلى التحسين المطلوب على المفاتيح التي قد لا تظهر في القيمة المتوسطة.
- الاحتساب: الحدّ الأدنى من دقة الولاية / إجمالي الولاية لجميع مجموعات السمة/الجهاز