شروع سریع
از صفر تا ثبت اولین استثنا، در پنج دقیقه.
۱. ورود
ورود به ارورا با شمارهٔ موبایل ایران (09XXXXXXXXX) انجام می‌شود.
- وارد پنل شوید و روی ورود بزنید.
- شمارهٔ موبایل را وارد کنید. ارورا می‌گوید این شماره حساب دارد یا نه و آیا برایش رمز عبور تعریف شده است.
- با رمز عبور یا با کد یک‌بارمصرفی که پیامک می‌شود وارد شوید.
شماره‌ای که تازه وارد می‌شود، حساب می‌گیرد و همراه آن یک سازمان شخصی و اعتبار هدیهٔ ثبت‌نام (به‌طور پیش‌فرض ۱۰۰٬۰۰۰ تومان) دریافت می‌کند. برای رمز عبور، کد یک‌بارمصرف و ورود دومرحله‌ای به احراز هویت سر بزنید.
۲. ساخت پروژه
پروژه یعنی یک برنامه (یا یک سرویس) که می‌خواهید داده‌هایش جدا نگه داشته شود.
- به پروژه‌ها ← پروژهٔ جدید بروید.
- نام بگذارید و پلتفرم را انتخاب کنید:
javascript،node،python،php،php-laravel،goیاother. پلتفرم فقط آیکون و نمونه‌کد راه‌اندازی را تعیین می‌کند؛ دریافت داده برای همه یکسان است. - ارورا پروژه و یک کلید DSN برایش می‌سازد.
۳. برداشتن DSN
DSN در صفحهٔ پروژه نمایش داده می‌شود و قالب استاندارد Sentry را دارد:
https://<public_key>@<your-errora-host>/<project_id>
هر کسی این DSN را داشته باشد می‌تواند به پروژه داده بفرستد؛ پس مثل یک اعتبارنامهٔ فقط‌نوشتنی با آن رفتار کنید. می‌توانید از همان صفحه کلید تازه بسازید یا کلید قبلی را بچرخانید — نگاه کنید به پروژه‌ها و کلیدهای DSN.
۴. نصب SDK رسمی Sentry
ارورا با پروتکل Sentry حرف می‌زند، پس از SDK رسمی Sentry پلتفرم خودتان استفاده می‌کنید و هیچ چیز اختصاصی ارورا نصب نمی‌شود.
pip install sentry-sdk # پایتون
npm install @sentry/node # Node.js
npm install @sentry/browser # مرورگر
composer require sentry/sentry-laravel # لاراول
go get github.com/getsentry/sentry-go # Go
سپس DSN را به آن بدهید:
import sentry_sdk
sentry_sdk.init(
dsn="https://<public_key>@<your-errora-host>/<project_id>",
environment="production",
release="myapp@1.4.2",
traces_sample_rate=1.0, # ردیابی کارایی
)
راهنمای کامل هر پلتفرم: راه‌اندازی SDK.
۵. ارسال یک رویداد آزمایشی
عمداً یک استثنا بسازید:
sentry_sdk.capture_exception(Exception("Hello from Errora"))
یا اصلاً بدون SDK، مستقیم به نقطهٔ دریافت درخواست بزنید:
curl -X POST "https://<your-errora-host>/api/<project_id>/store/" \
-H "Content-Type: application/json" \
-H "X-Sentry-Auth: Sentry sentry_version=7, sentry_key=<public_key>" \
-d '{
"event_id": "'"$(uuidgen | tr -d - | tr "A-Z" "a-z")"'",
"timestamp": "'"$(date -u +%Y-%m-%dT%H:%M:%SZ)"'",
"platform": "other",
"level": "error",
"exception": {"values": [{"type": "SmokeTest", "value": "Hello from Errora"}]}
}'
پاسخ بی‌درنگ 202 Accepted است؛ گروه‌بندی بلافاصله بعد از آن انجام می‌شود و رویداد لحظاتی بعد
در پنل دیده می‌شود.
۶. دیدن نتیجه در پنل
صفحهٔ خطاها را باز کنید. استثنای شما آنجاست، گروه‌شده بر اساس نوع و ردپای فراخوانی، همراه با تعداد رخداد، اولین/آخرین مشاهده، ردپای کامل، بردکرامب‌ها، اطلاعات درخواست و برچسب‌ها.
اگر چیزی نرسید:
| نشانه | علت محتمل |
|---|---|
پاسخ 401 از نقطهٔ دریافت | کلید DSN اشتباه یا غیرفعال است، یا کلید متعلق به پروژهٔ دیگری است |
پاسخ 202 ولی خطایی ثبت نشده | نرخ نمونه‌برداری پروژه کمتر از 1.0 است و رویداد ذخیره نشده |
پاسخ 429 با پیام تعلیق | موجودی کیف پول سازمان از خط اعتبار گذشته — کیف پول |
| اصلاً چیزی از برنامه خارج نمی‌شود | SDK اصلاً مقداردهی اولیه نشده؛ گزینهٔ debug آن را روشن کنید |
گام بعدی
- بقیهٔ محصولات را روشن کنید — ردیابی کارایی، لاگ، بازپخش نشست، پروفایلینگ، متریک.
- از خرابی‌ها باخبر شوید — هشدارها و کانال‌های اعلان.
- تیم‌تان را دعوت کنید — سازمان‌ها و اعضا.
- راهنمای تصویری را ببینید — راهنمای تصویری محصول.