میتوانید به گزارشهای رویداد برای ادغامهای خود از Google Cloud Logging دسترسی داشته باشید. از Cloud Logging برای کاوش گزارشها، ایجاد معیارها و هشدارها، یا صادر کردن گزارشها به برنامههای دیگر با استفاده از Google Cloud Pub/Sub استفاده کنید.
ورود به سیستم
برای دسترسی به Cloud Logging از Google Cloud Console ، روی View all products کلیک کنید، سپس به Operations > Logging بروید.
دسترسی به داده های ورود به سیستم از طریق مدیریت هویت و دسترسی (IAM) برای کاربران پروژه Actions شما مدیریت می شود. برای جزئیات بیشتر در مورد نقشها و مجوزهای ثبت دادهها، به کنترل دسترسی Cloud Logging مراجعه کنید.
ورودی های گزارش به مدت 30 روز بر اساس خط مشی حفظ گزارش Cloud نگهداری می شوند و سپس برای حذف برنامه ریزی می شوند. همچنین میتوانید با استفاده از رابط Logs Explorer، ورودیهای درخواستی را حذف کنید.
در بخش جستجوی گزارشهای راهنمای عیبیابی میتوانید درباره نحوه استفاده مؤثر از گزارشها اطلاعات بیشتری کسب کنید.
Cloud Logging انواع منابع زیر را فراهم می کند:
نوع منبع | نام نمایشی | شرح | برچسب ها |
---|---|---|---|
assistant_action_project | پروژه اقدام Google Assistant | ظرفی برای پروژه Google Cloud مرتبط با یک اقدام دستیار. |
|
گزارش رویدادها
پروژه های Cloud-to-cloud از رویدادهای زیر در Cloud Logging پشتیبانی می کنند:
منبع ثبت ابر | رویداد |
---|---|
پروژه اقدام Google Assistant | خطاهای هدف SYNC |
QUERY خطاهای قصد | |
خطاهای هدف را اجرا کنید | |
خطاهای اعلان ها | |
خطاهای پیوند دادن حساب | |
خطای Handler SDK Home Local |
همگام سازی گزارش ها
جدول زیر طرح یک ورودی 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 ، به صفحه Projects بروید.
پروژه خانه هوشمند خود را انتخاب کنید.
تب Develop را انتخاب کنید و روی Actions در نوار کناری کلیک کنید.
در فهرست کشویی ورود کنترل ورود به سیستم، همه را انتخاب کنید.
ثبت موارد استثنا
توسعه دهندگان می توانند با استفاده از زبان پرس و جوی ورود به سیستم، برای سفارشی کردن بیشتر گزارش های خود به روشی انعطاف پذیرتر، موارد استثنای گزارش را ایجاد کنند. Logs Explorer از زبان جستجوی گزارش نیز استفاده می کند، بنابراین می توانید از Logs Explorer برای کمک به ایجاد پرس و جو استفاده کنید.
می توانید مراحل ایجاد فیلترهای حذف را در این راهنما دنبال کنید (فیلتر خروج را برای سینک _Default
پیکربندی کنید).
معیارهای مبتنی بر گزارش
توسعه دهندگان می توانند از معیارهای مبتنی بر گزارش برای ردیابی و تجزیه و تحلیل الگوها در گزارش های خود استفاده کنند. همچنین امکان ایجاد نمودارهای سفارشی و تنظیم هشدارها بر اساس معیارهای گزارش وجود دارد.
برای شروع استفاده از معیارهای مبتنی بر گزارش برای خانه هوشمند، ایجاد یک راهنمای متریک مبتنی بر گزارش شمارنده را بررسی کنید.
منابع مرتبط
برای کسب اطلاعات بیشتر در مورد استفاده از Cloud Logging در پروژه خود، به مستندات زیر مراجعه کنید:
- قیمت گذاری : جزئیات مربوط به تخصیص ها و هزینه های اضافی.
- سهمیه ها و محدودیت ها : جزئیات محدودیت ها و سیاست های حفظ برای استفاده از ورود به سیستم.
- پرس و جوهای گزارش های پیشرفته : راهنمای استفاده از عبارات پیشرفته برای پرس و جو و تجزیه و تحلیل داده های گزارش.