سفارشی‌سازی کردن گزارش‌های خرابی Crashlytics

می‌توانید روی مشکلی کلیک کنید و گزارش رویداد دقیقی را در داشبورد DevOps و تعامل > Crashlytics در کنسول Firebase دریافت کنید. می‌توانید این گزارش‌ها را سفارشی‌سازی کنید تا به شما کمک کند آنچه را در برنامه‌تان اتفاق می‌افتد و شرایط پیرامون رویدادهای گزارش‌شده به Crashlytics را بهتر درک کنید.

ثبت کلیدهای سفارشی

کلیدهای سفارشی به شما کمک می‌کنند تا وضعیت خاص برنامه‌تان را که منجر به خرابی شده است دریافت کنید. می‌توانید جفت‌های کلید-مقدار دلخواه را با گزارش‌های خرابی مرتبط کنید، سپس از کلیدهای سفارشی برای جستجو و فیلتر کردن گزارش‌های خرابی در کنسول Firebase استفاده کنید.

دستورالعمل‌های ثبت کلیدهای سفارشی را مشاهده کنید: iOS+ Android Web Flutter Unity

ثبت پیام‌های گزارش سفارشی

برای اینکه اطلاعات زمینه‌ای بیشتری درباره رویدادهای منتهی به خرابی داشته باشید، می‌توانید گزارش‌های Crashlytics سفارشی به برنامه‌تان اضافه کنید. Crashlytics گزارش‌ها را با داده‌های خرابی مرتبط می‌کند و آن‌ها را در داشبورد Crashlytics نمایش می‌دهد.

دستورالعمل‌های ثبت پیام‌های گزارش سفارشی را مشاهده کنید: iOS+ Android Flutter Unity

شناسه‌های کاربر گزارش

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

دستورالعمل‌های ثبت شناسه کاربر را مشاهده کنید: iOS+ Android Flutter Unity

گزارش استثناها

علاوه‌بر گزارش خودکار رویدادهای مهلک برنامه‌تان (مثل ازکارافتادن‌ها)، Crashlytics SDK می‌تواند استثناهای غیرمهلک را به‌عنوان رویدادهای غیرمهلک گزارش کند. برای Futter و Unity، اگر استثناهایی دارید که انتظار می‌رود، می‌توانید از SDK بخواهید آن‌ها را به‌عنوان رویدادهای غیرمهلک نیز گزارش کند. برای برنامه‌های وب، می‌توانید علاوه‌بر استثناهای غیرقابل‌کنترل و خطاهای مسیریابی، استثناهای کنترل‌شده را نیز به‌صورت دستی گزارش کنید.

برای برنامه‌های تلفن همراه، این رویدادهای غیرمهلک در دستگاه ثبت می‌شوند و سپس همراه با گزارش رویداد مهلک بعدی یا زمانی که کاربر نهایی برنامه را بازراه‌اندازی می‌کند ارسال می‌شوند.

دستورالعمل‌های گزارش کردن استثناها را مشاهده کنید: iOS+ Android وب Flutter Unity

دریافت گزارش‌های ردپای رخدادها

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

دستورالعمل‌های دریافت گزارش ردپای رخدادها را مشاهده کنید: iOS+ Android Flutter Unity

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

به‌طور پیش‌فرض، Crashlytics گزارش‌های خرابی را به‌طور خودکار برای همه کاربران برنامه‌تان جمع‌آوری می‌کند. برای اینکه کاربران کنترل بیشتری بر داده‌هایی که ارسال می‌کنند داشته باشند، می‌توانید گزارش‌دهی با موافقت را با غیرفعال کردن گزارش‌دهی خودکار و ارسال داده به Crashlytics فقط زمانی که در کدتان انتخاب می‌کنید فعال کنید.

دستورالعمل‌های فعال کردن گزارش‌دهی با موافقت کاربر را مشاهده کنید: iOS+ Android Flutter Unity

پاک‌سازی اجباری سوابق دورسنجی

به‌طور پیش‌فرض، موتور دورسنجی وب گزارش‌ها را قبل‌از بارگذاری در حافظه دسته‌بندی می‌کند. برای محیط‌های اجرای کوتاه‌مدت، می‌توانید بارگذاری فوری خطاهای صف‌بندی‌شده را قبل‌از پایان یا بارگیری مجدد بافت اجرا اجباری کنید.

دستورالعمل‌های پاک کردن سوابق دورسنجی را مشاهده کنید: وب

پیکربندی نرخ نمونه‌برداری

برای برنامه‌های وب، می‌توانید نرخ نمونه‌برداری را در کنسول Firebase یا بااستفاده از Firebase Telemetry Admin API پیکربندی کنید تا بخشی از جلسه‌های کاربر را نمونه‌برداری کنید و حجم و هزینه دورسنجی را کنترل کنید.

دستورالعمل‌های پیکربندی نرخ نمونه‌برداری را مشاهده کنید: وب

غیرفعال یا فعال کردن جمع‌آوری دورسنجی

برای برنامه‌های وب، جمع‌آوری دورسنجی به‌طور پیش‌فرض هنگام راه‌اندازی Crashlytics فعال است. می‌توانید نقاط پایانی مجموعه دورسنجی را به‌طور پویا بااستفاده از Firebase Telemetry Admin API غیرفعال یا دوباره فعال کنید.

دستورالعمل‌های غیرفعال یا فعال کردن جمع‌آوری دورسنجی را مشاهده کنید: وب

گزارش‌های GWP-ASan را برای اشکال‌زدایی مشکلات خرابی حافظه اضافه کنید

Crashlytics می‌تواند با جمع‌آوری گزارش‌های GWP-ASan به شما کمک کند خرابی‌های ناشی از خطاهای حافظه محلی را اشکال‌زدایی کنید. این خطاهای مربوط به حافظه می‌تواند با خرابی حافظه در برنامه شما مرتبط باشد که علت اصلی آسیب‌پذیری‌های امنیتی برنامه است.

دستورالعمل‌های مربوط به گنجاندن گزارش‌های GWP-ASan را مشاهده کنید: Android NDK Unity