Quick start with Langfuse
1
Create a Langfuse project
Sign up at langfuse.com and create a project. Note the public key, secret key, and host URL.
2
Configure the OTel exporter
3
Verify
Quick start with Grafana / Tempo
What is traced
Full attribute tables and Langfuse setup live in the core docs page
OTel & Langfuse Diagnostics
(or the core repo path
docs/diagnostics/otel-langfuse.md).
Task recovery (operator)
On gateway boot, recoverable task runs are classified. Runs that hit the default retry budget (maxAttempts: 5) or stay in retrying longer than 25 minutes (maxAttempts * maxMs)
are moved to dlq and emit task.recovery_exhausted. This stops orphaned runs from looping
forever across restarts.
Inspect with:
status: "dlq" and reasons retry exhausted or stalled beyond age threshold.
Re-enqueue work only if it is still needed. Details: core docs
Task operations.
Prometheus metrics
Whendiagnostics.enabled: true, a /metrics endpoint is exposed in Prometheus format.