تساعدك هذه المجموعة من لوحات البيانات والتنبيهات في الحفاظ بشكل استباقي على تكامل عالي الجودة مع منظومة Google Home المتكاملة. تلتزم Google بتقديم الدعم للشركاء في تطوير منظومة متكاملة عالية الجودة لجميع العملاء
تتضمّن لوحة البيانات ثلاثة أقسام، يغطّي كل قسم جزءًا رئيسيًا يساهم في جودة عملية الدمج بشكل عام.
مقاييس Google إلى الشريك: تقيس هذه المقاييس سلامة عمليات الربط بين Google والخادم الخلفي المستند إلى السحابة الإلكترونية.
سلامة النظام - مقاييس الشريك إلى Google: تقيس سلامة المكالمات من نظامك إلى Google.
سلامة الجهاز - دقة الحالة: تقيس هذه الميزة دقة الحالات المخزّنة في أنظمة Google والتي تُستخدم للرد على طلبات المستخدمين.
عندما لا تستوفي المقاييس القيم المستهدَفة، يتم تمييزها باللون الأحمر للإشارة إلى مشكلة قد تؤثّر في تجربة المستخدم. تقدّم المعلومات التالية تفاصيل عن كل استهداف وسبب أهميته للمستخدمين.
مقاييس "من Google إلى الشريك"
يقيس مقياس معدّل نجاح الطلب/التنفيذ >=%99.5 عدد المرات التي يتم فيها تنفيذ طلبات المستخدمين بشكل صحيح، ما يساعد في تجنُّب ردود "مساعد Google" مثل "لا يمكنني الوصول إلى الجهاز" أو التأكيد بشكل غير صحيح على طلب لم يتم تنفيذه.
ما الذي يحدّد حالة "نجاح"؟
يتم وضع علامة "ناجحة" على المعاملة إذا تلقّت منصة Google Home ردًا صالحًا يشير إلى أنّه تم تنفيذ الإجراء المطلوب أو تم استرداد الحالة المطلوبة.
يتم احتساب الاستجابات التي تتضمّن استثناءات غير حظر (على سبيل المثال، الحالة SUCCESS مصحوبة بالاستثناء lowBattery) كمعاملات ناجحة.
وصل الأمر إلى الجهاز وتم تنفيذ الطلب على الرغم من ظهور التحذير.
ما الذي يحدّد حالة "تعذُّر"؟
تُعدّ الأخطاء التي تم العثور عليها في رموز الأخطاء الشائعة في المنصات والمصنّفة على أنّها تتطلّب إجراءً من الشريك "عمليات غير ناجحة" عند احتساب معدّلات النجاح في QUERY وEXECUTE.
يقيس المقياس وقت الاستجابة لطلب البحث/التنفيذ (p90) <= 1000 ملي ثانية وقت انتظار الإجراء المطلوب ويساعد في ضمان عدم اضطرار المستخدمين إلى الانتظار لفترة طويلة، مثلاً، الانتظار لبضع ثوانٍ لإطفاء الضوء.
مقاييس وقت الاستجابة
يُعدّ وقت الاستجابة مؤشرًا مهمًا على مدى سرعة استجابة عملية الدمج للمستخدم النهائي. تتتبّع لوحة البيانات وقت الاستجابة في الشريحة المئوية التسعين (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 من عدد الأخطاء. يمكن العثور على طلبات البيانات من واجهة برمجة التطبيقات المضمّنة في عملية الاحتساب في مرجع HomeGraph API.
ما الذي يحدّد حالة "نجاح"؟
- 2xx (تمت العملية بنجاح): تلقّى Home Graph تعديل الحالة وعالجه بنجاح.
ما الذي يحدّد حالة "تعذُّر"؟
- 4xx (خطأ الشريك): تمثّل هذه الرموز حالات تعذُّر وتشير إلى مشكلة في الطلب المُرسَل من السحابة الإلكترونية. تشمل الرموز الشائعة ما يلي:
- 400 Bad Request: تعذّر على الخادم معالجة الطلب بسبب صياغة غير صالحة. تشمل الأسباب الشائعة JSON غير صالح أو استخدام قيمة فارغة بدلاً من "" لقيمة السلسلة.
- 404 Not Found: يتعذّر العثور على المورد المطلوب. يعني هذا عادةً أنّه لا يمكن لـ Google العثور على الجهاز المطلوب. وقد يعني ذلك أيضًا أنّ حساب المستخدم غير مرتبط أو تم تلقّي
agentUserIdغير صالح. تأكَّد من أنّagentUserIdتتطابق مع القيمة المقدَّمة في ردّ SYNC وأنّك تعالج أغراضDISCONNECTبشكل صحيح. - 429 Resource Exhausted: تجاوزت عملية الدمج الحصة المخصّصة لها. اطّلِع على التعليمات في القسم "الخطوة 1" في أعلى لوحة البيانات لمعرفة كيفية إدارة الحصة.
سلامة الجهاز - دقة الحالة
يساعد استيفاء معيار دقة الحالة >=%99.5 أو تجاوزه في ضمان حصول المستخدمين على نتائج صحيحة عند عرض حالات الأجهزة أو استخدام ميزات الذكاء الاصطناعي، مثل "اسأل Google". إذا كانت دقة الحالة منخفضة، قد لا يتم تشغيل عمليات التشغيل الآلي وقد لا تظهر إدخالات السجلّ في علامة التبويب "النشاط" الخاصة بـ GHA في الوقت المناسب. لمزيد من المعلومات، يُرجى الاطّلاع على حالة التقرير.
تتتبّع لوحة بيانات الجودة هذه البيانات كل ساعة باستخدام مقياسَين مختلفَين: الدقة الإجمالية وأدنى مجموعة من الأنواع/السمات.
1. مكوّنات الدقة
يتم استخلاص المقياس من "عيّنات" يمكن فيها لـ Google التحقّق من الحالة المُبلغ عنها مقارنةً بنتيجة معروفة للنية.
2. مقاييس لوحة البيانات (الاحتساب كل ساعة)
تحتسب لوحة البيانات الدقة استنادًا إلى فاصل زمني مدته ساعة واحدة. إذا كان عدد العيّنات الإجمالي في الساعة أقل من 100 عيّنة (S_Total < 100)، يتم ضبط دقة تلك الساعة على غير متوفّرة.
طريقة العرض 1: الدقة الإجمالية (المتوسط العالمي)
يمثّل ذلك إجمالي دقة عملية الدمج على جميع أنواع الأجهزة والسمات معًا. تقدّم هذه السمة متوسطًا مرجّحًا لسلامة النظام المتكامل بأكمله.
- طريقة الاحتساب: إجمالي دقة الحالة على جميع الأجهزة / إجمالي عدد الحالات على جميع الأجهزة
طريقة العرض 2: أقل مجموعة من النوع/السمة
يحدّد هذا الحقل الفئة المحدّدة الأقل موثوقية في عملية الدمج. ويمنع ذلك الأجهزة ذات مستوى الصوت العالي والجودة العالية من إخفاء الأجهزة ذات مستوى الصوت المنخفض والجودة المنخفضة. على سبيل المثال، إذا كان لديك عدد كبير من الأضواء التي تتجاوز دقة الحالة فيها% 99.5، ولكن عدد قليل من المفاتيح التي تكون دقة الحالة فيها منخفضة، يشير ذلك إلى التحسين المطلوب على المفاتيح التي قد يتم فقدانها في قيمة متوسطة.
- الاحتساب: الحدّ الأدنى من دقة الولاية / إجمالي الولاية لجميع مجموعات السمة/الجهاز