# شروع سریع

> https://docs.errora.org/getting-started/quickstart

از صفر تا ثبت اولین استثنا، در پنج دقیقه.

## ۱. ورود

ورود به ارورا با **شمارهٔ موبایل ایران** (`09XXXXXXXXX`) انجام می‌شود.

1. وارد پنل شوید و روی **ورود** بزنید.
2. شمارهٔ موبایل را وارد کنید. ارورا می‌گوید این شماره حساب دارد یا نه و آیا برایش رمز عبور
   تعریف شده است.
3. با **رمز عبور** یا با **کد یک‌بارمصرفی** که پیامک می‌شود وارد شوید.

شماره‌ای که تازه وارد می‌شود، حساب می‌گیرد و همراه آن یک **سازمان شخصی** و **اعتبار هدیهٔ
ثبت‌نام** (به‌طور پیش‌فرض ۱۰۰٬۰۰۰ تومان) دریافت می‌کند. برای رمز عبور، کد یک‌بارمصرف و ورود
دومرحله‌ای به [احراز هویت](/account/auth) سر بزنید.

## ۲. ساخت پروژه

**پروژه** یعنی یک برنامه (یا یک سرویس) که می‌خواهید داده‌هایش جدا نگه داشته شود.

1. به **پروژه‌ها ← پروژهٔ جدید** بروید.
2. نام بگذارید و پلتفرم را انتخاب کنید: `javascript`، `node`، `python`، `php`، `php-laravel`،
   `go` یا `other`. پلتفرم فقط آیکون و نمونه‌کد راه‌اندازی را تعیین می‌کند؛ دریافت داده برای
   همه یکسان است.
3. ارورا پروژه و یک **کلید DSN** برایش می‌سازد.

## ۳. برداشتن DSN

DSN در صفحهٔ پروژه نمایش داده می‌شود و قالب استاندارد Sentry را دارد:

```text
https://<public_key>@<your-errora-host>/<project_id>
```

هر کسی این DSN را داشته باشد می‌تواند به پروژه داده بفرستد؛ پس مثل یک اعتبارنامهٔ فقط‌نوشتنی با
آن رفتار کنید. می‌توانید از همان صفحه کلید تازه بسازید یا کلید قبلی را بچرخانید — نگاه کنید به
[پروژه‌ها و کلیدهای DSN](/account/projects-and-keys).

## ۴. نصب SDK رسمی Sentry

ارورا با پروتکل Sentry حرف می‌زند، پس از **SDK رسمی Sentry** پلتفرم خودتان استفاده می‌کنید و
هیچ چیز اختصاصی ارورا نصب نمی‌شود.

```bash
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 را به آن بدهید:

```python
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](/platforms/overview).

## ۵. ارسال یک رویداد آزمایشی

عمداً یک استثنا بسازید:

```python
sentry_sdk.capture_exception(Exception("Hello from Errora"))
```

یا اصلاً بدون SDK، مستقیم به نقطهٔ دریافت درخواست بزنید:

```bash
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` با پیام تعلیق | موجودی کیف پول سازمان از خط اعتبار گذشته — [کیف پول](/billing/wallet) |
| اصلاً چیزی از برنامه خارج نمی‌شود | SDK اصلاً مقداردهی اولیه نشده؛ گزینهٔ `debug` آن را روشن کنید |

## گام بعدی

- **بقیهٔ محصولات را روشن کنید** — [ردیابی کارایی](/products/performance)،
  [لاگ](/products/logs)، [بازپخش نشست](/products/session-replay)،
  [پروفایلینگ](/products/profiling)، [متریک](/products/metrics).
- **از خرابی‌ها باخبر شوید** — [هشدارها و کانال‌های اعلان](/products/alerts).
- **تیم‌تان را دعوت کنید** — [سازمان‌ها و اعضا](/account/organizations).
- **راهنمای تصویری را ببینید** — [راهنمای تصویری محصول](/getting-started/product-tour).