داشبوردها
داشبورد، نمای دلخواه شماست روی همهٔ مجموعهدادههایی که ارورا نگه میدارد: نمودار خطی حجم خطا، کنار صدک ۹۵ تأخیر، کنار جدول کندترین تراکنشها.
ساخت داشبورد
داشبوردها ← داشبورد جدید، نامش را بگذارید و ویجت اضافه کنید. داشبوردها متعلق به سازماناند، پس همهٔ کسانی که دسترسی دارند همان صفحه را میبینند.
ساختار یک ویجت
هر ویجت از اینها ساخته میشود: یک مجموعهداده، یک نوع نمایش، یک یا چند تابع تجمیع، یک تفکیک اختیاری و فیلترهای اختیاری.
نوعهای نمایش
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
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 را ببینید) |
| صدک درست به نظر نمیرسد | صدکها از نمونهٔ کراندار مقادیر زیرین تخمین زده میشوند |
| ستون تفکیک در فهرست نیست | فقط ستونهای اعلامشده در فهرست قابل انتخاباند؛ هر چیز دیگری یعنی ورودی کاربر مستقیم به لایهٔ داده برسد |