Context-SLOs

Definiere Service Level Objectives für deine Kontext-Metriken. SLOs werden nach jedem Tool-Call evaluiert.

Konfiguration

Erstelle eine slos.toml-Datei im .lean-ctx-Verzeichnis für benutzerdefinierte SLOs.

# .lean-ctx/slos.toml
[[slo]]
name = "context_budget"
metric = "session_context_tokens"
threshold = 50000
action = "warn"  # warn | throttle | block

[[slo]]
name = "cost_per_session"
metric = "session_cost_usd"
threshold = 1.00
action = "throttle"

[[slo]]
name = "compression_efficiency"
metric = "compression_ratio"
threshold = 0.3
direction = "min"
action = "warn"

Verfügbare Metriken

SLO-Aktionen

MCP-Befehle

ctx_session slo              # Show current SLO status
ctx_session slo reload       # Reload SLOs from disk
ctx_session slo history      # Show violation history
ctx_session slo clear        # Clear violation log

Anomalie-Erkennung

Erkennt automatisch ungewöhnliche Token-Verbrauchsmuster pro Agent und Projekt.

Funktionsweise

lean-ctx verwendet Welfords Online-Algorithmus für laufende Statistiken:

• EMA über ein Sliding Window von 50 Tool-Calls
• Alert bei >3x Standardabweichung vom Mittelwert
• Events im TUI und Dashboard sichtbar

Überwachte Metriken

Aktuell werden tokens_per_call nach jedem Tool-Aufruf überwacht.

Prometheus-Metriken

Exportiere alle Observability-Daten im Prometheus-Textformat.

Endpunkt

# Start dashboard with metrics endpoint
lean-ctx dashboard

# Scrape metrics
curl http://localhost:3000/metrics

Verfügbare Metriken

lean_ctx_tokens_saved_total
lean_ctx_compression_ratio
lean_ctx_session_cost_usd
lean_ctx_tool_calls_total
lean_ctx_slo_violations_total
lean_ctx_cache_hit_rate
lean_ctx_anomalies_total
lean_ctx_session_uptime_seconds

Grafana-Integration

Richte deinen Prometheus-Scraper auf den /metrics-Endpunkt.

Null-PII-Garantie

Es werden nur Zähler, Gauges und Verhältnisse exportiert. Keine persönlichen Daten.

Session-Diffing

Vergleiche zwei Sessions nebeneinander.

Verwendung

# Compare two sessions (MCP)
ctx_session diff <session_a> <session_b>
ctx_session diff <session_a> <session_b> json

# List available sessions
ctx_session list

Was verglichen wird

Die Diff-Engine vergleicht die vollständige Session-Struktur:

• Dateien: hinzugefügt, entfernt, Modus-Änderungen
• Erkenntnisse: neue Entdeckungen vs. vorherige Session
• Entscheidungen: getroffene Architektur-Entscheidungen
• Statistiken: Tool-Calls, eingesparte Tokens, ausgeführte Befehle

Dashboard-API-Endpunkte