WFGY/ProblemMap/GlobalFixMap/Eval_Observability/metrics_and_logging.md
2025-09-05 10:52:04 +08:00

7.3 KiB
Raw Blame History

Eval Observability — Metrics and Logging

🧭 Quick Return to Map

You are in a sub-page of Eval_Observability.
To reorient, go back here:

Think of this page as a desk within a ward.
If you need the full triage and all prescriptions, return to the Emergency Room lobby.

A baseline schema and checklist for logging semantic metrics (ΔS, λ, coverage, E_resonance) during live runs.
Use this page to enforce consistent telemetry so that offline eval and online observability align.


Why log metrics?

  • Drift detection: High ΔS or divergent λ states catch retrieval/logic errors early.
  • Comparability: Same schema across providers, stores, and orchestration layers.
  • Debug loops: Logged traces accelerate reproduction and diagnosis.
  • Regression guards: Simple thresholds protect pipelines before release.

Core metrics to capture

Metric Definition Thresholds
ΔS(question, retrieved) Semantic distance between query and retrieved snippet Stable ≤ 0.45, Transitional 0.450.60, Risk ≥ 0.60
Coverage Fraction of gold/target section retrieved ≥ 0.70
λ_observe State of reasoning flow (→ convergent, ← divergent, <> transitional, × collapse) Must stay convergent across 3 paraphrases
E_resonance Long-window entropy of reasoning steps Should remain flat without spikes

Logging schema (JSON example)

{
  "trace_id": "uuid",
  "timestamp": "2025-08-29T12:34:56Z",
  "question": "...",
  "retrieved": [
    {
      "snippet_id": "s1",
      "section": "intro",
      "source": "docA",
      "offsets": [120, 160],
      "ΔS": 0.42
    }
  ],
  "ΔS_overall": 0.44,
  "coverage": 0.72,
  "λ_state": "→",
  "E_resonance": 0.03,
  "index_hash": "abc123",
  "dedupe_key": "sha256(...)" 
}

Quick probes

  • ΔS probe: Recompute ΔS on each retrieval call. Alert if ≥ 0.60.
  • λ probe: Run three paraphrases per eval batch, log λ_state sequence.
  • Coverage probe: Compare retrieved sections against gold or expected anchors.
  • E_resonance probe: Smooth entropy over 50100 steps, alert if spike > 2× baseline.

Storage tips

  • Write logs to append-only store (e.g., KV or time-series DB).
  • Deduplicate with dedupe_key = sha256(question + index_hash + snippet_id).
  • Keep 3090 days rolling window for regression analysis.

🔗 Quick-Start Downloads (60 sec)

Tool Link 3-Step Setup
WFGY 1.0 PDF Engine Paper 1 Download · 2 Upload to your LLM · 3 Ask “Answer using WFGY + <your question>”
TXT OS (plain-text OS) TXTOS.txt 1 Download · 2 Paste into any LLM chat · 3 Type “hello world” — OS boots instantly

🧭 Explore More

Module Description Link
WFGY Core WFGY 2.0 engine is live: full symbolic reasoning architecture and math stack View →
Problem Map 1.0 Initial 16-mode diagnostic and symbolic fix framework View →
Problem Map 2.0 RAG-focused failure tree, modular fixes, and pipelines View →
Semantic Clinic Index Expanded failure catalog: prompt injection, memory bugs, logic drift View →
Semantic Blueprint Layer-based symbolic reasoning & semantic modulations View →
Benchmark vs GPT-5 Stress test GPT-5 with full WFGY reasoning suite View →
🧙‍♂️ Starter Village 🏡 New here? Lost in symbols? Click here and let the wizard guide you through Start →

👑 Early Stargazers: See the Hall of Fame — Engineers, hackers, and open source builders who supported WFGY from day one.

GitHub stars WFGY Engine 2.0 is already unlocked. Star the repo to help others discover it and unlock more on the Unlock Board.

WFGY Main   TXT OS   Blah   Blot   Bloc   Blur   Blow