پروژه‌ها و کلیدهای DSN

پروژه یک برنامه است که می‌خواهید داده‌هایش کنار هم بماند: خطاها، لاگ‌ها، بازپخش‌ها، مانیتورها، متریک‌ها، پروفایل‌ها و بازخوردهایش.

ساخت پروژه

پروژه‌ها ← پروژهٔ جدید: نام و پلتفرم.

curl -X POST "$ERRORA/api/v1/organizations/$ORG_ID/projects" \
  -H "Authorization: Bearer $ACCESS_TOKEN" -H "Content-Type: application/json" \
  -d '{"name":"Checkout API","platform":"python"}'

پلتفرم‌ها: python، php، php-laravel، node، javascript، go، other. پلتفرم فقط آیکون و نمونه‌کد پیشنهادی را تعیین می‌کند.

اسلاگ از روی نام ساخته می‌شود و درون سازمان یکتاست.

چند پروژه بسازیم؟

به ازای هر سرویس قابل استقرار، یکی. به‌جای پروژهٔ جدا، داخل همان پروژه از محیط (production، staging) استفاده کنید — فیلترها روی محیط‌ها کار می‌کنند و پروژهٔ staging که کسی نگاهش نمی‌کند فقط باگ‌ها را پنهان می‌کند.

کلیدهای DSN

هر پروژه هنگام ساخت یک کلید می‌گیرد:

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

کلیدهای بیشتر (با برچسب) بسازید تا بدون قطعی بچرخانید: DSN جدید را منتشر کنید، منتظر جابه‌جایی ترافیک بمانید و بعد کلید قدیمی را غیرفعال کنید.
غیرفعال‌کردن کلید (is_active: false) باعث می‌شود ارسال با آن بی‌درنگ 401 بگیرد.
کلید عمومی به آن معنا «راز» نیست — SDKهای مرورگری آن را منتشر می‌کنند — ولی هر کسی که آن را داشته باشد می‌تواند در پروژهٔ شما رویداد بنویسد. اگر جایی لو رفت که خطر سوءاستفاده دارد، بچرخانیدش.

GET  /api/v1/organizations/{org_id}/projects/{project_id}/keys
POST /api/v1/organizations/{org_id}/projects/{project_id}/keys

تنظیمات پروژه

تنظیم	اثر
نام / اسلاگ	نمایش و آدرس‌ها
پلتفرم	آیکون و نمونه‌کد راه‌اندازی
نرخ نمونه‌برداری	کسری از رویدادهای رسیده که ذخیره می‌شود (`1.0` یعنی همه‌چیز). کنترل هزینه در سمت سرور، مستقل از نمونه‌برداری SDK.
مخزن	مخزن کد پیوندخورده که رفع خودکار از آن استفاده می‌کند — نگاه کنید به یکپارچه‌سازی‌ها

GET/PATCH/DELETE /api/v1/organizations/{org_id}/projects/{project_id}
GET              /api/v1/organizations/{org_id}/projects/stats

تنظیمات پروژه به توانمندی project:manage نیاز دارد.

حذف پروژه

همهٔ رویدادها، خطاها، لاگ‌ها، بازپخش‌ها، مانیتورها، پروفایل‌ها، متریک‌ها و بازخوردهای آن را حذف می‌کند. بازگشت‌ناپذیر است — هرچه لازم دارید اول خروجی بگیرید.

عیب‌یابی

نشانه	علت / راه‌حل
پاسخ `401` هنگام ارسال داده	کلید عمومی اشتباه است یا غیرفعال شده
پاسخ `404` هنگام ارسال داده	شناسهٔ پروژه در مسیر DSN اشتباه است
رویداد پذیرفته می‌شود ولی نیست	نرخ نمونه‌برداری کمتر از `1.0` است، یا نگه‌داری داده آن را حذف کرده
رویدادها به پروژهٔ اشتباه رفته‌اند	دو DSN در فایل‌های محیطی دارید — ببینید هنگام اجرا کدام بارگذاری می‌شود

ساخت پروژه​

چند پروژه بسازیم؟​

کلیدهای DSN​

تنظیمات پروژه​

حذف پروژه​

عیب‌یابی​