تاريخ_إعادة التحميل: 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 في "تسجيل الدخول إلى GCP" للتحقّق من سجلّات الخدمات المنزلية الذكية.
|
BACKEND_FAILURE_URL_TIMEOUT |
انتهت مهلة طلب Google عند محاولة الوصول إلى خدمتك.
تأكَّد من أنّ الخدمة متصلة بالإنترنت وتقبل الاتصالات ولم تتجاوز السعة. بالإضافة إلى ذلك، تأكَّد من أنّ الجهاز المستهدَف قيد التشغيل ومتصل بالإنترنت ومزامنته. |
BACKEND_FAILURE_URL_UNREACHABLE |
تلقّت Google رمز خطأ HTTP 5xx من خدمتك.
يمكنك استخدام requestId في "تسجيل الدخول إلى GCP" للتحقّق من سجلّات الخدمات المنزلية الذكية.
|
DEVICE_NOT_FOUND |
الجهاز غير موجود من جانب خدمة الشريك.
يشير ذلك عادةً إلى حدوث عطل في مزامنة البيانات أو حالة سباق. |
GAL_BAD_3P_RESPONSE |
يتعذّر على Google تحليل الاستجابة من خدمة ربط الحسابات
بسبب تنسيق أو قيم غير صالحة في الحمولة.
استخدام requestId في "تسجيل الدخول إلى Google Cloud Platform" للتحقّق من سجلّات الأخطاء
في خدمة ربط الحساب
|
GAL_INTERNAL |
حدث خطأ داخلي في Google عندما حاول محرّك بحث Google استرداد
رمز دخول.
إذا لاحظت زيادة في معدّل هذا الخطأ في تسجيل الدخول إلى GCP، يمكنك التواصل معنا للحصول على مزيد من المعلومات. |
GAL_INVALID_ARGUMENT |
حدث خطأ داخلي في Google عندما حاول محرّك بحث Google استرداد
رمز دخول.
إذا لاحظت زيادة في معدّل هذا الخطأ في تسجيل الدخول إلى GCP، يمكنك التواصل معنا للحصول على مزيد من المعلومات. |
GAL_NOT_FOUND |
يتم إلغاء صلاحية رموز الدخول والرموز المميّزة الخاصة بإعادة التحميل الخاصة بالمستخدم والتي تكون مخزّنة في Google
غير صالحة ولا يمكن إعادة تحميلها بعد ذلك. يحتاج المستخدم إلى إعادة ربط حسابه لمواصلة استخدام خدمتك.
إذا لاحظت زيادة في معدّل هذا الخطأ في تسجيل الدخول إلى GCP، يمكنك التواصل معنا للحصول على مزيد من المعلومات. |
GAL_PERMISSION_DENIED |
حدث خطأ داخلي في Google عندما لا يتم السماح بمشاركة الرموز المميّزة.
إذا لاحظت زيادة في معدّل هذا الخطأ في تسجيل الدخول إلى GCP، يمكنك التواصل معنا للحصول على مزيد من المعلومات. |
GAL_REFRESH_IN_PROGRESS |
انتهت صلاحية رمز الدخول الخاص بالمستخدم وتجري محاولة متزامنة أخرى لإعادة تحميله.
هذه ليست مشكلة وليس عليك اتّخاذ أي إجراء. |
INVALID_AUTH_TOKEN |
تلقّت Google رمز الخطأ HTTP 401 من خدمتك.
لم تنتهِ صلاحية رمز الدخول، ولكن خدمتك قد أبطلت صلاحيته. استخدِم requestId في "تسجيل الدخول إلى 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" للتحقّق من
سجلّات الخدمات المنزلية الذكية.
|
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"، والذي يرشدك خلال اختبار التغييرات بفعالية.
موارد التعلُّم
يعرض هذا المستند خطوات تحديد المشاكل وحلّها في الإجراء الخاص بمنزلك المزوّد بأجهزة ذكية. يمكنك أيضًا الاطّلاع على الدروس التطبيقية حول الترميز لمعرفة المزيد حول تصحيح الأخطاء:
- تصحيح أخطاء درس تطبيقي حول الترميز في المنزل المزوّد بأجهزة ذكية: دليل البدء السريع لتصحيح أخطاء دمج السحابة الإلكترونية للمنزل المزوّد بأجهزة ذكية
- تصحيح أخطاء درس تطبيقي حول ترميز المنزل المحلي: دليل البدء السريع لتصحيح أخطاء الدمج المحلي للمنزل المزوّد بأجهزة ذكية