توفّر لك أداة Google Cloud أدوات لمراقبة موثوقية مشاريعك باستخدام Google Cloud Monitoring وتصحيح الأخطاء في سجلّات Google Cloud Logging. كلما حدث فشل عند تحقيق نوايا المستخدم، يسجّل مسار الإحصاءات في Google Home هذا الإخفاق في مقاييسك، وينشر سجلّ أخطاء في سجلات مشروعك.
هناك خطوتان لتحديد الأخطاء وحلّها:
- يمكنك تتبُّع حالة مشاريعك باستخدام مقاييس المنزل الذكي.
- يمكنك التحقيق في المشاكل من خلال التحقّق من أوصاف الأخطاء التفصيلية في سجلّات الأخطاء.
أخطاء المراقبة
يمكنك استخدام Google Cloud Monitoring dashboard للوصول إلى مقاييس مشروعك. هناك بعض الرسومات البيانية الرئيسية التي تفيد بشكل خاص في مراقبة الجودة وتصحيح الأخطاء:
- إنّ الرسم البياني لمعدل النجاح هو الرسم البياني الأول الذي يمكنك البدء منه عند مراقبة موثوقية مشاريعك. قد تشير الانخفاضات في هذا الرسم البياني إلى انقطاع في الخدمة لقاعدة واحدة أو لجميع المستخدمين. ننصحك بمراقبة هذا الرسم البياني عن كثب بحثًا عن أي مخالفات بعد كل تغيير أو تعديل على مشروعك.
- إنّ الرسم البياني لمدة الاستجابة بنسبة 95% هو مؤشر مهم على مستوى أداء إجراء المنزل الذكي. يمكن أن تشير التقلّبات المفاجئة في هذا الرسم البياني إلى عدم قدرة أنظمتنا على فهم الطلبات. ننصح بمراجعة هذا الرسم البياني بشكل دوري للاطّلاع على أي سلوك غير متوقّع.
- تُعدّ الرسوم البيانية لتفاصيل الخطأ أكثر فائدةً في ما يتعلق بتحديد وحلّ المشاكل المتعلقة بعمليات الدمج. بالنسبة إلى كل خطأ تم تمييزه في الرسم البياني للنسبة المئوية للنجاح، يتم عرض رمز خطأ في تفاصيل الخطأ. يمكنك الاطّلاع على الأخطاء التي تم الإبلاغ عنها من خلال السمة Google Home platform وكيفية تحديد المشاكل وحلّها في الجدول أدناه.
رموز الخطأ في النظام الأساسي
إليك بعض رموز الخطأ الشائعة التي قد تظهر لك في سجلّات مشروعك لتحديد المشاكل التي رصدها Google Home platform. يُرجى الرجوع إلى الجدول التالي للحصول على معلومات عن تحديد المشاكل وحلّها.
| رمز الخطأ | الوصف |
|---|---|
BACKEND_FAILURE_URL_ERROR |
تلقّى محرّك بحث Google رمز خطأ HTTP 4xx بخلاف الرمز 401 من خدمتك.
يمكنك استخدام requestId في تسجيل Google Cloud Platform للتحقق من سجلات الخدمات المنزلية
الذكية.
|
BACKEND_FAILURE_URL_UNREACHABLE |
تلقت Google رمز خطأ HTTP 5xx من خدمتك.
يمكنك استخدام requestId في تسجيل Google Cloud Platform للتحقق من سجلات الخدمات المنزلية
الذكية.
|
GAL_BAD_3P_RESPONSE |
يتعذّر على Google تحليل الاستجابة من خدمة ربط حسابك
بسبب التنسيق أو القيم غير الصالحة في الحمولة.
يمكنك استخدام requestId في تسجيل Google Cloud Platform للتحقق من سجلات الأخطاء
في خدمة ربط حسابك.
|
GAL_INTERNAL |
حدث خطأ داخلي في Google عندما حاول محرّك بحث Google استرداد
رمز دخول.
إذا لاحظت ارتفاعًا في معدل هذا الخطأ في تسجيل Google Cloud Platform، يُرجى التواصل معنا للحصول على مزيد من المعلومات. |
GAL_INVALID_ARGUMENT |
حدث خطأ داخلي في Google عندما حاول محرّك بحث Google استرداد
رمز دخول.
إذا لاحظت ارتفاعًا في معدل هذا الخطأ في تسجيل Google Cloud Platform، يُرجى التواصل معنا للحصول على مزيد من المعلومات. |
GAL_NOT_FOUND |
يتم إلغاء صلاحية رموز الدخول والرموز المميزة لإعادة التحميل لدى المستخدم والمخزنة في Google، ولا يمكن إعادة تحميلها. على المستخدم إعادة ربط حسابه لمواصلة استخدام خدمتك.
إذا لاحظت ارتفاعًا في معدل هذا الخطأ في تسجيل Google Cloud Platform، يُرجى التواصل معنا للحصول على مزيد من المعلومات. |
GAL_PERMISSION_DENIED |
حدث خطأ داخلي في Google عندما لا تكون ميزة مشاركة الرمز المميّز
مصرّحًا به.
إذا لاحظت ارتفاعًا في معدل هذا الخطأ في تسجيل Google Cloud Platform، يُرجى التواصل معنا للحصول على مزيد من المعلومات. |
GAL_REFRESH_IN_PROGRESS |
تنتهي صلاحية رمز الدخول المميَّز الخاص بالمستخدم، وتكون هناك محاولة أخرى لإعادة التحميل، وهي قيد التنفيذ حاليًا.
هذه ليست مشكلة وليس عليك اتخاذ أي إجراء. |
INVALID_AUTH_TOKEN |
تلقّت Google رمز خطأ HTTP 401 من خدمتك.
لم تنتهِ صلاحية رمز الدخول، ولكن تم إلغاء صلاحية الخدمة. يمكنك استخدام خدمة requestId في تسجيل Google Cloud Platform للتحقق من سجلات الخدمات المنزلية الذكية.
|
INVALID_JSON |
تعذَّر تحليل استجابة JSON أو فهمها.
تحقَّق من بنية استجابة JSON بحثًا عن بنية غير صالحة، مثل عدم تطابق الأقواس أو الفواصل المفقودة أو الأحرف غير الصالحة. |
OPEN_AUTH_FAILURE |
انتهت صلاحية رمز الدخول الخاص بالمستخدم ولم تتمكن Google من إعادة تحميله أو
تلقت Google رمز الخطأ HTTP 401 من خدمتك.
إذا لاحظت معدّلًا متزايدًا لهذا الرمز، تحقّق مما إذا كنت تلاحظ أيضًا زيادة في معدّل الأخطاء المتعلقة بأغراض المنزل الذكي أو طلبات إعادة تحميل الرمز المميّز. |
PARTNER_RESPONSE_INVALID_ERROR_CODE |
تشير الاستجابة إلى رمز خطأ غير معروف.
إذا كانت استجابة طلبك تشير إلى حدوث خطأ، تأكَّد من استخدام الخطأ الوارد في رموز الخطأ المتوافقة. |
PARTNER_RESPONSE_INVALID_PAYLOAD |
لا يمكن تحليل حقل الاستجابة payload ككائن JSON.
تحقّق مما إذا كان حقل الحمولة في استجابة الطلب يتضمّن أقواسًا مطابقة ومن أنّه منظّم بشكل صحيح كحقل JSON. |
PARTNER_RESPONSE_INVALID_STATUS |
لا تشير الاستجابة إلى حالة أو تشير إلى حالة غير صحيحة.
يجب أن تشير الردود على طلبات التنفيذ المستندة إلى نية الشراء إلى الحالة باستخدام SUCCESS, OFFLINE, ERROR, EXCEPTIONS. ويمكنك
الاطّلاع على مزيد من المعلومات حول
معالجة الأخطاء والاستثناءات.
|
PARTNER_RESPONSE_MISSING_COMMANDS_AND_DEVICES |
لا يتضمّن الردّ هدفًا واحدًا أو أكثر متوفّرًا في الطلب.
عليك التأكّد من أنّ ردّك الخاص بالتنفيذ منظَّمة بشكل صحيح وأنّ نتائج الغرض من الطلب متوفّرة في ردّك. |
PARTNER_RESPONSE_MISSING_DEVICE |
هناك جهاز واحد أو أكثر غير مضمَّن في الطلب في الرد.
تأكَّد من أنّ ردّ التنفيذ منظَّم بشكل صحيح، وأنّ جميع معرّفات الأجهزة متوفرة في طلبك. |
PARTNER_RESPONSE_MISSING_PAYLOAD |
لا يحتوي الرد على حقل payload.
احرص على تضمين حقل الحمولة في ردّ طلبك. يمكنك الاطّلاع على مزيد من المعلومات حول كيفية إنشاء استجابة لتنفيذ عملية التنفيذ بشكل صحيح. |
PARTNER_RESPONSE_NOT_OBJECT |
لا يمكن تحليل الاستجابة ككائن JSON.
تحقَّق من كل الحقول في الاستجابة لطلبك بحثًا عن أحرف غير مقصودة، أو بين قوسَين غير متطابقَين أو أخطاء في التنسيق. قد تكون بعض أحرف يونيكود غير متوافقة. تأكَّد أيضًا من أنّ ردودك منظَّمة بشكل صحيح ككائن JSON. |
RESPONSE_TIMEOUT |
انتهت مهلة الطلب أثناء انتظار الرد.
المهلة الزمنية لإرسال الردّ هي 9 ثوانٍ من وقت إرسال الطلب. احرص على إرسال ردّ خلال هذه الفترة الزمنية. |
RESPONSE_UNAVAILABLE |
عندما لا يتم تلقّي ردّ أو أنّ الإجابة لا تشير إلى الحالة.
يجب أن يتم تنظيم الردود على طلبات التنفيذ حسب النية بالشراء وفقًا لمستندات المنزل المزوّد بأجهزة ذكية وأن تشير إلى الحالة. |
سجلات البحث
بعد الاطّلاع على عمليات التكامل بسهولة باستخدام المقاييس، تتمثل الخطوة التالية في تحديد مشاكل أخطاء وحلّها باستخدام 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 الذي يرشدك خلال اختبار التغييرات بفعالية.
موارد التعلُّم
يقدّم هذا المستند خطوات لتحديد وحلّ الأخطاء في الإجراءات المنزلية الذكية. يمكنك أيضًا الاطّلاع على الدروس التطبيقية حول الترميز لمعرفة المزيد من المعلومات حول تصحيح الأخطاء:
- تصحيح أخطاء تطبيق Smart Home Codelab: دليل البدء السريع لتصحيح الأخطاء في عملية دمج المنازل الذكية
- تصحيح أخطاء رمز التطبيق المنزلي المحلي: دليل البدء السريع لتصحيح أخطاء الدمج المحلي للمنازل الذكية