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.