refresh_date: 2023-01-06
Google Cloud توفّر لك الأدوات اللازمة لمراقبة موثوقية مشاريعك باستخدام Google Cloud Monitoring وتحديد المشاكل وحلّها باستخدام Google Cloud Logging سجلّات الأخطاء. عند حدوث أي عطل أثناء تلبية طلبات المستخدمين، تسجِّل قناة Google Home Analytics هذا العطل في مقاييسك، وتنشر سجلّ أخطاء في سجلّات مشروعك.
هناك خطوتان لتحديد المشاكل وحلّها في ما يتعلّق بالأخطاء:
- مراقبة حالة مشاريعك باستخدام مقاييس المنزل المزوّد بأجهزة ذكية
- التحقيق في المشاكل من خلال الاطّلاع على الأوصاف التفصيلية للأخطاء في سجلّات الأخطاء
مراقبة الأخطاء
يمكنك استخدام Google Cloud Monitoring dashboards للوصول إلى مقاييس مشروعك. في ما يلي بعض الرسوم البيانية الرئيسية المفيدة بشكل خاص لمراقبة الجودة وتحديد المشاكل وحلّها:
- الرسم البياني معدّل النجاح هو أول رسم بياني يجب البدء به عند رصد موثوقية مشاريعك. يمكن أن تشير الانخفاضات في هذا الرسم البياني إلى انقطاع الخدمة عن جزء من قاعدة المستخدمين أو كلها. ننصحك بمراقبة هذا الرسم البياني عن كثب لرصد أي مخالفات بعد كل تغيير أو تعديل في مشروعك.
- تكون الرسوم البيانية تفاصيل الخطأ مفيدة جدًا عند تحديد المشاكل وحلّها في عمليات الدمج. لكل خطأ يتم تمييزه في الرسم البياني لنسبة النجاح، يتم عرض رمز خطأ في تفاصيل الخطأ. يمكنك الاطّلاع على الأخطاء التي تم وضع علامة عليها من قِبل 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 المتوافقة.
يُرجى ربط الأخطاء الداخلية بقائمة الأخطاء الرسمية. |
نعم |
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: دليل البدء السريع لتصحيح الأخطاء في عملية الدمج المحلية في المنزل المزوّد بأجهزة ذكية.