Crashlytics حالا برای وب هم اومده
خلاصهٔ کاملتر
تیم فایربیس میگه با ابزارهای کدنویسی هوش مصنوعی، ساختن و دیپلوی یه فیچر جدید چند دقیقه طول میکشه، ولی سؤال اصلی اینه که اون فیچر توی پروداکشن واقعاً پایدار هست یا نه. ممکنه تستها پاس بشن و لاگهای سرور هم مشکلی نشون ندن، ولی جاوااسکریپت توی مرورگر کاربر داره کرش میکنه. Crashlytics for web که الان در مرحلهٔ پیشنمایش عمومی (public preview) هست، دقیقاً برای همین ساخته شده.
این ابزار وقتی یه خطای جدید ظاهر بشه یا خطایی که قبلاً رفع شده دوباره برگرده، بهت ایمیل هشدار میده. از لینک هشدار میری توی کنسول فایربیس و برای هر session آسیبدیده، خط دقیقی که خطا ازش اومده رو میبینی. بعد میتونی خودت دیباگ کنی یا از ایجنت کدنویسیت بخوای بررسیش کنه.
زیرساختش روی Google Cloud Observability و OpenTelemetry (یعنی یه استاندارد باز برای جمعکردن لاگ و متریک) ساخته شده. نتیجهش اینه که لاگ کرشهای وب کنار لاگهای سرورت مثلاً از Cloud Run دیده میشه و میتونی کل استک رو یه جا دیباگ کنی. اگه برای بکاند از Error Reporting استفاده میکنی، خطاهای وب هم همونجا گروهبندی میشن. به خاطر همین وابستگی، این سرویس پلن پرداخت به ازای مصرف Blaze رو لازم داره که یه سطح رایگان دستودلباز داره و نرخ نمونهبرداری (sampling rate) هم قابل تنظیمه تا حجم داده و هزینه دستت باشه.
راهاندازی از کنسول فایربیس، از Firebase CLI با دستور firebase crashlytics:setup یا با agent skills انجام میشه. برای Next.js، React و Angular یکپارچهسازی آماده هست و برای بقیهٔ فریمورکها میشه خطاها رو دستی گزارش کرد. توی React کافیه کامپوننت رو نزدیک ریشهٔ اپ بذاری تا listenerهای سراسری error و unhandledrejection رو ثبت کنه:
const app = initializeApp(firebaseConfig);
export default function App() {
return (
<>
<FirebaseCrashlytics firebaseApp={app} crashlyticsOptions={{ appVersion: import.meta.env.VITE_APP_VERSION }} />
<MainContent />
</>
);
}با appVersion میتونی خطاها رو بر اساس نسخهٔ ریلیز فیلتر کنی. با React Router هم الگوی مسیر (مثلاً /profile/:userId) کنار هر خطا ثبت میشه تا راحتتر بفهمی خطا از کجا اومده.
اگه بیلدت مرحلهٔ کامپایل یا minify داره، شماره خطهای گزارششده به درد نمیخوره. برای همین میتونی source mapها (یعنی فایلهایی که کد فشرده رو به کد اصلی وصل میکنن) رو با دستور firebase crashlytics:sourcemap:upload آپلود کنی تا اسم فایل و شماره خط اصلی رو ببینی. فلگ --clean هم بعد از آپلود فایلهای source map محلی رو پاک میکنه تا ناخواسته روی پروداکشن منتشر نشن.
نکات کلیدی:
- Crashlytics for web الان در مرحلهٔ public preview هست.
- برای خطاهای جدید و خطاهای برگشته (regression) هشدار ایمیلی میده.
- روی Google Cloud Observability و OpenTelemetry ساخته شده و پلن Blaze لازم داره.
- یکپارچهسازی آماده برای Next.js، React، React Router، TanStack Router و Angular داره.
- آپلود source map با Firebase CLI انجام میشه و فلگ --clean فایلهای محلی رو پاک میکنه.




