Cloud Logging برای اکوسیستم Google Home

ابر به ابر ماده

می‌توانید به گزارش‌های رویداد برای ادغام‌های خود از Google Cloud Logging دسترسی داشته باشید. از Cloud Logging برای کاوش گزارش‌ها، ایجاد معیارها و هشدارها، یا صادر کردن گزارش‌ها به برنامه‌های دیگر با استفاده از Google Cloud Pub/Sub استفاده کنید.

ورود به سیستم

برای دسترسی به Cloud Logging از Google Cloud Console ، روی View all products کلیک کنید، سپس به Operations > Logging بروید.

به Cloud Logging بروید

دسترسی به داده های ورود به سیستم از طریق مدیریت هویت و دسترسی (IAM) برای کاربران پروژه Actions شما مدیریت می شود. برای جزئیات بیشتر در مورد نقش‌ها و مجوزهای ثبت داده‌ها، به کنترل دسترسی Cloud Logging مراجعه کنید.

ورودی های گزارش به مدت 30 روز بر اساس خط مشی حفظ گزارش Cloud نگهداری می شوند و سپس برای حذف برنامه ریزی می شوند. همچنین می‌توانید با استفاده از رابط Logs Explorer، ورودی‌های درخواستی را حذف کنید.

در بخش جستجوی گزارش‌های راهنمای عیب‌یابی می‌توانید درباره نحوه استفاده مؤثر از گزارش‌ها اطلاعات بیشتری کسب کنید.

Cloud Logging انواع منابع زیر را فراهم می کند:

نوع منبع نام نمایشی شرح برچسب ها
assistant_action_project پروژه اقدام Google Assistant ظرفی برای پروژه Google Cloud مرتبط با یک اقدام دستیار.
  • project_id : شناسه پروژه فعلی شما که با این منبع مرتبط است، برای مثال my-project .

گزارش رویدادها

پروژه های 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 به طور پیش‌فرض برای دریافت گزارش‌های خطا تنظیم شده‌اند و این امکان برای توسعه‌دهندگان وجود دارد که برای دریافت گزارش‌های موفقیت نیز شرکت کنند. این به ویژه در مرحله توسعه مفید است، زمانی که قصد دارید همه گزارش‌ها را از چند عامل ضبط کنید. در صورت تجاوز از سهمیه ورود به سیستم ممکن است هزینه های اضافی برای پروژه شما اعمال شود.

شما می توانید سطح گزارش برای پروژه خود را با موارد زیر کنترل کنید:

  1. در Actions on Google Console ، به صفحه Projects بروید.

    به قسمت Actions on Google console بروید

  2. پروژه خانه هوشمند خود را انتخاب کنید.

  3. تب Develop را انتخاب کنید و روی Actions در نوار کناری کلیک کنید.

  4. در فهرست کشویی ورود کنترل ورود به سیستم، همه را انتخاب کنید.

ثبت موارد استثنا

توسعه دهندگان می توانند با استفاده از زبان پرس و جوی ورود به سیستم، برای سفارشی کردن بیشتر گزارش های خود به روشی انعطاف پذیرتر، موارد استثنای گزارش را ایجاد کنند. Logs Explorer از زبان جستجوی گزارش نیز استفاده می کند، بنابراین می توانید از Logs Explorer برای کمک به ایجاد پرس و جو استفاده کنید.

می توانید مراحل ایجاد فیلترهای حذف را در این راهنما دنبال کنید (فیلتر خروج را برای سینک _Default پیکربندی کنید).

معیارهای مبتنی بر گزارش

توسعه دهندگان می توانند از معیارهای مبتنی بر گزارش برای ردیابی و تجزیه و تحلیل الگوها در گزارش های خود استفاده کنند. همچنین امکان ایجاد نمودارهای سفارشی و تنظیم هشدارها بر اساس معیارهای گزارش وجود دارد.

برای شروع استفاده از معیارهای مبتنی بر گزارش برای خانه هوشمند، ایجاد یک راهنمای متریک مبتنی بر گزارش شمارنده را بررسی کنید.

برای کسب اطلاعات بیشتر در مورد استفاده از Cloud Logging در پروژه خود، به مستندات زیر مراجعه کنید: