Cloud Logging برای Matter

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

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

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

رفتن به Cloud Logging

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

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

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

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

نوع منبع نام نمایشی شرح برچسب‌ها
assistant_action_project پروژه «کنش دستیار Google» ظرفی برای «پروژه ابری Google» مرتبط با «کنش» «دستیار».
  • ‫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 در پروژه‌تان، به اسناد زیر مراجعه کنید: