Command Center
Einzelner Endpoint für alle Dashboard-Daten.
Das Command Center bündelt alle Dashboard-Widgets in einer cachebaren Response. Eigene Dashboards lassen sich darauf aufbauen, ohne zwanzig Einzelaufrufe zu machen.
GET /api/v1/command-center
GET /api/v1/command-center?range=24h| Query | Default | Werte |
|---|---|---|
range | 24h | 1h, 6h, 24h, 7d, 30d |
Der Parameter heißt
range— nichttime_range. Unbekannte Query-Keys werden ignoriert; eintime_range=-Parameter fällt still auf das 24h-Default-Fenster zurück.
Empfohlenes Polling-Intervall: 30 Sekunden.
Response-Shape
{
"range": "24h",
"kpis": {
"governance_score": 87,
"traces": { "value": 12384, "delta": 4.2 },
"interceptions": { "value": 231, "delta": -0.6 },
"proofs": { "value": 1042, "delta": 1.1 }
},
"timeline": [ { "label": "14:00", "allow": 412, "block": 7, "flag": 21, "total": 440 } ],
"top_policies": [ { "name": "PII Mask", "hits": 84, "color": "#..." } ],
"agents": {
"total": 12,
"distribution": [ { "id": "ckagent...", "name": "Support Bot", "requests_today": 4012 } ],
"top_agents": [ "…" ],
"anomalies": [ "…" ]
},
"mcp": {
"tool_calls": 320, "blocked": 4,
"servers_total": 3, "servers_active": 3, "servers_error": 0,
"pending_approvals": 1, "poisoning_suspects": 0
},
"costs": {
"daily_estimate_eur": 18.42, "monthly_requests": 12384,
"monthly_base_fee": 0, "overage_cost": 0, "total_estimate_eur": 18.42
},
"contract": {
"included_requests": 50000, "used_requests": 12384,
"utilization_percent": 24.7, "overage": 0
},
"live_feed": [ "…" ],
"action_items": [ "…" ],
"content_types": [ { "content_type": "text", "count": 12000, "color": "#..." } ]
}KPI-Zähler tragen ein delta relativ zum vorherigen vergleichbaren Zeitfenster.
Einsatzszenarien
- Dashboard-Widgets einzeln ersetzen, ohne Re-Architektur — jedes Widget konsumiert dasselbe Payload.
- On-Call-Dashboards (Grafana, Datadog) über diesen Endpoint als Custom Data Source speisen.
action_items[]in einen täglichen Compliance-E-Mail-Digest einspeisen.
Für historische Roh-Analytik (z. B. monatliche Compliance-Berichte) besser GET /api/v1/traces oder GET /api/v1/export nutzen — das Command Center ist für Live-Dashboards optimiert, nicht für Bulk-Export.