‫Cloud Logging برای بوم‌سازگان Google Home

ابر به ابر    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.

گزارش‌های وقایع

‫Cloud-to-cloud پروژه از رویدادهای زیر در «گزارش‌گیری Cloud» پشتیبانی می‌کند:

منبع Cloud Logging	رویداد
پروژه «کنش دستیار Google»	خطاهای هدف SYNC
	خطاهای هدف QUERY
	خطاهای هدف EXECUTE
	اعلان‌ها خطاها
	خطاهای پیوند دادن حساب
	کیت توسعه نرم‌افزار Local Home HandlerError

گزارش‌های همگام‌سازی

جدول زیر طرحواره ورودی 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، به صفحه «پروژه‌ها» بروید.

   رفتن به کنسول Actions on Google

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

3. برگه توسعه را انتخاب کنید و روی کنش‌ها در نوار کناری کلیک کنید.

4. در فهرست کرکره‌ای انتقال کنترل گزارش، گزینه همه را انتخاب کنید.

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

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

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

سنجه‌های گزارش‌محور

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

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

منابع مرتبط

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

• قیمت‌گذاری: جزئیات مربوط به سهمیه‌ها و هزینه‌های مازاد.
• سهمیه‌ها و محدودیت‌ها: جزئیات مربوط به محدودیت‌ها و خط‌مشی‌های نگهداری برای ثبت استفاده.
• پُرسمان‌های گزارش‌های پیشرفته: راهنمای استفاده از عبارت‌های پیشرفته برای پُرسمان و تجزیه‌وتحلیل داده‌های گزارش.