مرحبًا بك في "مركز مطوّري Google Home"، الوجهة الجديدة لتعلّم كيفية تطوير المهام المنزلية الذكية. ملاحظة: ستواصل إنشاء إجراءات في "وحدة تحكّم المهام".

الوصول إلى سجلات الأحداث باستخدام Cloud Logging

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

تسجيل الدخول

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

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

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

يتم الاحتفاظ بسجلات السجلّ لمدة 30 يومًا وفقًا لسياسة الاحتفاظ بالبيانات في Cloud Logging، وبعد ذلك، تم تحديد موعد لحذفها. يمكنك أيضًا حذف الإدخالات عند الطلب باستخدام واجهة Logs Explorer.

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

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

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

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

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

مورد تسجيل في السحابة الإلكترونية الحدث
مشروع إجراءات "مساعد Google" أخطاء intent المزامنة
أخطاء intent في QUERY
أخطاء intent في 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 في مشروعك، يمكنك الاطّلاع على المستندات التالية: