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