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

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

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

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

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

برای آشنایی با نحوه فیلتر کردن گزارش‌ها با پُرسمان، به پُرسمان‌های نمونه بااستفاده از 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"

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