# داشبوردها

> https://docs.errora.org/products/dashboards

داشبورد، نمای دلخواه شماست روی همهٔ مجموعه‌داده‌هایی که ارورا نگه می‌دارد: نمودار خطی حجم خطا،
کنار صدک ۹۵ تأخیر، کنار جدول کندترین تراکنش‌ها.

## ساخت داشبورد

**داشبوردها ← داشبورد جدید**، نامش را بگذارید و ویجت اضافه کنید. داشبوردها متعلق به
**سازمان**اند، پس همه‌ٔ کسانی که دسترسی دارند همان صفحه را می‌بینند.

## ساختار یک ویجت

هر ویجت از این‌ها ساخته می‌شود: یک **مجموعه‌داده**، یک **نوع نمایش**، یک یا چند **تابع
تجمیع**، یک **تفکیک** اختیاری و **فیلترهای** اختیاری.

### نوع‌های نمایش

`line`، `area`، `bar`، `table`، `big_number`.

### مجموعه‌داده‌ها و آنچه می‌توانند پاسخ دهند

| مجموعه‌داده | توابع تجمیع | تفکیک / فیلتر |
| --- | --- | --- |
| **errors** | `count()`، `count_unique(issue)` | `level`، `environment`، `release`، `platform`، `server_name` |
| **transactions** | `count()`، `avg(duration)`، `sum(duration)`، `failure_rate()`، `p50` تا `p99` روی `duration` | `transaction`، `op`، `status`، `environment`، `release`، `platform` |
| **logs** | `count()` | `level`، `environment`، `release` |
| **metrics** | توابع تجمیع خود متریک (`sum`، `avg`، `min`، `max`، صدک‌ها، `count_unique`) | هر برچسبی که متریک دارد |
| **profiles** | `count()`، `avg(duration)`، `sum(samples)`، `p50` تا `p99` روی `duration` | `transaction`، `environment`، `release`، `platform` |
| **issues** | `count()`، `sum(events)`، `sum(users)` | ویژگی‌های Issue |

سازندهٔ ویجت این فهرست را از سرور می‌خواند (`GET /dashboards/catalog`)، پس فقط کوئری‌هایی را
پیشنهاد می‌دهد که سرور واقعاً می‌تواند پاسخ دهد — و ویجتی که ماه پیش ذخیره کرده‌اید هنوز رندر
می‌شود، چون با همان فهرست اعتبارسنجی می‌شود.

## نمونه ویجت‌ها

| پرسش | مجموعه‌داده | نمایش | تجمیع | تفکیک |
| --- | --- | --- | --- | --- |
| اوضاع بدتر می‌شود؟ | errors | خطی | `count()` | `level` |
| کدام نقطه کند است؟ | transactions | جدول | `p95(duration)` | `transaction` |
| سلامت پرداخت چطور است؟ | transactions | عدد بزرگ | `failure_rate()` | — (فیلتر `transaction:/checkout`) |
| حجم لاگ به تفکیک شدت | logs | ناحیه‌ای | `count()` | `level` |
| سفارش‌های امروز | metrics | عدد بزرگ | `sum` روی `orders.created` | — |
| کندترین مسیرهای پروفایل‌شده | profiles | میله‌ای | `p99(duration)` | `transaction` |

## چیدمان و اشتراک

ویجت‌ها قابل جابه‌جایی‌اند (کشیدن، یا `PATCH .../widgets/reorder`). هر کسی در سازمان که
`project:read` دارد می‌تواند صفحه را ببیند؛ ویرایش به توانمندی‌های نوشتن نیاز دارد. داشبورد
در سطح سازمان است و هر ویجت روی پروژه‌هایی که شما می‌بینید محاسبه می‌شود.

## API

```text
GET    /api/v1/dashboards/catalog
GET    /api/v1/organizations/{org_id}/dashboards
POST   /api/v1/organizations/{org_id}/dashboards
GET    /api/v1/organizations/{org_id}/dashboards/{id}
PATCH  /api/v1/organizations/{org_id}/dashboards/{id}
DELETE /api/v1/organizations/{org_id}/dashboards/{id}
POST   /api/v1/organizations/{org_id}/dashboards/{id}/widgets
PATCH  /api/v1/organizations/{org_id}/dashboards/{id}/widgets/reorder
PATCH  /api/v1/organizations/{org_id}/dashboards/{id}/widgets/{widget_id}
DELETE /api/v1/organizations/{org_id}/dashboards/{id}/widgets/{widget_id}
GET    /api/v1/organizations/{org_id}/dashboards/{id}/widgets/{widget_id}/data
```

## عیب‌یابی

| نشانه | علت / راه‌حل |
| --- | --- |
| یک تابع تجمیع پیشنهاد نمی‌شود | در فهرست آن مجموعه‌داده نیست — صدک برای مدت‌زمان هست، برای شمارش نه |
| ویجت خالی است | در آن بازه داده‌ای نیست، یا مقدار فیلتر هرگز رخ نمی‌دهد (املای `environment`/`release` را ببینید) |
| صدک درست به نظر نمی‌رسد | صدک‌ها از نمونهٔ کران‌دار مقادیر زیرین تخمین زده می‌شوند |
| ستون تفکیک در فهرست نیست | فقط ستون‌های اعلام‌شده در فهرست قابل انتخاب‌اند؛ هر چیز دیگری یعنی ورودی کاربر مستقیم به لایهٔ داده برسد |