Documentation

Observabilité du contexte

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

ActionComportement
warnAjoute un avertissement à la sortie
throttleAvertit et peut réduire la densité
blockBloque 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èsDescription
/api/slosStatut SLO et historique
/api/anomalyRésumés d'anomalies
/metricsExport Prometheus
/api/eventsJournal d'événements (200 derniers)