تاريخ_إعادة التحميل: 06-01-2023
Google Cloud توفر لك الأدوات اللازمة لمراقبة موثوقية مشروعاتك مع Google Cloud Monitoring وتصحيح الأخطاء في Google Cloud Logging سجلات الأخطاء عندما يحدث إخفاق عند تحقيق نوايا المستخدم، سجلّات مسار "إحصاءات Google Home" في مقاييسك سجل أخطاء في سجلات مشروعك.
هناك خطوتان لتحديد المشاكل وحلّها:
- راقِب حالة مشاريعك باستخدام مقاييس الأجهزة المنزلية الذكية.
- يمكنك التحقيق في المشاكل من خلال مراجعة أوصاف الأخطاء التفصيلية في سجلات الأخطاء
رصد الأخطاء
يمكنك استخدام Google Cloud Monitoring dashboard للوصول إلى مقاييس مشروعك. هناك بعض المخططات الرئيسية التي مفيدة لمراقبة الجودة وتصحيح الأخطاء:
- يعد مخطط معدل النجاح أول مخطط يمكنك البدء منه مراقبة موثوقية مشروعاتك. يمكن أن تظهر الانخفاضات في هذا الرسم البياني تشير إلى انقطاع في قاعدة المستخدمين لجزء من قاعدة المستخدمين أو كلها. ننصحك بما يلي: مراقبة هذا المخطط بدقة بحثًا عن أي مخالفات بعد كل تغيير أو تحديث مشروعك.
- تُعد مخططات تصنيف الأخطاء الأكثر فائدة عندما يتعلق الأمر وحلّها في عمليات الدمج. لكل خطأ في الرسم البياني لنسبة النجاح، فسيتم عرض رمز خطأ في تقسيم الأخطاء لديك. يمكنك الاطّلاع على الأخطاء التي تم الإبلاغ عنها من "Google Home platform" وكيفية تحديد المشاكل وحلّها في الجدول أدناه.
رموز الخطأ في النظام الأساسي
في ما يلي بعض رموز الخطأ الشائعة التي قد تظهر في سجلات مشروعك التعرّف على المشاكل التي تم رصدها من خلال "Google Home platform". يُرجى الرجوع إلى الجدول التالي للحصول على معلومات استكشاف الأخطاء وإصلاحها.
| رمز الخطأ | الوصف |
|---|---|
BACKEND_FAILURE_URL_ERROR |
تلقّت Google رمز خطأ HTTP 4xx بخلاف 401 من
خدمة ما.
استخدام requestId في تسجيل Google Cloud Platform (GCP) للتحقق من الذكاء
سجلات الخدمات المنزلية.
|
BACKEND_FAILURE_URL_TIMEOUT |
انتهت مهلة طلب Google عند محاولة الوصول إلى خدمتك.
التأكّد من أنّ الخدمة متصلة بالإنترنت، وقبول الاتصالات، ولا يتجاوز السعة. بالإضافة إلى ذلك، تحقق من أن الهدف أن يكون الجهاز قيد التشغيل ومتصلاً بالإنترنت ومتزامنًا. |
BACKEND_FAILURE_URL_UNREACHABLE |
تلقّت Google رمز خطأ HTTP 5xx من خدمتك.
استخدام requestId في تسجيل Google Cloud Platform (GCP) للتحقق من الذكاء
سجلات الخدمات المنزلية.
|
DEVICE_NOT_FOUND |
الجهاز غير موجود من جانب خدمة الشريك.
يشير هذا عادة إلى فشل في مزامنة البيانات أو وجود سباق الشرط. |
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 (GCP) للتحقق من الذكاء
سجلات الخدمات المنزلية.
|
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. |
PROTOCOL_ERROR |
تعذّرت معالجة الطلب.
يمكنك استخدام requestId في Google Cloud Logging للاطّلاع على
سجلات الخدمات المنزلية الذكية.
|
RESPONSE_TIMEOUT |
انتهت مهلة الطلب أثناء انتظار الرد.
إنّ المهلة المحدّدة لإرسال الردّ هي 9 ثوانٍ من تاريخ يتم إرسال الطلب. احرص على إرسال رد خلال هذه الفترة محددة. |
RESPONSE_UNAVAILABLE |
لم يتم تلقّي أي رد، أو لا يشير الردّ إلى الحالة.
يجب تنظيم الردود على طلبات تنفيذ النية بالشراء. استنادًا إلى مستندات المنزل المزوّد بأجهزة ذكية وتشير إلى حالتها. |
TRANSIENT_ERROR |
الخطأ العابر هو خطأ سيتم حله تلقائيًا.
عادةً ما تظهر هذه الأخطاء كاتصال بجهاز أو انقطاع الخدمة. وأيضًا في حالة تعذر اتصال الاتصالات الجديدة بالخادم فُتِحَ |
سجلات البحث
بعد التمكّن من مراقبة عمليات الدمج باستخدام المقاييس، يجب تنفيذ ما يلي: هي استكشاف أخطاء معينة وإصلاحها باستخدام 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"، والذي يرشدك خلال اختبار التغييرات بفعالية.
موارد التعلُّم
يعرض هذا المستند خطوات تحديد المشاكل وحلّها في منزلك المزوّد بأجهزة ذكية. الحركة. يمكنك أيضًا الاطّلاع على الدروس التطبيقية حول الترميز لمعرفة المزيد حول تصحيح الأخطاء:
- تصحيح الأخطاء في الدرس التطبيقي حول الترميز للمنزل المزوّد بأجهزة ذكية: دليل البدء السريع لتصحيح أخطاء دمج السحابة الإلكترونية للمنزل المزوّد بأجهزة ذكية
- تصحيح الأخطاء في الدرس التطبيقي حول الترميز الخاص بالصفحة الرئيسية: دليل البدء السريع لتصحيح أخطاء الدمج المحلي للمنزل المزوّد بأجهزة ذكية