प्रलेखन

संदर्भ अवलोकनीयता

संदर्भ अवलोकनीयता

संदर्भ को अवलोकन योग्य, नियंत्रणीय संपत्ति में बदलें।

संदर्भ SLOs

अपने संदर्भ मेट्रिक्स के लिए SLO परिभाषित करें।

कॉन्फ़िगरेशन

.lean-ctx में slos.toml बनाएं।

# .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

विसंगति पहचान

असामान्य पैटर्न स्वचालित पहचान।

कैसे काम करता है

Welford एल्गोरिदम का उपयोग:

  • 50 कॉल की विंडो पर EMA
  • >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 एकीकरण

/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)