التوثيق

مراقبة السياق

مراقبة السياق

حوّل السياق إلى أصل قابل للمراقبة.

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/slosSLO الحالة والتاريخ
/api/anomalyملخص الشذوذ
/metricsPrometheus تصدير
/api/eventsسجل الأحداث (آخر 200)