Cloud Logging for Matter

شما می‌توانید از طریق 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 مراجعه کنید.

ورودی‌های لاگ طبق سیاست نگهداری Cloud Logging به مدت 30 روز نگهداری می‌شوند و سپس برای حذف برنامه‌ریزی می‌شوند. همچنین می‌توانید ورودی‌ها را در صورت تقاضا با استفاده از رابط Logs Explorer حذف کنید.

می‌توانید در بخش «جستجوی گزارش‌ها» در راهنمای عیب‌یابی، درباره نحوه استفاده مؤثر از گزارش‌ها بیشتر بیاموزید.

Cloud Logging انواع منابع زیر را ارائه می‌دهد:

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

سیاهه‌های مربوط به اجرا

جدول زیر طرحواره یک ورودی 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 کد زبان مرتبط با درخواست.

استثنائات گزارش

توسعه‌دهندگان می‌توانند با استفاده از زبان پرس‌وجوی ثبت وقایع (logging query language) استثنائاتی برای گزارش‌ها (log exclusions) ایجاد کنند تا گزارش‌های خود را به شیوه‌ای انعطاف‌پذیرتر سفارشی‌سازی کنند. زبان پرس‌وجوی ثبت وقایع (logging query language) توسط Logs Explorer نیز استفاده می‌شود، بنابراین می‌توانید از Logs Explorer برای ایجاد پرس‌وجوها استفاده کنید.

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

معیارهای مبتنی بر لاگ

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

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

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

قبلی
Cloud Monitoring for Matter
بعدی
عیب یابی خطاهای ادغام ماده