التسجيل في السحابة الإلكترونية لمنظومة Google Home المتكاملة

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

يمكنك الوصول إلى سجلّات الأحداث لعمليات الدمج من Google Cloud Logging. استخدِم Cloud Logging لاستكشاف السجلات أو إنشاء مقاييس وتنبيهات أو تصدير السجلات إلى تطبيقات أخرى باستخدام Google Cloud Pub/Sub.

تسجيل الوصول

للوصول إلى Cloud Logging من Google Cloud Console، انقر على عرض جميع المنتجات، ثم انتقِل إلى العمليات > التسجّل.

الانتقال إلى Cloud Logging

يتم إدارة الوصول إلى بيانات التسجيل من خلال إدارة الهوية وإمكانية الوصول (IAM) لمستخدمي مشروع "مهام Google". لمزيد من التفاصيل حول الأدوار والأذونات المتعلقة بتسجيل البيانات، يُرجى الاطّلاع على التحكّم في الوصول إلى "تسجيلات Cloud".

يتم الاحتفاظ بإدخالات السجلّ لمدة 30 يومًا وفقًا لسياسة الاحتفاظ بالبيانات في "سجلّات السحابة الإلكترونية"، ثم يتم تحديد موعد لحذفها. يمكنك أيضًا حذف الإدخالات عند الطلب باستخدام واجهة مستكشف السجلّات.

يمكنك الاطّلاع على مزيد من المعلومات عن كيفية استخدام السجلات بفعالية في قسم "البحث في السجلات" ضمن دليل تحديد المشاكل وحلّها.

يوفّر Cloud Logging أنواع الموارد التالية:

نوع المورد الاسم المعروض الوصف التصنيفات
assistant_action_project مشروع إجراءات "مساعد Google" حاوية لمشروع Google Cloud المرتبط بأحد إجراءات "مساعد Google"
  • ‫project_id: معرّف مشروعك الحالي المرتبط بهذا المورد، على سبيل المثال my-project.

سجلات الأحداث

تتيح مشاريع Cloud-to-cloud الأحداث التالية في Cloud Logging:

مرجع التسجيل في السحابة الإلكترونية الحدث
مشروع إجراءات "مساعد Google" أخطاء نية SYNC
أخطاء طلبات البحث التي تستخدم دالة QUERY
أخطاء نية EXECUTE
الإشعارات الأخطاء
أخطاء ربط الحساب
حزمة تطوير برامج المنزل المحلية HandlerError

سجلّات المزامنة

يسرد الجدول أدناه مخطّط إدخال syncLog:

الموقع الوصف
requestId رقم تعريف طلب الإجراء في المنزل الذكي
httpLatencyMsec الوقت المنقضي قبل تلقّي ردّ.
status يشير إلى حالة استجابة النية.

سجلّات التنفيذ

يسرد الجدول أدناه مخطّط إدخال executionLog:

الموقع الوصف
requestId معرّف الطلب الفريد، على سبيل المثال 5325511189174727525.
latencyMsec الوقت المنقضي قبل تلقّي ردّ، على سبيل المثال، 6000.
executionType بروتوكول النقل المستخدَم للطلب، على سبيل المثال CLOUD أو MATTER، استنادًا إلى عملية الدمج
actionType مؤشر اختياري للإجراء الذي اتّخذه المستخدم، على سبيل المثال QUERY أو EXECUTE بالنسبة إلى إجراءات EXECUTE، يتضمّن الطلب الصادر لتحديد السمات المتوافقة، على سبيل المثال ONOFF_OFF
trait سمة اختيارية مرتبطة بإجراء المستخدِم هذا.
deviceTypes قائمة بأنواع الأجهزة المتأثّرة بالحدث، على سبيل المثال LIGHT.
isSuccess ما إذا كان الطلب قد تلقّى استجابة ناجحة
fallbackToCloud ما إذا كان الطلب قد تم توجيهه إلى عملية التوصيل من خلال السحابة الإلكترونية بعد حدوث خطأ من عملية التوصيل المحلية
statusType يشير إلى حالة استجابة النية، مثل SUCCESS أو PENDING أو OFFLINE. بالنسبة إلى استجابات ERROR ، تحتوي هذه السمة على القيمة errorCode المقدَّمة من عملية الإنجاز.
externalDebugString رسالة اختيارية تفصيلية لتصحيح الأخطاء مرتبطة بإجراء المستخدم هذا.
locale رمز اللغة المرتبط بالطلب

سجلّات الإشعارات

يسرد الجدول أدناه مخطّط إدخال notificationLog:

الموقع الوصف
requestId رقم تعريف طلب الإشعار
structName اسم بنية الإشعار، مثل "ObjectDetection"
status يشير إلى حالة الإشعار.

إعداد مستوى السجلّ

يتم ضبط مشاريع Cloud-to-cloud لتلقّي سجلّات الأخطاء تلقائيًا، ويمكن للمطوّرين تفعيل تلقّي سجلّات النجاح أيضًا. ويُعدّ هذا الإجراء مفيدًا بشكل خاص خلال مرحلة التطوير عندما تخطّط لتسجيل جميع السجلات من بضعة موظّفي دعم. قد يتم تطبيق رسوم إضافية على مشروعك إذا تجاوزت حصة التسجيل.

يمكنك التحكّم في مستوى السجلّ لمشروعك من خلال:

  1. في Actions on Google Console، انتقِل إلى صفحة "المشاريع".

    الانتقال إلى وحدة تحكّم "المهام مع مساعد Google"

  2. اختَر مشروع المنزل الذكي.

  3. اختَر علامة التبويب تطوير، ثم انقر على الإجراءات في الشريط الجانبي.

  4. اختَر الكل في القائمة المنسدلة نقل بيانات التحكّم في السجلّ.

استبعادات السجلّات

يمكن للمطوّرين إنشاء استثناءات السجلات باستخدام لغة طلب البحث عن التسجيل لمزيد من تخصيص السجلات بطريقة أكثر مرونة. يستخدم "مستكشف السجلات" أيضًا لغة طلبات البحث المتعلّقة بالتسجيل، ما يتيح لك استخدام "مستكشف السجلات" للمساعدة في إنشاء طلبات البحث.

يمكنك اتّباع خطوات إنشاء فلاتر استبعاد في هذا الدليل (ضبط فلتر الاستبعاد لوحدة معالجة البيانات _Default).

المقاييس المستندة إلى السجلّات

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

لبدء استخدام المقاييس المستندة إلى السجلّات للمنزل الذكي، اطّلِع على دليل إنشاء مقياس مستند إلى سجلّ العداد.

لمزيد من المعلومات عن استخدام Cloud Logging في مشروعك، راجِع المستندات التالية:

السابق
Cloud Monitoring
التالي
تحديد مشاكل الدمج وحلّها