ডকুমেন্টেশন

কনটেক্সট পর্যবেক্ষণযোগ্যতা

কনটেক্সট পর্যবেক্ষণযোগ্যতা

কনটেক্সটকে পর্যবেক্ষণযোগ্য সম্পদে রূপান্তর করুন।

কনটেক্সট 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 অ্যালগরিদম ব্যবহার:

  • ৫০ কলের উইন্ডোতে 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ইভেন্ট লগ (শেষ ২০০)