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