Google Home Vitals (السحابة الإلكترونية)

تساعدك هذه المجموعة من لوحات البيانات والتنبيهات في الحفاظ بشكل استباقي على تكامل عالي الجودة مع منظومة Google Home المتكاملة. تلتزم Google بتقديم الدعم للشركاء في تطوير منظومة متكاملة عالية الجودة لجميع العملاء

تتضمّن لوحة البيانات ثلاثة أقسام، يغطّي كل منها جزءًا رئيسيًا يساهم في جودة عملية الدمج بشكل عام.

  1. مقاييس Google إلى الشريك: تقيس هذه المقاييس سلامة عمليات نقل البيانات من Google إلى الخلفية السحابية.

  2. سلامة النظام - مقاييس الشريك إلى Google: تقيس سلامة المكالمات من نظامك إلى Google.

  3. سلامة الجهاز - دقة الحالة: تقيس هذه السمة دقة الحالات المخزّنة في أنظمة Google والتي تُستخدم للردّ على طلبات المستخدمين.

عندما لا تستوفي المقاييس القيم المستهدَفة، يتم تمييزها باللون الأحمر للإشارة إلى مشكلة قد تؤثّر في تجربة المستخدم. تقدّم المعلومات التالية تفاصيل عن كل هدف وأهميته للمستخدمين.

إذا لم ينقلك الزر التالي مباشرةً إلى لوحة البيانات، يمكنك الوصول إليها من خلال اختيار صفحة نظرة عامة، ثم لوحات البيانات، ثم اختيار لوحة بيانات Google Home Vitals من قائمة لوحات البيانات الخاصة بي لعرض لوحة البيانات.

الانتقال إلى لوحة البيانات

مقاييس "من Google إلى الشريك"

يقيس مقياس معدّل نجاح الطلب/التنفيذ >=%99.5 عدد المرات التي يتم فيها تنفيذ طلبات المستخدمين بشكل صحيح، ما يساعد في تجنُّب ردود "مساعد Google" مثل "لا يمكنني الوصول إلى الجهاز" أو التأكيد بشكل غير صحيح على طلب لم يتم تنفيذه.

ما الذي يحدّد حالة "نجاح"؟

يتم وضع علامة "ناجحة" على المعاملة إذا تلقّت منصة Google Home ردًا صالحًا يشير إلى أنّه تم تنفيذ الإجراء المطلوب أو تم استرداد الحالة المطلوبة.

يتم احتساب الاستجابات التي تتضمّن استثناءات غير حظر (على سبيل المثال، الحالة SUCCESS مصحوبة بالاستثناء lowBattery) كمعاملات ناجحة. وصل الأمر إلى الجهاز وتم تنفيذ الطلب على الرغم من ظهور التحذير.

ما الذي يحدّد حالة "تعذُّر"؟

تُعدّ الأخطاء التي تم العثور عليها في رموز الأخطاء الشائعة في المنصات والمصنّفة على أنّها تتطلّب إجراءً من الشريك "حالات تعذّر" عند احتساب معدّلات النجاح في طلبات البحث والتنفيذ.

يقيس مقياس وقت الاستجابة لطلب البحث/التنفيذ (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 وسحابتك. ولا تقيس هذه المقاييس الوقت الذي يستغرقه الجهاز المادي (مثل المصباح الكهربائي) لإكمال تغيير الحالة المادية، لأنّ ذلك غالبًا ما يتضمّن وقت استجابة شبكة متداخلة محلية خارج مسار السحابة الإلكترونية إلى السحابة الإلكترونية.

خيارات تقليل وقت الاستجابة

اقتراحات معمارية بشأن التوجيه الجغرافي

إذا لم يكن تنفيذ Anycast IP ممكنًا، ننصحك بالبدائل الفعّالة من حيث التكلفة التالية لضمان أن يتلقّى المستخدمون الخدمة من أقرب مركز بيانات إقليمي.

  1. موازنة الحمل الشاملة (GLB)

    بدلاً من التوجيه الثابت، استخدِم موازن حمل التطبيقات العالمية (المتاحة من معظم موفّري الخدمات السحابية الرئيسيين).

    • طريقة العمل: يمكنك ضبط نقطة دخول شاملة واحدة (عنوان URL) تقع على حافة الشبكة. يرصد موازن التحميل تلقائيًا المصدر الجغرافي للطلب من مجموعات التنفيذ في Google، ويوجه الزيارات إلى الخلفية السليمة الإقليمية الأقرب إليك.

    • الميزة: يوفّر ذلك أداءً أفضل لبروتوكول Anycast مع تقليل كبير في تعقيد الإعداد والتكلفة.

  2. نظام أسماء النطاقات الذي يرصد الموقع الجغرافي (GeoDNS)

    • طريقة العمل: اضبط مزوّد نظام أسماء النطاقات (DNS) للتعامل بشكل نهائي مع عنوان URL الخاص بتنفيذ الطلب إلى عناوين IP مختلفة استنادًا إلى الموقع الجغرافي لطلب بحث لنظام أسماء النطاقات.

    • التنفيذ: تأكَّد من أنّ مزوّد نظام أسماء النطاقات (DNS) مُحسَّن لنقاط الخروج من Google. عندما تحلّ خدمات التنفيذ الإقليمية من Google (على سبيل المثال، في الولايات المتحدة أو الاتحاد الأوروبي أو آسيا) نطاقك، ستتلقّى عنوان IP لمركز البيانات في تلك المنطقة المحدّدة.

استراتيجيات التحسين على مستوى طبقة التطبيق

بالإضافة إلى التوجيه على مستوى البنية الأساسية، يمكنك تنفيذ الاستراتيجيات التالية على مستوى التطبيق لتقليل وقت الاستجابة عند معالجة الطلبات.

  1. طريقة الخادم الوكيل "القفز"

    إذا كان عليك الاحتفاظ بمركز بيانات أساسي، استخدِم خوادم وكيل إقليمية خفيفة الوزن (Trampolines) للتعامل مع المصافحة الأولية.

    1. يرسل Google طلبًا إلى عنوان URL العالمي.

    2. يتلقّى الطلب وكيل إقليمي (على سبيل المثال، دالة Nginx أو Lambda خفيفة الوزن).

    3. يعيد الخادم الوكيل توجيه الحمولة عبر شبكة أساسية داخلية عالية السرعة إلى قاعدة البيانات الأساسية.

    الميزة: يؤدي ذلك إلى تقليل وقت "مصافحة TCP"، وهو غالبًا أكبر عامل يساهم في وقت الاستجابة للطلبات التي يتم إرسالها من مسافات بعيدة.

  2. تلميحات حول منطقة رمز الدخول المميز

    أثناء عملية ربط الحساب (OAuth)، يمكن لنظامك تحديد المنطقة الرئيسية للمستخدم.

    التنفيذ: ترميز معرّف منطقة في access_token الذي تم إصداره إلى Google عندما ترسل 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 Home". إذا كانت دقة الحالة منخفضة، قد لا يتم تشغيل عمليات التشغيل الآلي وقد لا تظهر إدخالات السجلّ في علامة التبويب "النشاط" الخاصة بـ GHA في الوقت المناسب. لمزيد من المعلومات، يُرجى الاطّلاع على حالة التقرير.

تتتبّع لوحة بيانات الجودة هذه البيانات كل ساعة باستخدام مقياسَين مختلفَين: الدقة الإجمالية وأدنى مجموعة من الأنواع/السمات.

1. مكوّنات الدقة

يتم استخلاص المقياس من "عيّنات" يمكن فيها لـ Google التحقّق من الحالة المُبلغ عنها مقارنةً بنتيجة هدف معروف.

2. مقاييس لوحة البيانات (الاحتساب كل ساعة)

تحتسب لوحة البيانات الدقة استنادًا إلى فاصل زمني مدته ساعة واحدة. إذا كان عدد العيّنات الإجمالي في الساعة أقل من 100 عيّنة (S_Total < 100)، يتم ضبط دقة تلك الساعة على غير متوفّرة.

طريقة العرض 1: الدقة الإجمالية (المتوسط العالمي)

يمثّل ذلك إجمالي دقة عملية الدمج على جميع أنواع الأجهزة والسمات المجمّعة. تقدّم هذه السمة متوسطًا مرجّحًا لسلامة النظام المتكامل بأكمله.

  • طريقة الاحتساب: إجمالي دقة الحالة على جميع الأجهزة / إجمالي عدد الحالات على جميع الأجهزة

طريقة العرض 2: أقل مجموعة من النوع/السمة

يحدّد هذا الحقل الفئة المحدّدة الأقل موثوقية في عملية الدمج. ويمنع ذلك الأجهزة ذات مستوى الصوت العالي والجودة العالية من إخفاء الأجهزة ذات مستوى الصوت المنخفض والجودة المنخفضة. على سبيل المثال، إذا كان لديك عدد كبير من الأضواء التي تتجاوز دقة الحالة فيها% 99.5، ولكن لديك عدد قليل من المفاتيح التي تتسم بدقة الحالة المنخفضة، يشير ذلك إلى التحسين المطلوب على المفاتيح التي قد يتم فقدانها في قيمة متوسطة.

  • الاحتساب: الحدّ الأدنى من دقة الولاية / إجمالي الولاية لجميع مجموعات السمة/الجهاز