مراقبة السياق
حوّل السياق إلى أصل قابل للمراقبة.
SLOs السياق
حدد أهداف مستوى الخدمة لمقاييس السياق.
التكوين
أنشئ 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 التكلفة المقدرة بالدولار
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 ما يتم مقارنته
محرك الفروقات يقارن الهيكل الكامل:
- الملفات: مضافة، محذوفة، تغيير الوضع
- الاكتشافات: جديدة vs سابقة
- القرارات: الخيارات المعمارية
- الإحصائيات: استدعاءات، رموز، أوامر
نقاط نهاية API
| نقطة النهاية | الوصف |
|---|---|
/api/slos | SLO الحالة والتاريخ |
/api/anomaly | ملخص الشذوذ |
/metrics | Prometheus تصدير |
/api/events | سجل الأحداث (آخر 200) |