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