التسجيل في السحابة الإلكترونية لمنظومة Google Home المتكاملة

السحابة الإلكترونية إلى السحابة الإلكترونية    المسألة القانونية

يمكنك الوصول إلى سجلات الأحداث لعمليات الدمج من Google Cloud Logging. يمكنك استخدام "Cloud Logging" لاستكشاف السجلات، أو إنشاء مقاييس وتنبيهات، أو تصدير السجلات إلى تطبيقات أخرى باستخدام Google Cloud Pub/Sub.

تسجيل الوصول

للوصول إلى Cloud Logging من Google Cloud Console، انقر على عرض كل المنتجات، ثم انتقِل إلى العمليات > التسجيل.

الانتقال إلى Cloud Logging

تتم إدارة إمكانية الوصول إلى بيانات التسجيل من خلال "إدارة الهوية والوصول" لمستخدمي مشروع "المهام" في مؤسستك. لمزيد من التفاصيل حول الأدوار والأذونات لبيانات التسجيل، يُرجى الاطّلاع على التحكم في الوصول إلى تسجيل الدخول إلى السحابة الإلكترونية.

يتم الاحتفاظ بإدخالات السجلّ لمدة 30 يومًا وفقًا لسياسة الاحتفاظ ببيانات التسجيل في السحابة الإلكترونية، ثم تتم جدولة حذفها. يمكنك كذلك حذف الإدخالات عند الطلب باستخدام واجهة Logs Explorer.

يمكنك التعرّف على مزيد من المعلومات حول كيفية استخدام السجلات بفعالية في قسم سجلات البحث ضمن دليل تحديد المشاكل وحلّها.

توفّر "Cloud Logging" أنواع الموارد التالية:

نوع المورد	الاسم المعروض	الوصف	التصنيفات
assistant_action_project	مشروع إجراء "مساعد Google"	تمثّل هذه السمة حاوية لمشروع Google Cloud مرتبط بإجراء "مساعد Google".	project_id: معرّف مشروعك الحالي المرتبط بهذا المورد، على سبيل المثال my-project.

سجلات الأحداث

يتيح مشروعان (Cloud-to-cloud) الأحداث التالية في Cloud Logging:

مورد تسجيل الدخول إلى السحابة الإلكترونية	حدث
مشروع إجراء "مساعد Google"	أخطاء مزامنة النية بالشراء
	أخطاء الغرض من QUERY
	أخطاء EXECUTE في الغرض
	أخطاء الإشعارات
	أخطاء ربط الحساب
	حزمة تطوير البرامج (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 لتلقّي سجلات الأخطاء تلقائيًا، ويمكن للمطوّرين الموافقة على تلقّي سجلّات النجاح أيضًا. ويكون ذلك مفيدًا على وجه الخصوص خلال مرحلة التطوير عندما تخطط لجمع جميع السجلات من عدد قليل من الوكلاء. قد يتم فرض رسوم إضافية على مشروعك إذا تجاوزت حصة التسجيل.

يمكنك التحكم في مستوى السجل لمشروعك عن طريق:

1. في Actions on Google Console، انتقِل إلى صفحة "المشاريع".

   الانتقال إلى وحدة تحكّم "المهام مع مساعد Google"

2. اختَر مشروع منزلك المزوّد بأجهزة ذكية.

3. اختر علامة التبويب التطوير، ثمّ انقر على الإجراءات في الشريط الجانبي.

4. اختَر الكل في القائمة المنسدلة عرض التحكّم في السجلّ.

استثناءات السجلّات

يمكن للمطوّرين إنشاء استبعادات السجلّات باستخدام لغة طلب البحث للتسجيل لتخصيص سجلّاتهم بشكلٍ أكبر بطريقة أكثر مرونة. يتم استخدام لغة استعلام تسجيل الدخول أيضًا بواسطة مستكشف السجلات حتى تتمكن من استخدام مستكشف السجلات للمساعدة في إنشاء طلبات البحث.

يمكنك اتّباع خطوات إنشاء فلاتر الاستبعاد في هذا الدليل (ضبط فلتر الاستثناء لأحواض _Default).

المقاييس المستندة إلى السجلّ

يمكن للمطوّرين استخدام المقاييس المستندة إلى السجلات لتتبّع الأنماط وتحليلها في سجلّاتهم. من الممكن أيضًا إنشاء رسوم بيانية مخصَّصة وإعداد تنبيهات على المقاييس المستندة إلى السجلّ.

ولبدء استخدام المقاييس المستندة إلى السجلّ للمنزل المزوّد بأجهزة ذكية، يمكنك الاطّلاع على إنشاء دليل مقاييس مستندة إلى سجلّ العدّاد.

مراجع ذات صلة

للحصول على مزيد من المعلومات حول استخدام تسجيل الدخول إلى السحابة الإلكترونية في مشروعك، يُرجى الاطّلاع على المستندات التالية:

• التسعير: تفاصيل عن التخصيصات وتكاليف الاستخدام الزائد.
• الحصص والحدود: تفاصيل حول الحدود وسياسات الاحتفاظ بالبيانات لتسجيل الاستخدام.
• طلبات البحث عن السجلات المتقدّمة: دليل استخدام التعبيرات المتقدّمة لطلب بيانات السجلّ وتحليلها.