يمكنك الوصول إلى سجلّات الأحداث لعمليات الدمج من Google Cloud Logging. يمكنك استخدام Cloud Logging لاستكشاف السجلّات وإنشاء المقاييس والتنبيهات أو تصدير السجلّات إلى تطبيقات أخرى باستخدام Google Cloud Pub/Sub.
تسجيل الدخول
للوصول إلى Cloud Logging من Google Cloud Console، انقر على عرض جميع المنتجات، ثم انتقل إلى العمليات > التسجيل.
تتم إدارة الوصول إلى بيانات التسجيل من خلال إدارة الهوية والوصول (IAM) لمستخدمي مشروع Actions. لمزيد من التفاصيل عن الأدوار والأذونات لبيانات التسجيل، يُرجى الاطِّلاع على التحكُّم في الوصول إلى "تسجيل الدخول إلى السحابة الإلكترونية".
يتم الاحتفاظ بسجلات السجلّ لمدة 30 يومًا وفقًا لسياسة الاحتفاظ بالبيانات في Cloud Logging، وبعد ذلك، تم تحديد موعد لحذفها. يمكنك أيضًا حذف الإدخالات عند الطلب باستخدام واجهة Logs Explorer.
يمكنك التعرّف على مزيد من المعلومات حول كيفية استخدام السجلّات بشكل فعّال في قسم "سجلّات البحث" من دليل تحديد المشاكل وحلّها.
تقدّم Cloud Logging أنواع الموارد التالية:
| نوع المرجع | الاسم المعروض | الوصف | التصنيفات |
|---|---|---|---|
assistant_action_project |
مشروع إجراءات "مساعد Google" | حاوية لمشروع Google Cloud المرتبط بأحد إجراءات "مساعد Google". |
|
سجلات الأحداث
يتوافق مشروعان (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 مشروعًا على تلقّي سجلّات الخطأ تلقائيًا، ويمكن لمطوّري البرامج الموافقة على تلقّي سجلات النجاح أيضًا. ويُعدّ هذا الإجراء مفيدًا بشكل خاص خلال مرحلة التطوير عندما تخطط لالتقاط جميع السجلّات من بعض الوكلاء. قد يتم تطبيق رسوم إضافية على مشروعك إذا تجاوزت حصة التسجيل.
يمكنك التحكُّم في مستوى السجلّ لمشروعك من خلال:
في Actions on Google Console، انتقِل إلى صفحة "المشاريع".
اختَر مشروعك المنزلي الذكي.
انقر على علامة التبويب التطوير، ثم انقر على الإجراءات في الشريط الجانبي.
اختَر الكل في القائمة المنسدلة التحكُّم في التسجيل.
استثناءات السجلّات
يمكن لمطوّري البرامج إنشاء استثناءات للسجلات باستخدام لغة طلب البحث لتخصيص سجلاتهم بطريقة أكثر مرونة. يتم أيضًا استخدام لغة طلب البحث في السجلّ من خلال مستكشف السجلات حتى تتمكن من استخدام مستكشف السجلات للمساعدة في إنشاء طلبات البحث.
يمكنك اتّباع الخطوات اللازمة لإنشاء فلاتر استثناء في
هذا الدليل
(ضبط فلتر الاستثناء ل حوض _Default).
المقاييس المستندة إلى السجلّ
يمكن لمطوّري البرامج استخدام المقاييس المستندة إلى السجلّ لتتبّع الأنماط وتحليلها ضمن السجلات. ويمكن أيضًا إنشاء رسوم بيانية مخصّصة وإعداد التنبيهات على المقاييس المستندة إلى السجلّ.
لبدء استخدام المقاييس المستندة إلى السجلّ للمنازل الذكية، يمكنك الاطّلاع على دليل إنشاء المقاييس المستنِدة إلى السجلّ المضاد.
مراجع ذات صلة
للحصول على مزيد من المعلومات حول استخدام Cloud Logging في مشروعك، يمكنك الاطّلاع على المستندات التالية:
- التسعير: تفاصيل حول التخصيصات وتكاليف الاستخدام الزائد.
- الحصص والحدود: تفاصيل حول سياسات الاحتفاظ بالبيانات والحدود المفروضة على استخدام التسجيل.
- طلبات البحث للسجلات المتقدمة: دليل استخدام التعبيرات المتقدمة للاستعلام عن بيانات السجل وتحليلها.