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