مفاهیم و اصطلاحات سنتری

Event

رخداد‌های ارسال شده به سنتری شامل error و transaction

نرخ ارسال رخداد‌ به سمت سنتری همروش بر اساس پلن انتخابی شما و در بازه‌های ۱ دقیقه، ۱ ساعت، ۱ روز و ۱ ماه محدود می‌شود.

هر گونه اطلاعات و دیتایی که از سمت اپلیکیشن یا کاربر به سنتری ارسال می‌شود محاسبه می‌شود و به ازای هر خطا ممکن است یک یا چند event به سنتری ارسال شود.

در حال حاضر event های از نوع error در sentry همروش پشتیبانی می‌شود و انواع دیگر به صورت آزمایشی در اختیار کاربران قرار می‌گیرد.

Error

تعریف خطا بسته به پلتفرم مورد نظر متغیر است اما بطور کلی سنتری رخدادهایی از قبیل exception و unhandled rejections را error شناسایی می‌کند. می‌توانید خطا های دریافتی خود را از بخش Issues مشاهده و مدیریت کنید. سنتری error هایی را که در بخش های یکسان کد رخ داده اند تجمیع می‌کند و بر اساس تعداد خطاها، زمان و... در دسته های مختلف issue طبقه بندی می‌شوند.

Transaction

به ازای هر رخداد سرویس که لازم است از نظر زمان و performance اندازه‌گیری شود یک transaction ساخته می‌شود. رخداد ها شامل لود شدن page تغییر مسیر یا انجام یک تسک هستند.

به صورت کلی در صورت فعال شدن این قابلیت در SDK، به ازای تمامی عملیات های موجود در کد این قابلیت اجرا می‌شود. در نتیجه این موضوع ممکن است نرخ ارسالی بسیار زیاد باشد و در این صورت برخی transaction ها با محدودیت plan مواجه شده و محاسبه نشوند.

برای این که دقت محاسبات حفظ شود شما می‌توانید از قابلیت sampling استفاده کنید و درصدی از transaction ها را برای اندازه گیری ارسال کنید. برای ارسال تعدادی مشخص از این نوع event به سنتری می‌توانید متغیر tracesSampleRate را تعریف کنید. مقدار مجاز برای تعریف این متغیر بین بازه‌ی 0.0 تا 1.0 می‌تواند تعریف شود. برای مثال اگر مقدار تعریف شده 1.0 باشد، نتیجه‌ی تمام transaction های موجود در سورس کد به سنتری ارسال و ذخیره می‌شود.

برای مشاهده‌ی مستندات tracesSampleRate به این لینک مراجعه کنید.

DSN (Data Source Name)

یک DSN به سنتری SDK اعلام می‌کند که event ها را به چه سمت ارسال کند. در نتیجه این موضوع event ها به پروژه مشخصی نسبت داده می‌شوند. برای دریافت این لینک:

• اگر پروژه‌ای ندارید یک پروژه ایجاد کنید و راهنمایی های لازم را در صفحه ایجاد پروژه دریافت کنید.
• برای پروژه‌های موجود می‌توانید از بخش تنظیمات پروژه و قسمت Client Keys لینک مربوطه را پیدا کنید.

Attachment

فایل‌های اضافی ذخیره شده در سنتری مثل کانفیگ یا لاگ فایل هایی که به یک error مرتبط هستند.

Environment

در واقع یک tag است که می توانید به SDK خود اضافه کنید و قرار است به محیط deployment شما اشاره کند. مثلا محیط development, testing, staging, production. این tag به فیلتر کردن issue کمک بسیاری می‌کند.

issue

گروهی از error های مشابه به هم یا مشکلات performance مشابه

release

یک ورژن از کد شماست که در یک environment دیپلوی می‌شود. وقتی سنتری را از release جدید مطلع می‌کنید اگر issue جدید یا مشکلی در release ایجاد شود به آن release متصل می‌شود.

Sentry SDK

لایبرری های سنتری که مختص زبان یا framework خاصی توسعه داده شده و به عنوان بخشی از کد شما وظیفه جمع‌آوری دیتای ارور و پرفورمنس را دارد.

Alerts

هشدار‌ها به شما اجازه می‌دهند تا در صورتی که مشکلی در مورد کد شما پیش بیاید از آن مطلع شوید. امکان تنظیم هشدار‌های custom نیز برای شما وجود دارد.

Team

مجموعه‌ای از افراد است که بر روی یک یا چند پروژه کار می‌کنند. در صورتی که مشکلی بر روی پروژه ایجاد شود تیم متناظر آن مطلع می‌شوند.

• ساخت سنتری در هم‌روش