Документация

Наблюдаемость контекста

Наблюдаемость контекста

Превратите контекст в наблюдаемый, управляемый актив.

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/slosSLO статус и история
/api/anomalyСводка аномалий
/metricsPrometheus экспорт
/api/eventsЖурнал событий (последние 200)