تحديد مشاكل الدمج وحلّها

السحابة الإلكترونية إلى السحابة الإلكترونية    المسألة القانونية

Google Cloud توفر لك الأدوات اللازمة لمراقبة موثوقية مشروعاتك مع Google Cloud Monitoring وتصحيح الأخطاء في Google Cloud Logging سجلات الأخطاء عند حدوث تعذّر في تنفيذ طلبات المستخدِمين، تُسجِّل مسار الإحالة الناجحة في "إحصاءات Google Home" هذا التعذّر في المقاييس، وتُنشِر log خطأ في سجلّات مشروعك.

هناك خطوتان لتحديد المشاكل وحلّها:

  1. راقِب حالة مشاريعك باستخدام مقاييس الأجهزة المنزلية الذكية.
  2. يمكنك التحقيق في المشاكل من خلال مراجعة أوصاف الأخطاء التفصيلية في سجلات الأخطاء

وهذه العملية مماثلة للتكامل المحلي باستخدام Local Home SDK بعد إتقان عملية استكشاف الأخطاء وإصلاحها، يمكنك يمكنك التنقل بسهولة بين المقاييس والسجلات للحصول على رؤى حول الأخطاء.

رصد الأخطاء

يمكنك استخدام Google Cloud Monitoring dashboard للوصول إلى مقاييس مشروعك. هناك بعض المخططات الرئيسية التي مفيدة لمراقبة الجودة وتصحيح الأخطاء:

  • يعد مخطط معدل النجاح أول مخطط يمكنك البدء منه مراقبة موثوقية مشروعاتك. يمكن أن تظهر الانخفاضات في هذا الرسم البياني تشير إلى انقطاع في قاعدة المستخدمين لجزء من قاعدة المستخدمين أو كلها. ننصحك بما يلي: مراقبة هذا المخطط بدقة بحثًا عن أي مخالفات بعد كل تغيير أو تحديث مشروعك.
  • يعد الرسم البياني وقت الاستجابة المئوي 95 مؤشرًا مهمًا لكيفية مستوى أداء إجراء المنزل المزوّد بأجهزة ذكية للمستخدمين التقلّبات المفاجئة في هذا المخطط قد تشير إلى أن أنظمتك قد تكون غير قادرة على مواكبة مع الطلبات. يُنصح بمراجعة هذا الرسم البياني بشكل دوري حدوث أي سلوك غير متوقع.
  • تُعد مخططات تصنيف الأخطاء الأكثر فائدة عندما يتعلق الأمر وحلّها في عمليات الدمج. لكل خطأ في الرسم البياني لنسبة النجاح، فسيتم عرض رمز خطأ في تقسيم الأخطاء لديك. يمكنك الاطّلاع على الأخطاء التي تم الإبلاغ عنها من "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" للاطّلاع على سجلّات خدمة المنزل الذكي.
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 ترسل السجلّات إلى لمشروعك في جميع الأوقات. عليك كتابة طلبات بحث لفلترة السجلّات والعثور على الطلبات التي تحتاج إليها. يمكن أن تستند طلبات البحث إلى النطاق الزمني، المورد أو سجلّ درجة الخطورة أو الإدخالات المخصّصة.

طلب البحث في سجلات 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"، والذي يرشدك خلال اختبار التغييرات بفعالية.

موارد التعلُّم

يعرض هذا المستند خطوات تحديد المشاكل وحلّها في منزلك المزوّد بأجهزة ذكية. الحركة. يمكنك أيضًا الاطّلاع على ورشات عمل الترميز لمعرفة المزيد من المعلومات عن تصحيح الأخطاء:

السابق
Cloud Logging