heady-observability-mesh

What problem does it solve?

Unified AI observability across Langfuse tracing, Sentry error tracking, and OpenTelemetry distributed tracing for the Heady ecosystem.

Core Features & Use Cases

• Trace correlation: single correlation_id propagated from the edge through Cloud Run, Neon, Upstash, and LLM providers to unify end-to-end traces.
• OpenTelemetry per-stage spans: 21 HCFP stages wrapped with phi-aware timing and tags for governance-level observability.
• Langfuse tracing & cost analytics: per-LLM-call tracing, token accounting, and provider-cost aggregation.
• Sentry error tracking with CSL: automatic classification and tagging by Sacred Geometry context for proactive alerting.
• Coherence scoring & alerts: phi-weighted coherence across latency, errors, and cost with threshold-based alerts.
• Health and API surface: /health, /trace/llm, /coherence, and /cost endpoints for operational visibility.

Quick Start

Integrate the heady-observability-mesh router into your service and verify readiness with the /health endpoint.