می‌توانید ازطریق Google Cloud Logging به گزارش‌های رویداد برای ادغام‌هایتان دسترسی پیدا کنید. از Cloud Logging برای کاوش گزارش‌ها، ایجاد سنجه‌ها و هشدارها، یا صادر کردن گزارش‌ها به برنامه‌های دیگر بااستفاده از Google Cloud Pub/Sub استفاده کنید.
ثبت گزارش دسترسی
برای دسترسی به Cloud Logging از Google Cloud Console، روی مشاهده همه محصولات کلیک کنید، سپس به مشاهده‌پذیری > ثبت گزارش بروید.
دسترسی به داده‌های ثبت ازطریق «مدیریت هویت و دسترسی‌ها» (IAM) برای کاربران پروژه «کنش‌های» شما مدیریت می‌شود. برای جزئیات بیشتر درباره نقش‌ها و اجازه‌های ثبت داده‌ها، به کنترل دسترسی Cloud Logging مراجعه کنید.
ورودی‌های گزارش طبق خط‌مشی نگهداری Cloud Logging به‌مدت ۳۰ روز نگهداری می‌شوند، سپس برای حذف زمان‌بندی می‌شوند. همچنین می‌توانید ورودی‌ها را درصورت درخواست بااستفاده از میانای Logs Explorer حذف کنید.
در بخش «جستجوی گزارش‌ها» در راهنمای عیب‌یابی می‌توانید درباره نحوه استفاده مؤثر از گزارش‌ها بیشتر بدانید.
Cloud Logging انواع منبع زیر را ارائه می‌دهد:
| نوع منبع | نام نمایشی | شرح | برچسب‌ها |
|---|---|---|---|
assistant_action_project |
پروژه کنش «دستیار Google» | محفظه‌ای برای «پروژه Google Cloud» مرتبط با «کنش دستیار». |
|
گزارش‌های وقایع
پروژه‌های Cloud-to-cloud از رویدادهای زیر در Cloud Logging پشتیبانی می‌کنند:
| منبع Cloud Logging | رویداد |
|---|---|
| پروژه کنش «دستیار Google» | خطاهای هدف SYNC |
| خطاهای هدف پُرسمان | |
| خطاهای قصد 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 به‌طور پیش‌فرض برای دریافت گزارش‌های خطا تنظیم شده‌اند، و توسعه‌دهندگان می‌توانند برای دریافت گزارش‌های موفقیت نیز موافقت کنند. این ویژگی به‌ویژه در مرحله توسعه مفید است، زمانی که قصد دارید همه گزارش‌ها را از چند نماینده ضبط کنید. اگر از سهمیه ثبت گزارش فراتر بروید، ممکن است هزینه‌های اضافی برای پروژه‌تان اعمال شود.
می‌توانید سطح گزارش را برای پروژه‌تان ازطریق زیر کنترل کنید:
در Actions on Google Console، به صفحه «پروژه‌ها» بروید.
پروژه خانه هوشمندتان را انتخاب کنید.
برگه توسعه را انتخاب کنید و روی کنش‌ها در نوار کناری کلیک کنید.
همه را در فهرست کرکره‌ای دریافت کنترل گزارش انتخاب کنید.
کنارگذاری‌های گزارش
توسعه‌دهندگان می‌توانند بااستفاده از زبان پرسمان ثبت گزارش، استثناهای ثبت گزارش ایجاد کنند تا گزارش‌هایشان را به‌شیوه‌ای انعطاف‌پذیرتر سفارشی‌سازی کنند. «کاوشگر گزارش‌ها» نیز از زبان پُرسمان گزارش‌گیری استفاده می‌کند، بنابراین می‌توانید از «کاوشگر گزارش‌ها» برای کمک به ایجاد پُرسمان‌ها استفاده کنید.
می‌توانید مراحل ایجاد فیلترهای استثنا را در
این راهنما دنبال کنید
(فیلتر استثنا را برای سینک _Default پیکربندی کنید).
سنجه‌های مبتنی بر گزارش
توسعه‌دهندگان می‌توانند از سنجه‌های مبتنی بر گزارش برای ردیابی و تحلیل الگوها در گزارش‌هایشان استفاده کنند. همچنین می‌توانید نمودارهای سفارشی ایجاد کنید و هشدارهایی برای سنجه‌های مبتنی بر گزارش تنظیم کنید.
برای شروع استفاده از سنجه‌های مبتنی بر گزارش برای خانه هوشمند، راهنمای ایجاد سنجه مبتنی بر گزارش شمارنده را بررسی کنید.
منابع مرتبط
برای کسب اطلاعات بیشتر درباره استفاده از Cloud Logging در پروژه‌تان، به اسناد زیر مراجعه کنید:
- قیمت‌گذاری: جزئیات مربوط به تخصیص‌ها و هزینه‌های مازاد.
- سهمیه‌ها و محدودیت‌ها: جزئیات مربوط به محدودیت‌ها و خط‌مشی‌های نگهداری برای استفاده از گزارش‌گیری.
- پرس‌وجوهای پیشرفته گزارش‌ها: راهنمای استفاده از عبارت‌های پیشرفته برای پرس‌وجو و تجزیه‌وتحلیل داده‌های گزارش.