Наблюдаемость контекста
Превратите контекст в наблюдаемый, управляемый актив.
SLO контекста
Определите целевые показатели для метрик контекста.
Конфигурация
Создайте slos.toml в .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" Доступные метрики
session_context_tokens Общее количество токенов в сессии
session_cost_usd Оценочная стоимость в USD
compression_ratio Коэффициент сжатия
shell_invocations Количество команд оболочки
tool_calls_total Всего вызовов MCP
Действия SLO
| Действие | Поведение |
|---|---|
warn | Предупреждение в выводе |
throttle | Предупреждает и снижает плотность |
block | Блокирует необязательные вызовы |
Команды 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 Обнаружение аномалий
Автоматическое обнаружение необычных паттернов.
Как это работает
Алгоритм Уэлфорда:
- EMA по 50 вызовам
- Оповещение при >3x стандартного отклонения
- Видно в TUI и панели
Отслеживаемые метрики
Отслеживает tokens_per_call.
Метрики Prometheus
Экспорт в формате Prometheus.
Эндпоинт
# Start dashboard with metrics endpoint
lean-ctx dashboard
# Scrape metrics
curl http://localhost:3000/metrics Доступные метрики
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
Направьте scraper на /metrics.
Гарантия отсутствия PII
Только счётчики, датчики и соотношения.
Сравнение сессий
Сравните две сессии бок о бок.
Использование
# 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 Что сравнивается
Diff-движок сравнивает структуру:
- Файлы: добавленные, удалённые, изменения режима
- Находки: новые vs предыдущие
- Решения: архитектурные выборы
- Статистика: вызовы, токены, команды
API эндпоинты
| Эндпоинт | Описание |
|---|---|
/api/slos | SLO статус и история |
/api/anomaly | Сводка аномалий |
/metrics | Prometheus экспорт |
/api/events | Журнал событий (последние 200) |