Cloud Logging برای Matter

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

ثبت گزارش دسترسی

برای دسترسی به Cloud Logging از Google Cloud Console، روی مشاهده همه محصولات کلیک کنید، سپس به مشاهده‌پذیری > ثبت گزارش بروید.

رفتن به Cloud Logging

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

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

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

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

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

گزارش‌های اجرا

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

کنارگذاری‌های گزارش

توسعه‌دهندگان می‌توانند بااستفاده از زبان پرسمان ثبت گزارش، استثناهای ثبت گزارش ایجاد کنند تا گزارش‌هایشان را به‌شیوه‌ای انعطاف‌پذیرتر سفارشی‌سازی کنند. «کاوشگر گزارش‌ها» نیز از زبان پُرسمان گزارش‌گیری استفاده می‌کند، بنابراین می‌توانید از «کاوشگر گزارش‌ها» برای کمک به ایجاد پُرسمان‌ها استفاده کنید.

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

سنجه‌های مبتنی بر گزارش

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

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

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