وقتی کاربر میگوید «پرداخت نشد»، احتمالاً چند سؤال دارید. آشکار خطا، مسیر کاربر و درخواستهای شبکه را کنار هم میگذارد تا تیم شما بداند چه گذشته و با اطلاعات بیشتری سراغ رفع مشکل برود.
روی زیرساخت ابری آشکار یا سرورهای خودتان.برای فهمیدن یک خطا، دانستن اینکه کجا رخ داده کافی نیست. مرورگر چه وضعیتی داشته؟ کدام درخواست ناموفق بوده؟ آشکار این جزئیات را در دسترس تیم شما قرار میدهد.
مسیر کاربر، از جابهجایی بین صفحهها تا درخواستهای شبکه، کنار خطا ثبت میشود. میتوانید ببینید کاربر چطور به این نقطه رسیده است.
SESSION CONTEXTخطاهای مشابه در یک مسئله جمع میشوند تا پیگیریشان آسانتر باشد. تعداد تکرار، مسئول رسیدگی و وضعیت حل مشکل، همانجا مشخص است.
ISSUE GROUPINGمعلوم است کدام خطا با نسخهی جدید آمده و کدام دوباره برگشته است. با اضافه کردن Source Map، محل خطا را در فایل اصلی کد هم میبینید.
RELEASE HEALTHشما انتخاب میکنید چه زمانی بازپخش نشست فعال باشد و دادهها چقدر بمانند. بازپخش بهصورت پیشفرض خاموش است و هنگام ضبط، متنها و ورودیها پوشانده میشوند.
DATA CONTROLSکاربر روی دکمهی پرداخت زده و به مشکل خورده است. در این مثال، آشکار نشان میدهد کمی قبل از خطای مرورگر، درخواست پرداخت هم ناموفق بوده است.
وقتی رخدادها زیاد میشوند، یک جمعبندی اولیه کمک بزرگی است. دستیار آشکار اطلاعات موجود را مرور میکند، علت احتمالی را توضیح میدهد و پیشنهاد میکند بررسی را از کجا شروع کنید. تصمیم نهایی همچنان با تیم شماست.
این قابلیت اختیاری است؛ پس از تنظیم سرویس تحلیل، مدیر پروژه میتواند آن را فعال کند.
خطا بعد از پاسخ ۵۰۲ رخ داده است. پیشنهاد میشود بررسی کنید آیا کد، پیش از خواندن دادهی پرداخت، موفق بودن درخواست را کنترل میکند.
راهاندازی آشکار با ساخت یک پروژه و اضافه کردن SDK شروع میشود. بعد از ارسال یک خطای آزمایشی، میتوانید در داشبورد ببینید چه اطلاعاتی از برنامهی شما ثبت شده است.
npm install @ashkarhq/browserimport { init } from "@ashkarhq/browser";
const ashkar = init({
dsn: "/api/v1/events",
projectKey: "YOUR_PUBLIC_KEY",
environment: "production",
release: "[email protected]",
tracesSampleRate: 0.2,
});میتوانید از سرویس ابری استفاده کنید یا آشکار را روی سرورهای خودتان داشته باشید. انتخاب به نیاز تیم و محل نگهداری دادهها بستگی دارد.
برای تیمهایی که میخواهند بدون نگهداری سرور، از آشکار استفاده کنند.
برای سازمانهایی که نگهداری داده و مدیریت زیرساخت باید در اختیار خودشان باشد.
| روش استفاده | آشکار ابری | روی سرور شما |
|---|---|---|
| محل نگهداری داده | زیرساخت آشکار | زیرساخت شما |
| راهاندازی | ساخت حساب و اتصال SDK | نصب سرویسها و اتصال SDK |
| مدیریت زیرساخت | با تیم آشکار | با تیم شما |
| زمان بهروزرسانی | با مدیریت آشکار | با برنامهریزی شما |
چند نکته دربارهی راهاندازی، امکانات و انتخاب روش استفاده از آشکار.
آشکار برای تیمهایی ساخته شده که محصولشان در مرورگر استفاده میشود؛ از فروشگاه آنلاین تا نرمافزارهای سازمانی. SDK مرورگر از JavaScript و TypeScript پشتیبانی میکند و برای React و Vue هم بستههای مخصوص داریم.
انتخاب راهنمای استکبله. در بخش عملکرد میتوانید زمان بارگذاری صفحه، درخواستهای کند و شاخصهای Web Vitals را ببینید. مقایسهی نسخهها هم کمک میکند متوجه شوید تغییرات اخیر چه اثری روی سرعت برنامه داشتهاند.
راهنمای پایش عملکردخیر، برای دیدن اتفاقهای قبل از خطا نیازی به ضبط صفحه نیست. اطلاعاتی مثل جابهجایی بین صفحهها و درخواستهای شبکه جداگانه ثبت میشوند. بازپخش نشست (Session Replay) اختیاری و در ابتدا خاموش است؛ اگر آن را فعال کنید، متنها و ورودیها هنگام ضبط پوشانده میشوند.
جزئیات بازپخش و حریم خصوصیبله، با بارگذاری Source Map نسخهی منتشرشده و تنظیم شناسهی همان نسخه در SDK، آشکار محل خطا را به فایل و خط اصلی کد برمیگرداند. راهنمای این کار در مستندات انتشار آمده است.
راهنمای نسخهها و Source Mapخیر، انتخاب با شماست. این قابلیت پس از تنظیم سرویس تحلیل و فعالسازی توسط مالک یا مدیر پروژه در دسترس قرار میگیرد. اطلاعات پالایششده برای سرویس تحلیل فرستاده میشوند و نتیجه به تیم شما پیشنهاد میشود؛ کد و وضعیت مسئله خودکار تغییر نمیکنند.
دیدن نمونهی تحلیلبله. نسخهی On-premise آشکار روی زیرساخت شما نصب میشود و دادههای پروژه همانجا نگهداری میشوند. این گزینه برای تیمهایی مناسب است که محل نگهداری داده و مدیریت زیرساخت باید در اختیار خودشان باشد. سرویسهای بیرونی مثل AI و کانالهای اعلان، جداگانه تنظیم میشوند.
دربارهی نصب روی سرورهای شمابعد از نصب SDK، یک خطای آزمایشی از برنامهی خودتان بفرستید. اگر خطا با محیط و نسخهی مورد انتظار در داشبورد دیده شود، اتصال برقرار است. مراحل ارسال این خطا را در راهنمای شروع توضیح دادهایم.
انتخاب استک و شروعبا اتصال اولین پروژه، آشکار به تیم شما کمک میکند
خطاها را با اطلاعاتی که برای پیگیریشان لازم دارید ببینید.