شما می‌توانید از طریق Google Cloud Logging به گزارش‌های رویداد برای یکپارچه‌سازی‌های خود دسترسی داشته باشید. از Cloud Logging برای بررسی گزارش‌ها، ایجاد معیارها و هشدارها یا صادر کردن گزارش‌ها به برنامه‌های دیگر با استفاده از Google Cloud Pub/Sub استفاده کنید.
ثبت ورود به سیستم
برای دسترسی به Cloud Logging از طریق Google Cloud Console ، روی View all products کلیک کنید، سپس به Operations > Logging بروید.
دسترسی به داده‌های ثبت وقایع از طریق مدیریت هویت و دسترسی (IAM) برای کاربران پروژه Actions شما مدیریت می‌شود. برای جزئیات بیشتر در مورد نقش‌ها و مجوزهای مربوط به داده‌های ثبت وقایع، به کنترل دسترسی Cloud Logging مراجعه کنید.
ورودی‌های لاگ طبق سیاست نگهداری Cloud Logging به مدت 30 روز نگهداری می‌شوند و سپس برای حذف برنامه‌ریزی می‌شوند. همچنین می‌توانید ورودی‌ها را در صورت تقاضا با استفاده از رابط Logs Explorer حذف کنید.
می‌توانید در بخش «جستجوی گزارش‌ها» در راهنمای عیب‌یابی، درباره نحوه استفاده مؤثر از گزارش‌ها بیشتر بیاموزید.
Cloud Logging انواع منابع زیر را ارائه می‌دهد:
| نوع منبع | نام نمایشی | توضیحات | برچسب‌ها |
|---|---|---|---|
assistant_action_project | پروژه اقدام دستیار گوگل | یک کانتینر برای پروژه گوگل کلود مرتبط با یک اقدام دستیار. |
|
گزارش‌های رویداد
پروژه‌های Cloud-to-cloud از رویدادهای زیر در Cloud Logging پشتیبانی می‌کنند:
| منبع ثبت وقایع ابری | رویداد |
|---|---|
| پروژه اقدام دستیار گوگل | خطاهای قصد همگام‌سازی |
| خطاهای هدف QUERY | |
| خطاهای اجرای قصد | |
| خطاهای اعلان‌ها | |
| خطاهای مربوط به لینک کردن حساب کاربری | |
| خطای هندلر کیت توسعه نرم‌افزار محلی (SDK HandlerError) |
همگام‌سازی گزارش‌ها
جدول زیر طرحواره یک ورودی syncLog را فهرست می‌کند:
| ملک | توضیحات |
|---|---|
requestId | شناسه درخواست قصد خانه هوشمند. |
httpLatencyMsec | مدت زمان سپری شده قبل از دریافت پاسخ. |
status | وضعیت پاسخ intent را نشان می‌دهد. |
سیاهه‌های مربوط به اجرا
جدول زیر طرحواره یک ورودی executionLog را فهرست می‌کند:
| ملک | توضیحات |
|---|---|
requestId | شناسه درخواست منحصر به فرد، برای مثال 5325511189174727525 . |
latencyMsec | مدت زمان سپری شده قبل از دریافت پاسخ، برای مثال، 6000 . |
executionType | نوع انتقال مورد استفاده برای درخواست، مثلاً CLOUD یا MATTER ، بسته به یکپارچه‌سازی شما. |
actionType | نشانگر اختیاری اقدام انجام شده توسط کاربر، برای مثال QUERY یا EXECUTE . برای اقدامات EXECUTE ، شامل دستور صادر شده برای انجام برای ویژگی‌های پشتیبانی شده، برای مثال ONOFF_OFF می‌شود. |
trait | ویژگی اختیاری مرتبط با این اقدام کاربر. |
deviceTypes | فهرست انواع دستگاه‌هایی که تحت تأثیر این رویداد قرار می‌گیرند، برای مثال LIGHT . |
isSuccess | اینکه آیا درخواست پاسخ موفقیت‌آمیزی دریافت کرده است یا خیر. |
fallbackToCloud | آیا درخواست پس از خطایی از محل انجام درخواست محلی، به محل انجام درخواست ابری هدایت شده است یا خیر. |
statusType | وضعیت پاسخ intent، مانند SUCCESS ، PENDING یا OFFLINE را نشان می‌دهد. برای پاسخ‌های ERROR ، این ویژگی شامل errorCode ارائه شده توسط فرآیند اجرا است. |
externalDebugString | پیام اشکال‌زدایی دقیق اختیاری مرتبط با این اقدام کاربر. |
locale | کد زبان مرتبط با درخواست. |
گزارش‌های اعلان
جدول زیر طرحواره یک ورودی notificationLog را فهرست می‌کند:
| ملک | توضیحات |
|---|---|
requestId | شناسه درخواست اعلان |
structName | نام ساختار اعلان، مانند "ObjectDetection". |
status | وضعیت اعلان را نشان می‌دهد. |
تنظیم سطح گزارش
پروژه‌های Cloud-to-cloud به طور پیش‌فرض طوری تنظیم شده‌اند که گزارش‌های خطا را دریافت کنند و توسعه‌دهندگان می‌توانند دریافت گزارش‌های موفقیت را نیز انتخاب کنند. این امر به ویژه در مرحله توسعه مفید است، زمانی که قصد دارید تمام گزارش‌ها را از چند عامل ثبت کنید. در صورت تجاوز از سهمیه ثبت گزارش ، ممکن است هزینه‌های اضافی برای پروژه شما اعمال شود.
شما می‌توانید سطح لاگ پروژه خود را با روش‌های زیر کنترل کنید:
در بخش Actions on Google Console ، به صفحه «پروژه‌ها» بروید.
پروژه خانه هوشمند خود را انتخاب کنید.
برگه «توسعه» را انتخاب کنید و روی «اقدامات» در نوار کناری کلیک کنید.
در فهرست کشویی Log control ingestion ، گزینه All را انتخاب کنید.
استثنائات گزارش
توسعه‌دهندگان می‌توانند با استفاده از زبان پرس‌وجوی ثبت وقایع (logging query language) استثنائاتی برای گزارش‌ها (log exclusions) ایجاد کنند تا گزارش‌های خود را به شیوه‌ای انعطاف‌پذیرتر سفارشی‌سازی کنند. زبان پرس‌وجوی ثبت وقایع (logging query language) توسط Logs Explorer نیز استفاده می‌شود، بنابراین می‌توانید از Logs Explorer برای ایجاد پرس‌وجوها استفاده کنید.
می‌توانید مراحل ایجاد فیلترهای حذف را در این راهنما دنبال کنید (فیلتر حذف را برای سینک _Default پیکربندی کنید).
معیارهای مبتنی بر لاگ
توسعه‌دهندگان می‌توانند از معیارهای مبتنی بر گزارش برای ردیابی و تحلیل الگوهای درون گزارش‌های خود استفاده کنند. همچنین می‌توان نمودارهای سفارشی ایجاد کرد و هشدارهایی را برای معیارهای مبتنی بر گزارش تنظیم کرد .
برای شروع استفاده از معیارهای مبتنی بر لاگ برای خانه هوشمند، به راهنمای ایجاد یک معیار مبتنی بر لاگ شمارنده مراجعه کنید.
منابع مرتبط
برای کسب اطلاعات بیشتر در مورد استفاده از Cloud Logging در پروژه خود، به مستندات زیر مراجعه کنید:
- قیمت‌گذاری : جزئیات مربوط به سهمیه‌ها و هزینه‌های اضافی.
- سهمیه‌ها و محدودیت‌ها : جزئیات مربوط به محدودیت‌ها و سیاست‌های نگهداری برای استفاده از گزارش‌گیری.
- پرس‌وجوهای پیشرفته‌ی لاگ‌ها : راهنمای استفاده از عبارات پیشرفته برای پرس‌وجو و تحلیل داده‌های لاگ.