1. قبل البدء
تم تصميم هذا الدرس التطبيقي حول الترميز لشركاء ومطوّري Google Home الذين يستخدمون عمليات الدمج مع السحابة الإلكترونية لتحسين جودة المنظومة المتكاملة وتجربة المستخدم.
أهداف الدورة التعليمية
تعمل لوحة بيانات "مؤشرات Google Home الحيوية" كمصدر مركزي موثوق للمطوّرين والشركاء لمراقبة سلامة عمليات دمج Google Home. في نظام بيئي يتم فيه تحديد تجربة المستخدم من خلال وقت الاستجابة والموثوقية، فإنّ Google Home Vitals هي بوابة الخدمة الذاتية التي تحتوي على جميع الإحصاءات التفصيلية اللازمة للانتقال من تحديد المشاكل وحلّها بشكل تفاعلي إلى إدارة الجودة بشكل استباقي.
- كيفية احتساب تقييم جودة عملية الدمج
- كيفية قراءة لوحة البيانات واستخدامها
- كيفية تصحيح أخطاء المقاييس ذات الجودة المنخفضة
المتطلبات
- أن يكون لديك حساب Google Home Cloud Integration
الإعداد
كيفية الانتقال إلى "لوحة بيانات Google Home Vitals":
- فتح Google Cloud Platform
- المراقبة > لوحة البيانات
- انقر على لوحة بيانات "Google Home Vitals (السحابة الإلكترونية)".
2. كيفية قراءة لوحة البيانات
احتساب "تقييم الجودة" - معيار "جيد" مقابل معيار "ضعيف"
توضّح لوحة البيانات تفاصيل تقسيم نتائج الجودة. يتم تحديد تقييمات الجودة على مستوى دقة نوع الجهاز. لكي يتم تصنيف عملية دمج نوع الجهاز على أنّها جيدة، يجب أن تستوفي أربعة معايير متزامنة:
- معدّل النجاح العالمي: يجب أن يكون معدّل نجاح المكالمات بين الشريك وGoogle أكبر من أو يساوي %99.5.
ملاحظة: يؤدي عدم استيفاء معدّل النجاح العالمي (أكبر من أو يساوي %99.5) إلى الحصول تلقائيًا على التقييم سيئ في المشروع بأكمله، بغض النظر عن أداء الجهاز الفردي. - موثوقية الأوامر: يجب أن تكون معدّلات نجاح QUERY وEXECUTE أكبر من أو تساوي% 99.5 لكل نوع جهاز.
- وقت الاستجابة السريع: يجب أن يكون وقت الاستجابة في الشريحة المئوية التسعين لطلبات البحث والتنفيذ أقل من أو يساوي 1,000 ملي ثانية لكل نوع جهاز.
- صحة البيانات على مستوى الولاية: يجب أن تكون دقة البيانات على مستوى الولاية %99.5 أو أكثر.
أهمية هذه المقاييس
- معدّل النجاح العام: تقيس المكالمات من الشريك إلى Google على مستوى الدمج مدى سلامة المكالمات من السحابة الإلكترونية إلى Google. يضمن معدّل النجاح الذي يبلغ 99.5% أو أكثر أن تستخدم Google Home حالات الجهاز الصحيحة. وتشمل بعض الأمثلة التأكّد من إضافة الأجهزة وإزالتها، وتفعيل عمليات التشغيل الآلي، وظهور أحداث السجلّ في علامة التبويب "النشاط" في تطبيق Google Home.
- موثوقية الأوامر: يتم قياس معدّلات نجاح طلبات البحث والتنفيذ على مستوى نوع الجهاز، ويضمن معدّل النجاح الذي يبلغ 99.5% أو أكثر تنفيذ أوامر المستخدم بشكل صحيح (أي تجنُّب ردود "مساعد Google"، مثل "لا يمكنني الوصول إلى الجهاز" أو تأكيد أمر لم يتم تنفيذه بشكل غير صحيح).
- وقت الاستجابة السريع: يتم أيضًا قياس وقت استجابة QUERY وEXECUTE على مستوى نوع الجهاز، ويضمن وقت الاستجابة الذي يبلغ <=1000 ملي ثانية لكل نوع جهاز ألا يضطر المستخدم إلى الانتظار طويلاً لتنفيذ الإجراء المطلوب (أي الانتظار لبضع ثوانٍ لإطفاء الضوء).
- سلامة الحالة: تقيس "دقة الحالة" دقة الحالة المخزَّنة في أنظمة Google والمستخدَمة للردّ على طلبات بحث المستخدمين. إذا كانت هذه الأرقام منخفضة، قد تظهر للمستخدمين نتائج غير صحيحة لأجهزتك عند عرض حالة جهازك أو استخدام ميزات الذكاء الاصطناعي، مثل "اسأل Google Home". قد لا يتم تشغيل عمليات التشغيل الآلي وقد لا تظهر إدخالات السجلّ في "النشاط" في الوقت المناسب.
كيفية قراءة لوحة البيانات
ابدأ في قسم "مقاييس نقاط الجودة" الذي يعمل كمؤشر أساسي لحالة عملية الدمج. يعتمد التقييم الجيّد على مستوى الجهاز على استيفاء جميع المقاييس الواردة في هذا القسم لمعايير النجاح باللون الأخضر. تتوفّر المتطلبات الفنية التفصيلية وتعريفات المقاييس في مستندات "مركز المطوّرين".
يعكس قسم "نتيجة مقاييس الجودة" في أعلى لوحة بيانات "مؤشرات Google Home الحيوية" المقاييس المستخدَمة لاحتساب نتيجة جودة عملية الدمج.
تسمية توضيحية
- أخضر (جيد): يستوفي المقياس الحدّ الأدنى للجودة.
- أحمر (ضعيف): لا يستوفي المقياس الحدّ الأدنى للجودة.
مثال
في المثال أدناه، يمكنك ملاحظة أنّ نوع الجهاز AC_UNIT يستوفي معايير الجودة في قسمَي "معدّل نجاح طلب البحث" و"معدّل نجاح التنفيذ" بالإضافة إلى قسم "وقت استجابة طلب البحث"، ولكنّه لا يستوفي شريط "وقت استجابة التنفيذ" (أحمر). وهذا يعني أنّ الأوامر تنجح بمعدّل مقبول، ولكنّ وقت استجابة EXECUTE أبطأ بمقدار 36 ملي ثانية. يعرض قسم "سلامة النظام" معدّل تعذُّر بنسبة% 98.92 للطُرق المجمّعة على مستوى عملية الدمج، ما يعني أنّ هناك مجالًا للتحسين لضمان دقة حالات أجهزة المستخدمين في Google Home. يعني ذلك أنّ% 1.08 من المكالمات (DeleteAgentUser أو Query أو ReportStateAndNotification أو RequestSyncDevices أو Sync) تعرض رموز استجابة لا تساوي 2xx أو 5xx (مثل أخطاء 404). المقياس الأخير المستخدَم لقياس جودة النجاح/الفشل لنوع الجهاز AC_UNIT هو دقة الحالة. في هذا المثال، نرى معدل نجاح يبلغ% 77.43، ما يعني أنّه من المحتمل أن يرى المستخدمون نتائج غير دقيقة للأجهزة. باستخدام هذه المقاييس الثلاثة، تكون النتيجة الإجمالية لـ AC_UNIT هي POOR وأقل من حد الجودة.
يتوافق كل من عمليات احتساب الجودة هذه مع قسم تصحيح الأخطاء أدناه. افتح الخطوات المصغّرة لتحديد المشاكل وحلّها بشكل أكبر.
لتصحيح أخطاء معدّلات النجاح ووقت الاستجابة في QUERY/EXECUTE، انتقِل إلى "الخطوة 1: التحقّق من صحة طلبات Cloud Calls".
لتصحيح أخطاء معدّلات النجاح من الشريك إلى Google، انتقِل إلى "الخطوة 2: التحقّق من صحة طلبات البيانات من Google".
لتصحيح أخطاء "دقة الحالة" لكل نوع جهاز، انتقِل إلى "الخطوة 3: تحسين دقة الحالة".
3- الخطوة 1 لتحديد المشاكل وحلّها: التحقّق من صحة مكالمات Cloud
الخطوة 1: نظرة عامة
يركّز هذا القسم على "المكالمات السحابية"، وهي المقاييس التي تقيس سلامة الاتصالات من Google إلى الخلفية السحابية (المعروفة أيضًا باسم مقاييس Google-to-Partner). ويشمل ذلك أوامر مثل طلب البحث وتنفيذ.
نتتبّع معدّلات النجاح ومدة الاستجابة لكلّ من QUERY وEXECUTE (وهي عوامل تؤثّر في نقاط جودة نوع الجهاز).
تعرض النظرة العامة أدناه معدلات النجاح والأخطاء المجمّعة لكل من QUERY وEXECUTE على مستوى الدمج. تعرض الخطوات من 1 (أ) إلى 1 (د) تفاصيل هذه المقاييس على مستوى نوع الجهاز/سماته. 
تعرض الخطوتان 1 (أ) و1 (ب) مؤشر عدد طلبات التنفيذ وعدد الأخطاء بمرور الوقت وحالات الأخطاء المحدّدة.
الخطوة 1 (أ): مراجعة أخطاء الطلبات
الخطوة 1 (ب): مراجعة أخطاء التنفيذ
تعرض الخطوتان 1(ج) و1(د) تفاصيل الشريحة المئوية التسعين والخمسين لهذه المقاييس أيضًا على مستوى كل من عملية الدمج ونوع الجهاز.
الخطوة 1(ج): مراجعة وقت استجابة طلب البحث
الخطوة 1d: مراجعة وقت استجابة التنفيذ
4. الخطوة 2 من تصحيح الأخطاء: التحقّق من صحة الطلبات المُرسَلة إلى Google
الخطوة 2: نظرة عامة
بعد تصحيح أخطاء المكالمات من Google إلى الشريك، تغطي هذه الخطوة الثانية تصحيح أخطاء المكالمات من السحابة الإلكترونية للشريك إلى Google. يغطّي هذا القسم المقاييس على مستوى تكامل الشريك، وليس على مستوى نوع الجهاز، ويشمل رموز الاستجابة، مثل 400 Bad Request و404 Not Found و429 Resource Exhausted.
الخطوة 2 (أ): تصحيح أخطاء مشاكل الحصة
يفرض Google Home حدودًا على تخصيص الموارد واستخدامها، كما يفرض حصصًا مناسبة على أساس كل مشروع. تفرض Google الحدّ التلقائي البالغ 6,000 طلب كل 60 ثانية على مجموع طلبات البحث والحذف و"تقرير الحالة" ومزامنة الطلبات غير المتزامنة من خلال طلبات البيانات من واجهة برمجة التطبيقات، وذلك على أساس كل عملية دمج من السحابة الإلكترونية إلى السحابة الإلكترونية.
يمكن أن تؤثر مشاكل الحصة سلبًا في دقة حالة التقرير لأنّ عدم إكمال تعديل الحالة قد يؤدي إلى عدم تطابق. في ما يلي رسومات بيانية تتضمّن تفاصيل تعرض على وجه التحديد "حالة التقرير" و"أخطاء مزامنة الطلبات"، بالإضافة إلى تفاصيل طريقة عمل واجهة برمجة التطبيقات من حيث العدد والأخطاء ونسبة استخدام الحصة. إذا كانت هذه الرسومات البيانية تعرض زيادة غير متوقّعة في عدد الزيارات، راجِع عملية الدمج لتحديد ما إذا كان هناك تغيير يتسبّب في إرسال المزيد من الزيارات إلى Home Graph API.
في بعض السيناريوهات، مثل النمو الطبيعي لعدد الزيارات بمرور الوقت (على سبيل المثال، يكون النمو متوافقًا مع زيادة عدد الأجهزة أو إطلاق نوع جديد من الأجهزة أو أي عملية إطلاق أخرى متوقّعة)، قد يكون من المناسب زيادة الحصة المخصّصة لعملية الدمج. لطلب زيادة الحصة، اتّبِع الخطوات الواردة في مستندات المطوّرين.
5- الخطوة 3 من تصحيح الأخطاء: تحسين دقة الحالة
الخطوة 3: نظرة عامة
بعد تصحيح أخطاء الخطوتين 1 و2، تغطي الخطوة 3 دقة حالة التقرير، أي حالات الجهاز المخزّنة في أنظمة Google، والتي تُستخدَم للردّ على طلبات المستخدمين. تظهر أدناه التصنيفات حسب السمة ونوع الجهاز. تتناول الخطوتان 3 (أ) و3 (ب) خطأَين شائعَين في "حالة التقرير"، وهما أخطاء "الحقل المفقود" و"البيانات غير الدقيقة".
الخطوة 3 (أ): أخطاء "الحقل غير متوفر"
تحدث أخطاء "الحقل غير متوفّر" عندما تختلف مجموعة حقول الحمولة بين ردّ QUERY وطلب حالة تم إرسالها لجهاز معيّن. يجب أن تكون مجموعة الحقول ضِمن حمولة كل جهاز هي نفسها. يمكن أن يحدث ذلك إذا اختلفت منطق حساب الحمولة بين استجابة حالة طلب البحث والاستجابة في التقرير. استخدِم الرسوم البيانية أدناه لتتبُّع أنواع الأجهزة وسماتها التي تتضمّن ردودًا غير متطابقة لحالة طلب البحث والتقرير.
الخطوة 3 (ب): أخطاء "غير دقيقة"
تحدث الأخطاء غير الدقيقة عندما تكون مجموعة حقول الحمولة هي نفسها بين ردّ QUERY وطلب حالة تم إرسالها لجهاز معيّن، ولكن تختلف قيم الحالة. قد يحدث ذلك إذا لم يتم تسجيل تقرير حالة أو إذا كانت منطق حساب الحالة يختلف بين QUERY وتقرير الحالة. استخدِم الرسوم البيانية أدناه لتتبُّع أنواع الأجهزة وسماتها التي تتضمّن ردودًا غير متطابقة لحالة طلب البحث والتقرير.
6. المستندات والمراجع الأخرى
- لإرسال ملاحظات أو الإبلاغ عن مشاكل في لوحة البيانات هذه، يُرجى الإبلاغ عن مشكلة في أداة تتبُّع المشاكل المتاحة للجميع.
- لتقديم طلب بإعادة النظر، يُرجى إرسال مشكلة باستخدام نموذج طلب إعادة النظر في مقياس الجودة.
- للبقاء على اطّلاع دائم على جودة عملية الدمج، اضبط تنبيهات Google Cloud Platform لتلقّي إشعارات عندما تنخفض مقاييسك عن الحدّ المقبول. يضمن لك ذلك أن تكون أول من يعلم عند حدوث مشكلة.
- للحصول على جميع المعلومات الأخرى، يُرجى الاطّلاع على مزيد من المعلومات في مستندات المطوّر على الرابط https://developers.home.google.com/tools/analytics/home-vitals