API: analytics
POST /api/v1/analytics/collect
Section titled “POST /api/v1/analytics/collect”Collect
Trigger a collection run (idempotent; safe to re-run).
collect=false — СИНХРОННЫЙ дешёвый режим (SPEC-125): внешние коллекторы не дёргаются,
отрабатывает ingest уже лежащих файлов + скоринг тем, и вызывающий получает РЕЗУЛЬТАТ, а не
«принято». Ночной прогон обязан знать, посчиталась ли петля: фоновая задача, о судьбе которой
никто не узнаёт, — это тот самый сторож, который всегда зелёный.
GET /api/v1/analytics/instances/{instance_id}
Section titled “GET /api/v1/analytics/instances/{instance_id}”Instance Dashboard
Everything one per-instance analytics panel needs (snapshot + trends + queries + pages + index).
| Parameter | In | Required | Type |
|---|---|---|---|
instance_id | path | yes | string |
GET /api/v1/analytics/overview
Section titled “GET /api/v1/analytics/overview”Overview
Cross-instance grid: latest snapshot KPIs + health per instance.
GET /api/v1/analytics/runs
Section titled “GET /api/v1/analytics/runs”Runs
Recent collection-run manifests.