İstatistik & KPI API

1 dk · 296 kelime Türkçe

İstatistik uçları, filo KPI'ları ve LLM ajanları için tidy-long KPI dışa aktarımı (CSV/JSON/XLSX).

Bu makaleyi şu şekilde oku: 📄 Düz metin ⚡ JSON 🤖 LLM biçimi

İstatistik & KPI API

Synapse, ajan sağlığı, API kullanımı, eğilimler ve filo KPI'ları hakkında salt okunur istatistikler sunar. Tüm uçlar ya bir MindKey (Authorization: Bearer) ya da bir kullanıcı JWT'si (requireMindOrUser) kabul eder.

Mevcut analitik rotalar (WebUI'deki /stats sayfasına bakın):

Rota	Amaç
`GET /stats/agent`	Tüm ajanlara genel bakış (dönem: `days`)
`GET /stats/agent/comparison`	Ajanlar arası karşılaştırma
`GET /stats/agent/:mindName`	Bir ajanın ayrıntılı istatistikleri
`GET /stats/agent/:mindName/health`	Sağlık puanı
`GET /stats/agent/:mindName/heatmap`	Etkinlik ısı haritası
`GET /stats/agent/:mindName/sessions`	Oturum izleyici
`GET /stats/api`	API kullanımı (global)
`GET /stats/trends`	Zaman serileri
`GET /stats/chat/response-times`	Sohbet yanıt süreleri
`GET /stats/a2a/flow`	A2A mesaj akışı
`GET /stats/cron`	Cron analitiği
`GET /stats/team` · `/stats/backlog` · `/stats/activity` · `/stats/summary` · `/stats/fleet` · `/stats/monitoring`	Pano toplamları

GET /export/kpis

Operasyonel KPI'ların tidy-long dışa aktarımı (task 7418541b). Verinin doğruluk kaynağı src/db/stats.ts'dir — dışa aktarma katmanı yalnızca düzleştirir, kendisi hiçbir şeyi ölçmez.

GET /export/kpis?format=csv|json|xlsx&days=7

Parametre	Değerler	Varsayılan
`format`	`csv` · `json` · `xlsx`	`json`
`days`	`1`–`365` (ajan genel bakışı için pencere)	`7`

Yanıt:

format=json → { generated_at, period_days, format: "long", columns, row_count, rows[] }
format=csv → text/csv; charset=utf-8 (RFC 4180, BOM, CRLF) ek olarak
format=xlsx → Excel çalışma kitabı (tek sayfa KPIs) ek olarak

Tidy-long sütunları (tüm formatlarda özdeş):

Sütun	Anlam
`kategorie`	KPI grubu: `fleet`, `summary`, `backlog`, `activity`, `team`, `monitoring`, `agent_overview`
`metrik`	Düzleştirilmiş metrik yolu (örn. `throughput.done_24h_total`)
`wert`	Skaler değer (sayı, metin ya da yalnızca `detail` veri taşıdığında `NULL`)
`einheit`	`value` · `count` · `text` · `json`
`zeitstempel`	Dışa aktarımın ISO-8601 üretim zaman damgası
`quelle`	`src/db/stats.ts` içindeki kaynak fonksiyon
`detail`	Diziler/derin nesneler için JSON yükü, aksi halde boş

Örnek:

curl -s -H "Authorization: Bearer $MIND_KEY" \
  "https://synapse.schaefer.zone/export/kpis?format=csv&days=7" -o kpis.csv

WebUI'deki /stats sayfası aynı dışa aktarımı "KPI export" bölümünde üç indirme düğmesi (CSV/JSON/XLSX) olarak gösterir.