☰ فهرست مستندات · سلامت نسخه‌ها (بدون کرش)
سلامت نسخه‌ها (بدون کرش)
جلسه‌ها و کاربران بدون کرش برای هر نسخه از اپ شما، چند درصد کاربران روی هر نسخه‌اند، و جلسه‌ها در هر روز. SDKهای فلاتر، اندروید، iOS و Next.js آن را می‌فرستند؛ به‌طور پیش‌فرض روشن و رایگان است.
برای هر نسخه از اپ شما: سهم جلسه‌هایی که کرش نکردند، سهم کاربرانی که هیچ کرشی نداشتند، و چند درصد کاربران روی آن نسخه‌اند. همان عددی که فروشگاه‌های اپ و Crashlytics به آن «بدون کرش» می‌گویند.
کنسول ابرووا ← پروژه‌ی شما ← تریس ← نسخه‌ها. با پلتفرم، محیط، نسخه و بازه‌ی زمانی فیلتر کنید.
۱. SDK تازه و release را تنظیم کنید#
سلامت نسخه‌ها در SDKهای اپ به‌طور پیش‌فرض روشن است:
| SDK | از نسخه‌ی |
|---|---|
| فلاتر | 0.3.1 |
| اندروید | 0.3.0 |
| iOS | 0.3.0 |
| Next.js (در مرورگر) | 0.2.0 |
release را برابر نسخه‌ی اپتان بگذارید تا هر نسخه ردیف خودش را داشته باشد. همان مقداری را بدهید که برای خطاها و source mapها می‌دهید:
// Flutter await AbrovaTrace.init(AbrovaTraceConfig( apiKey: 'ab_live_your_api_key', release: '2.4.0+31', ));
SDKهای سرور (Node.js و لاراول) جلسه نمی‌فرستند: سرور جلسه ندارد.
۲. جلسه و کرش چه حساب می‌شود#
| قاعده | |
|---|---|
| جلسه | با باز شدن اپ شروع می‌شود، و دوباره وقتی اپ بعد از ۳۰ دقیقه یا بیشتر در پس‌زمینه برمی‌گردد. در مرورگر: یکی برای هر زبانه، که با بارگذاری دوباره‌ی صفحه می‌ماند. |
| جلسه‌ی کرش‌کرده | با خطای گرفته‌نشده یا کرش بومی تمام می‌شود (اندروید: کرش جاوا و بومی؛ iOS: سیگنال‌ها و exceptionهای گرفته‌نشده). کرش بومی در اجرای بعدی گزارش می‌شود. |
| کرش نیست | هنگ کردن (ANR)، بستن اپ به دست کاربر یا سیستم، و خطایی که خودتان می‌گیرید و گزارش می‌کنید. |
| مرورگر | فقط خطای کد خودتان: خطایی که ErrorBoundary شما می‌گیرد، یا خطای گرفته‌نشده‌ای که اسکریپتش روی سایت خودتان است. افزونه‌های مرورگر و اسکریپت سایت‌های دیگر حساب نمی‌شوند. |
| کاربر | یک نصب اپ. کاربری که اپ را روی دو گوشی دارد دو بار شمرده می‌شود؛ کسی که بعداً وارد حسابش می‌شود همان کاربر می‌ماند. |
۳. خواندن صفحه‌ی نسخه‌ها#
| عدد | چه می‌گوید |
|---|---|
| جلسه‌های بدون کرش | جلسه‌های بدون کرش از همه‌ی جلسه‌های بازه. از ۹۹٫۵٪ سبز، از ۹۸٪ نارنجی و کمتر از آن قرمز. |
| کاربران بدون کرش | کاربرانی (نصب‌هایی) که در بازه هیچ کرشی نداشتند. وقتی چند کاربر زیاد کرش می‌کنند از عدد جلسه‌ها کمتر است. |
| سهم کاربران | سهم همه‌ی کاربران بازه که از این نسخه استفاده کردند: نسخه‌ی تازه چقدر پخش شده. |
| جلسه‌ها در هر روز | جلسه‌هایی که عادی تمام شدند، و کرش‌کرده‌ها به رنگ قرمز. |
هر نسخه به مشکل‌های خودش پیوند دارد، پس از «نسخه‌ی 2.4.0 روی ۹۷٪ است» یک‌راست به چیزی می‌رسید که در 2.4.0 کرش می‌کند.
برای اینکه وقتی نسخه‌ی تازه زیاد کرش می‌کند باخبر شوید، در همان صفحه ساخت هشدار را بزنید: یک قانون هشدار از نوع جلسه‌های بدون کرش، مثلاً کمتر از ۹۹٪ در ۲۴ ساعت، با ایمیل، وب‌هوک یا ابرووا تیم.
کاربران درگیر در هر مشکل#
هر مشکل کاربران درگیر را هم نشان می‌دهد: چند کاربر (نصب اپ) در ۳۰ روز گذشته آن را داشتند، و برای هر نسخه سهم آن از کاربران همان نسخه، مثلاً «۲۵٪ کاربران · ۵ از ۲۰» در 2.4.0. خطاهایی شمرده می‌شوند که SDK اپ شما همراه جلسه‌شان فرستاده، پس نسخه‌های بالا لازم است. کرش بومی که در اجرای بعدی گزارش می‌شود فعلاً آنجا شمرده نمی‌شود.
۴. چه چیزی فرستاده می‌شود#
برای هر جلسه SDK این‌ها را می‌فرستد: یک شناسه‌ی نصب تصادفی که خود SDK در اولین اجرا می‌سازد (هرگز شناسه‌ی دستگاه، شناسه‌ی تبلیغات یا Android ID نیست)، یک شناسه‌ی جلسه‌ی تصادفی، زمان شروع، release، محیط، پلتفرم و شناسه‌ی کاربری که خودتان تنظیم کرده‌اید. گزارش‌هایی که هنگام آفلاین بودن فرستاده نشوند روی دستگاه می‌مانند و بعداً فرستاده می‌شوند.
۵. خاموش کردن#
| SDK | گزینه |
|---|---|
| فلاتر | AbrovaTraceConfig(enableReleaseHealth: false) |
| اندروید | AbrovaTraceConfig.Builder(apiKey).enableReleaseHealth(false) |
| iOS | AbrovaTraceConfig(apiKey: …, enableReleaseHealth: false) |
| Next.js | AbrovaTrace.init({ …, enableReleaseHealth: false }) |
جلسه‌ها جزو طرح شما حساب نمی‌شوند و هزینه‌ای ندارند. آمارها ۹۰ روز نگه داشته می‌شوند.
به‌روزرسانی: ۲۳ آبان ۱۴۰۵