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