Observabilité du contexte
Le contexte devient un asset observable et contrôlable.
SLOs de contexte
Définissez des objectifs de niveau de service pour vos métriques.
Configuration
Créez un fichier slos.toml dans votre répertoire .lean-ctx.
# .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" Métriques disponibles
session_context_tokens Total des tokens de contexte dans la session
session_cost_usd Coût estimé en USD de la session
compression_ratio Ratio de compression
shell_invocations Nombre de commandes shell exécutées
tool_calls_total Total des invocations d'outils MCP
Actions SLO
| Action | Comportement |
|---|---|
warn | Ajoute un avertissement à la sortie |
throttle | Avertit et peut réduire la densité |
block | Bloque les appels non essentiels |
Commandes MCP
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 Détection d'anomalies
Détecte les modèles de consommation inhabituels.
Comment ça marche
lean-ctx utilise l'algorithme de Welford:
- EMA sur une fenêtre de 50 appels
- Alerte à >3x écart-type
- Événements visibles dans le TUI et tableau de bord
Métriques suivies
Suit actuellement tokens_per_call.
Métriques Prometheus
Exportez au format texte Prometheus.
Point d'accès
# Start dashboard with metrics endpoint
lean-ctx dashboard
# Scrape metrics
curl http://localhost:3000/metrics Métriques disponibles
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 Intégration Grafana
Pointez votre scraper vers /metrics.
Garantie zéro PII
Seuls compteurs, jauges et ratios sont exportés.
Comparaison de sessions
Comparez deux sessions côte à côte.
Utilisation
# 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 Ce qui est comparé
Le moteur compare la structure complète:
- Fichiers: ajoutés, supprimés, changements de mode
- Découvertes vs session précédente
- Décisions architecturales
- Statistiques: appels, tokens, commandes
Points d'accès API
| Point d'accès | Description |
|---|---|
/api/slos | Statut SLO et historique |
/api/anomaly | Résumés d'anomalies |
/metrics | Export Prometheus |
/api/events | Journal d'événements (200 derniers) |