من السحابة الإلكترونية إلى السحابة الإلكترونية Matter
يمكنك الوصول إلى سجلات الأحداث لعمليات الدمج من 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" Action. |
|
سجلات الأحداث
تتيح مشاريع Cloud-to-cloud الأحداث التالية في Cloud Logging:
| مورد Cloud Logging | الحدث |
|---|---|
| مشروع "المهام مع مساعد Google" | أخطاء في الغرض SYNC |
| أخطاء في الغرض QUERY | |
| أخطاء في الغرض EXECUTE | |
| إشعارات أخطاء | |
| أخطاء في ربط الحساب | |
| Local Home SDK 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 في مشروعك، يُرجى الاطّلاع على المستندات التالية: documentation:
- الأسعار: تفاصيل عن الحصص وتكاليف التجاوز
- الحصص والحدود: تفاصيل عن الحدود وسياسات الاحتفاظ ببيانات استخدام التسجيل
- طلبات البحث المتقدّمة في السجلّات: دليل استخدام التعبيرات المتقدّمة لطلب بيانات السجلّات وتحليلها