Google Cloud توفّر لك الأدوات اللازمة لمراقبة موثوقية مشاريعك باستخدام Google Cloud Monitoring وتحديد المشاكل وحلّها باستخدام Google Cloud Logging سجلات الأخطاء. عند حدوث أي عطل أثناء تلبية نوايا المستخدمين، تسجِّل قناة Google Home Analytics هذا العطل في مقاييسك، وتنشر سجلّ أخطاء في سجلات مشروعك.
هناك خطوتان لتحديد المشاكل وحلّها في ما يتعلّق بالأخطاء:
- مراقبة حالة مشاريعك باستخدام مقاييس المنزل الذكي
- التحقيق في المشاكل من خلال الاطّلاع على الأوصاف التفصيلية للأخطاء في سجلات الأخطاء
يمكنك اختياريًا اختبار الإجراء من خلال مشاركته مع مستخدمين آخرين. يُرجى التأكّد من معالجة الأخطاء والاستثناءات بشكل مناسب.
مراقبة الأخطاء
يمكنك استخدام Google Cloud Monitoring dashboards للوصول إلى مقاييس مشروعك. في ما يلي بعض الرسوم البيانية الرئيسية المفيدة بشكل خاص لمراقبة الجودة وتحديد المشاكل وحلّها:
- الرسم البياني معدّل النجاح هو أول رسم بياني يجب البدء به عند رصد موثوقية مشاريعك. يمكن أن تشير الانخفاضات في هذا الرسم البياني إلى انقطاع الخدمة لجزء من قاعدة المستخدمين أو كلها. ننصح بمراقبة هذا الرسم البياني عن كثب لرصد أي مخالفات بعد كل تغيير أو تعديل في مشروعك.
- الرسم البياني وقت الاستجابة في المئويّة الخامسة والتسعين هو مؤشر مهم لأداء عملية التكامل Cloud-to-cloud لدى المستخدمين. قد تشير التقلبات المفاجئة في هذا الرسم البياني إلى أنّ أنظمتك قد لا تتمكّن من مواكبة الطلبات. ننصح بالاطّلاع على هذا الرسم البياني بشكل دوري لرصد أي سلوك غير متوقّع.
- تكون الرسوم البيانية تفاصيل الخطأ مفيدة جدًا عند تحديد المشاكل وحلّها في عمليات التكامل. لكل خطأ يتم تمييزه في الرسم البياني لنسبة النجاح، يتم عرض رمز خطأ في تفاصيل الخطأ. يمكنك الاطّلاع على الأخطاء التي تم وضع علامة عليها من قِبل Google Home platform وكيفية تحديد المشاكل وحلّها في الجدول أدناه.
رموز الأخطاء الشائعة في المنصة
في ما يلي بعض رموز الأخطاء الشائعة التي قد تظهر في سجلات مشروعك لتحديد المشاكل التي رصدتها Google Home platform. يُرجى الرجوع إلى الجدول التالي للحصول على معلومات حول تحديد المشاكل وحلّها. للاطّلاع على قائمة كاملة برموز الأخطاء، يُرجى مراجعة الأخطاء والاستثناءات.
| رمز الخطأ | الوصف | الإجراء المطلوب من الشريك |
|---|---|---|
AGENT_ISSUE |
حدثت مشكلة عامة في وكيل السحابة التابع للشريك.
يُرجى التحقّق من عدم وجود استثناءات أو أعطال لم تتم معالجتها في سجلات تلبية الطلبات. |
نعم |
AGENT_UNAVAILABLE_ERROR |
تعذّر على Google الوصول إلى عنوان URL لتلبية الطلبات التابع للشريك.
يُرجى التأكّد من أنّ الخادم متصل بالإنترنت وأنّ جدار الحماية لا يحظر Google وأنّ عنوان URL صحيح. |
نعم |
BACKEND_FAILURE_URL_TIMEOUT |
انتهت مهلة طلب Google أثناء محاولة الوصول إلى خدمتك.
يُرجى التأكّد من أنّ خدمتك متصلة بالإنترنت وتقبل الاتصالات، وليست فوق طاقتها. بالإضافة إلى ذلك، يُرجى التأكّد من أنّ الجهاز المستهدَف قيد التشغيل ومتصل بالإنترنت ومزامَن. |
|
BACKEND_FAILURE_URL_UNREACHABLE |
تلقّت Google رمز خطأ HTTP 5xx من خدمتك.
يُرجى استخدام requestId في Google Cloud Logging للاطّلاع على
سجلات خدمة المنزل الذكي. يُرجى التحقيق في أعطال الخادم أو انتهاء المهلة،
أو أخطاء البوابة 502/503.
|
|
COMMAND_FAILED |
حدث عطل عام أثناء تنفيذ أمر.
يُرجى الاطّلاع على سجلات تلبية الطلبات لمعرفة requestId
للعثور على السبب الجذري.
|
نعم |
EXECUTION_BACKEND_FAILURE_URL_ERROR |
تلقّت Google خطأ HTTP 4xx (غير 401) من عملية تلبية الطلبات.
يُرجى الاطّلاع على سجلات خادم الويب بحثًا عن الردود 403 أو 404 أو 400. |
نعم |
EXECUTION_BACKEND_FAILURE_URL_ROBOTED |
تم حظر عنوان URL لتلبية الطلبات باستخدام ملف robots.txt أو فلاتر الأمان.
يُرجى التأكّد من إمكانية وصول برامج الزحف أو الخدمات من Google إلى نقطة نهاية تلبية الطلبات. |
نعم |
EXECUTION_BACKEND_FAILURE_URL_UNREACHABLE |
تلقّت Google خطأ HTTP 5xx من خدمة تلبية الطلبات.
يُرجى التأكّد من أنّ خدمة عنوان URL لنقطة النهاية مستقرة وصحيحة ويمكن الوصول إليها علنًا وأنّ الخدمة قيد التشغيل. يُرجى إضافة عمليات التحقّق من الحالة ومعالجة عمليات إعادة المحاولة. يُرجى التحقيق في أعطال الخادم أو انتهاء المهلة أو أخطاء البوابة 502/503. |
نعم |
EXECUTION_BAILOUT_INVALID_RESPONSE |
كان ردّ JSON غير صالح لدرجة أدت إلى إيقاف المعالجة.
يُرجى استخدام أداة التحقّق من تنسيق JSON للتأكّد من أنّ ردّك يتّبع بدقة مخططات النوايا. |
نعم |
EXECUTION_GAL_BAD_3P_RESPONSE |
تعذّر ربط الحساب بسبب تنسيق غير صالح في ردّ الرمز المميّز.
يُرجى التأكّد من أنّ تنسيق ردّ خادم OAuth يتطابق مع متطلبات Google. |
نعم |
EXECUTION_GAL_INSUFFICIENT_CAPABILITIES |
لا يتضمّن حساب المستخدم الأذونات اللازمة لهذا الإجراء.
يُرجى التحقّق من النطاقات المطلوبة أثناء OAuth والتأكّد من أنّها تتطابق مع السمات المطلوبة. |
نعم |
EXECUTION_GAL_MAYBE_UNLINKED_BY_3P |
تشير سحابة الشريك إلى أنّ المستخدم قد ألغى ربط حسابه.
يُرجى التأكّد من أنّ عملية ربط agentUserId مستقرة ولم يتمّت إزالتها.
|
نعم |
EXECUTION_GAL_NOT_FOUND |
إنّ رموز الدخول والتحديث الخاصة بالمستخدم والمخزّنة في Google غير صالحة أو
لا يمكن تحديثها، ما يمنع المصادقة والوص01}ول إلى خدمة الشريك.
يُرجى التأكّد من أنّ الرموز المميّزة تظل صالحة ومتزامنة، ومعالجة تغييرات حالة الحساب بشكل مناسب، ومطالبة المستخدمين بإعادة ربط الحساب إذا تم التأكّد من إلغاء الرموز المميّزة. |
نعم |
EXECUTION_GAL_READ_ONLY_MODE_FOR_3P |
التكامل في حالة القراءة فقط من جانب الشريك.
يُرجى التحقّق ممّا إذا كان حساب المستخدم معلّقًا أو في وضع الصيانة "للعرض فقط" |
نعم |
EXECUTION_GAL_UNLINKED_BY_3P |
تم إلغاء ربط الحساب بشكل استباقي من قِبل الخدمة الخارجية.
يُرجى التحقيق في سبب قطع اتصال المستخدم (على سبيل المثال، إعادة ضبط الأمان). يُرجى التأكّد من أنّ خادم OAuth التابع للشريك يستجيب بشكل صحيح لطلبات refresh_token من Google لإصدار رموز دخول جديدة
بسلاسة.
|
نعم |
EXECUTION_INVALID_JSON |
تعذّر على Google تحليل حمولة استجابة JSON.
يُرجى التحقّق من وجود أخطاء في البنية أو أقواس ناقصة أو أحرف غير صالحة في ردّك. |
نعم |
INVALID_AUTH_TOKEN |
تلقّت Google رمز خطأ HTTP 401 من خدمتك.
لم تنتهِ صلاحية رمز الدخول، ولكن خدمتك ألغت صلاحيته. يُرجى استخدام requestId في Google Cloud Logging للاطّلاع على سجلات خدمة المنزل المزوّد بأجهزة ذكية.
|
|
INVALID_JSON |
بنية الردّ غير صالحة (على سبيل المثال، حقول إلزامية غير متوفّرة
).
يُرجى التحقّق من صحة ردّك مقارنةً بـ مخططات JSON للنوايا المخططات. |
نعم |
MALFORMED_JSON |
بنية JSON غير صالحة (على سبيل المثال، سلاسل أو
عناصر غير مغلقة).
يُرجى التأكّد من أنّ عملية تلبية الطلبات تستخدم مكتبة JSON عادية لتسلسل الردود. |
نعم |
NOT_IMPLEMENTED |
لم ينفّذ الشريك النية أو السمة المطلوبة.
يُرجى تضمين السمات التي نفّذتها بالكامل فقط في ردّ SYNC الخاص بك.
|
نعم |
OPEN_AUTH_FAILURE |
انتهت صلاحية رمز دخول المستخدم وتعذّر على Google تحديثه،
أو تلقّت Google رمز خطأ HTTP 401 من خدمتك.
إذا لاحظت زيادة في معدّل ظهور هذا الرمز، يُرجى التحقّق ممّا إذا لاحظت أيضًا زيادة في معدّل الأخطاء المتعلقة بنوايا المنزل المزوّد بأجهزة ذكية أو طلبات الرموز المميزة لإعادة التحميل. |
|
PARTNER_RESPONSE_INVALID_ERROR_CODE |
سلسلة errorCode التي تم عرضها ليست ضمن القائمة المتوافقة مع Google's.
يُرجى ربط الأخطاء الداخلية بقائمة الأخطاء الرسمية. |
نعم |
PARTNER_RESPONSE_INVALID_PAYLOAD |
الحقل payload في الردّ ليس عنصر JSON
صالحًا.
يُرجى التحقّق من البنية الأساسية لردّ تلبية الطلبات. |
نعم |
PARTNER_RESPONSE_INVALID_STATUS |
لم تكن status في الردّ هي SUCCESS أو ERROR أو OFFLINE.
يُرجى التأكّد من أنّ كل نتيجة جهاز في ردّك تتضمّن سلسلة حالة صالحة. |
نعم |
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
لم يتضمّن الردّ نتائج لجميع الأوامر أو الأجهزة المطلوبة.
يُرجى التحقّق من صحة بنية ردّك مقارنةً بمستندات مطوّري Google Home يُرجى التأكّد من أنّ الردّ لا يتم اقتطاعه أو عرض نص أساسي فارغ بسبب خطأ داخلي في الخادم. يجب أن يتضمّن كل عنصر في مصفوفة commands للطلب إدخال ردّ مطابقًا.
|
نعم |
PARTNER_RESPONSE_MISSING_DEVICE |
تم حذف جهاز محدّد طلبته Google من الردّ.
يُرجى التأكّد من أنّ ردّك يتضمّن كل ID تم تقديمه في
حمولة الطلب.
|
نعم |
PARTNER_RESPONSE_MISSING_PAYLOAD |
لا يتضمّن الردّ الحقل الإلزامي payload.
يُرجى التأكّد من أنّ عنصر JSON من المستوى الأعلى يتضمّن مفتاح payload.
|
نعم |
PARTNER_RESPONSE_NOT_OBJECT |
تعذّر تحليل الردّ بالكامل كعنصر JSON.
يُرجى التحقّق من وجود أحرف زائدة أو محتوى غير JSON في نص ردّ HTTP. يُرجى التأكّد من أنّ payload.commands[] هو عنصر JSON مناسب يتضمّن أرقام تعريف وحالة وحالات اختيارية.
|
نعم |
REQUEST_ID_NOT_FOUND |
تعذّر على Google العثور على رقم تعريف التتبّع الداخلي للطلب.
عادةً ما يكون هذا الخطأ داخليًا في المنصة. يُرجى مراقبة الارتفاعات المفاجئة والتواصل مع فريق الدعم. |
نعم |
RESOURCE_UNAVAILABLE |
المصدر المطلوب (الجهاز أو السمة) غير متوفّر.
يُرجى التحقّق ممّا إذا كان الجهاز "مشغولاً" أو تم إيقافه مؤقتًا. |
نعم |
RESPONSE_TIMEOUT |
تعذّر على خدمة تلبية الطلبات الردّ في غضون 9 ثوانٍ.
يُرجى تحسين وقت استجابة الخادم، والتحقّق من طلبات قاعدة البيانات البطيئة أو تأخّر الشبكة الإقليمية. |
نعم |
RESPONSE_UNAVAILABLE |
لم يتم تلقّي أي ردّ من عنوان URL لتلبية الطلبات التابع للشريك.
يُرجى التأكّد من أنّ خدمتك قيد التشغيل وأنّ نقطة النهاية لا تتعطّل. |
نعم |
TIMEOUT |
حدثت مهلة عامة أثناء معالجة النية.
يُرجى الاطّلاع على السجلات لمعرفة مهلات الخدمة الداخلية بين السحابة و مراكز الأجهزة. |
نعم |
سجلات البحث
بعد أن تصبح على دراية بمراقبة عمليات التكامل باستخدام المقاييس، تتمثل الخطوة التالية في تحديد المشاكل وحلّها في ما يتعلّق بأخطاء محدّدة باستخدام Cloud Logging. سجلّ الخطأ هو إدخال يشبه JSON ويتضمّن حقولاً تحتوي على معلومات مفيدة، مثل الوقت ورمز الخطأ وتفاصيل حول نية المنزل المزوّد بأجهزة ذكية الأصلية.
هناك أنظمة متعددة ضمن Google Cloud تُرسِل السجلات إلى مشروعك في جميع الأوقات. عليك كتابة طلبات بحث لفلترة سجلاتك والعثور على السجلات التي تحتاج إليها. يمكن أن تستند طلبات البحث إلى نطاق زمني، مصدر أو درجة أهمية السجلّ أو إدخالات مخصّصة.
يمكنك استخدام أزرار طلبات البحث لمساعدتك في إنشاء الفلاتر المخصّصة.
لتحديد نطاق زمني، يُرجى النقر على زر اختيار النطاق الزمني واختيار أحد الخيارات المتاحة. سيؤدي ذلك إلى فلترة السجلات وعرض السجلات التي تم إنشاؤها في النطاق الزمني المحدّد.
لتحديد مصدر، يُرجى النقر على القائمة المنسدلة المصدر، ثم اختيار مشروع إجراء "مساعد Google". يؤدي ذلك إلى إضافة فلتر في طلب البحث لعرض السجلات التي تم إنشاؤها من مشروعك.
يُرجى استخدام الزر درجة الأهمية للفلترة حسب حرج أو معلومات أو تصحيح الأخطاء، ومستويات سجلات درجة الأهمية الأخرى.
يمكنك أيضًا استخدام حقل "طلب البحث" في Logs Explorer
لإدخال إدخالات مخصّصة. يدعم محرّك طلبات البحث المستخدَم في هذا الحقل كلاً من
طلبات البحث الأساسية، مثل مطابقة السلاسل، وأنواع طلبات البحث الأكثر تقدّمًا، بما في ذلك
أدوات المقارنة (<, >=, !=) وعوامل التشغيل المنطقية (AND, OR, NOT).
على سبيل المثال، سيؤدي الإدخال المخصّص أدناه إلى عرض الأخطاء التي تم إنشاؤها من نوع جهاز LIGHT:
resource.type = "assistant_action_project" AND severity = ERROR AND jsonPayload.executionLog.executionResults.actionResults.device.deviceType = "LIGHT"
يُرجى الانتقال إلى مكتبة طلبات البحث للعثور على مزيد من الأمثلة لطلب البحث عن السجلات بفعالية.
اختبار الإصلاحات
بعد تحديد الأخطاء وتطبيق التعديلات لإصلاحها، ننصحك باختبار إصلاحاتك بدقة باستخدام Google Home Test Suite. نقدّم دليل مستخدم حول كيفية استخدام Test Suite، والذي يرشدك خلال عملية اختبار التغييرات بفعالية.
موارد التعلُّم
توفّر هذه المستندات خطوات تحديد المشاكل وحلّها في ما يتعلّق بالأخطاء في إجراء المنزل الذكي. يمكنك أيضًا الاطّلاع على الدروس التطبيقية لمعرفة المزيد عن تحديد المشاكل وحلّها:
- الدرس التطبيقي حول تصحيح الأخطاء في المنزل المزوّد بأجهزة ذكية: دليل البدء السريع لتصحيح الأخطاء في عملية التكامل من السحابة إلى السحابة في المنزل المزوّد بأجهزة ذكية.
- الدرس التطبيقي حول تحديد المشاكل وحلّها في Local Home: دليل البدء السريع لتحديد المشاكل وحلّها في ما يتعلّق بعملية التكامل المحلية في المنزل المزوّد بأجهزة ذكية.