فیلتر کردن گزارش‌ها و ایجاد معیارهای مبتنی بر گزارش

پس‌از اینکه داده‌های Crashlytics و (اختیاری) داده‌های جلسه‌های Firebase به Cloud Logging صادر شد، می‌توانید گزارش‌هایتان را فیلتر کنید و سنجه‌های مبتنی بر گزارش ایجاد کنید. هر دوی این موارد برای مشاهده، استفاده، و تجزیه‌وتحلیل داده‌های خاص مفید هستند.

اگر هنوز این کار را نکرده‌اید، حتماً با داده‌هایتان چه کاری می‌توانید انجام دهید؟ را برای فهرست کامل و نمونه‌هایی از کار با داده‌های ذخیره‌شده در Cloud Logging بررسی کنید.

فیلتر کردن گزارش‌ها با پُرسمان‌ها

فیلتر کردن گزارش‌هایتان برای مشاهده داده‌های خاص و همچنین کاهش هزینه‌های ذخیره‌سازی داده‌ها و تجزیه‌وتحلیل بیشتر مفید است. گزارش‌ها را بااستفاده از LQL (زبان پُرسمان گزارش‌گیری) فیلتر می‌کنید.

برای آشنایی با نحوه فیلتر کردن گزارش‌هایتان با پُرسمان، به پُرسمان‌های نمونه بااستفاده از Logs Explorer و ساختن پُرسمان‌های گزارش مراجعه کنید. جدول زیر فیلدهای دردسترس برای این پُرسمان‌ها را شرح می‌دهد.

فیلترهای نمونه

برای Crashlytics، در اینجا چند فیلتر اولیه نمونه برای یک پُرسمان آورده شده است:

• پیدا کردن همه خرابی‌های مهلک برای نسخه خاصی از برنامه:

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
  jsonPayload.issue.errorType="FATAL"
  jsonPayload.version.displayVersion="3.2.0"

• شناسایی خرابی‌های رخ‌داده در مدل دستگاه خاص (برای مثال، Pixel 6a):

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
  jsonPayload.device.model="Pixel 6a"

• جستجوی OutOfMemoryError خاص در همه رویدادهای مرگبار:

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
  jsonPayload.issue.errorType="FATAL"
  jsonPayload.issue.subtitle="java.lang.OutOfMemoryError"

• پیدا کردن رویدادها برای شناسه مشکل Crashlytics خاص:

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
  jsonPayload.issue.id="ISSUE_ID"

طرح‌واره گزارش

هر ورودی گزارش ساختار ازپیش‌تعریف‌شده و فیلدهای پُرسمان‌پذیر دارد (به LogEntry مراجعه کنید).

درباره طرحواره گزارش برای داده‌های صادرشده، شامل Crashlytics داده‌ها، داده‌های جلسات Firebase، و گزارش‌های دستگاه بیشتر بدانید.

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

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

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

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

• از Cloud Monitoring برای ثبت تعداد ورودی‌های گزارش حاوی پیام‌های خاص یا استخراج اطلاعات تأخیر گزارش‌شده در ورودی‌های گزارش استفاده کنید. سپس می‌توانید از این سنجه‌ها در نمودارها و هشدارهای سفارشی استفاده کنید.

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

در اینجا دو نمونه از سنجه‌های مبتنی بر گزارش تعریف‌شده توسط کاربر وجود دارد که می‌توانید از داده‌های جلسه‌های Crashlytics و Firebase صادرشده خود ایجاد کنید:

• استفاده از داده‌های Crashlytics:
  سنجه‌ای به‌نام firebase/crashlytics_events با برچسب errorType ایجاد کنید، و آن را به‌صورت زیر تعریف کنید:

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

• بااستفاده از داده‌های جلسه‌های Firebase:
  سنجه‌ای به‌نام firebase/session_events با برچسب eventType ایجاد کنید، و آن را به‌صورت زیر تعریف کنید:

  logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

قدم بعدی چیست؟

• برای دیداری‌سازی سریع داده‌ها، نمودارهای موقت ایجاد کنید.

• داشبوردهای سفارشی برای پایش بلندمدت و پیشرفته بسازید.

• راه‌اندازی و ارسال هشدارهای سفارشی به کانال‌های اعلان سفارشی.