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

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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

تسجيل الدخول

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

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

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

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

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

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

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

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

Cloud-to-cloud projects support the following events in Cloud Logging:

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

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

يسرد الجدول التالي مخطط الإدخال syncLog:

الخاصية الوصف
requestId رقم تعريف طلب intent للمنزل الذكي
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, go to the Projects page.

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

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

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

  4. اختَر الكل في القائمة المنسدلة عرض التحكم في العرض.

استثناءات السجلّ

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

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

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

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

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

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