Observability via OpenTelemetry
Langfuse uses OpenTelemetry to provide observability into the application. If you want to include Langfuse into your own tracing setup, you can configure the following environment variables to send spans to your own collector:
| Variable | Required / Default | Description |
|---|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT | http://localhost:4318 | The OTLP collector endpoint Langfuse should send traces to. Path is /v1/traces. |
OTEL_SERVICE_NAME | web/worker | Name of the service within your APM tool. |
OTEL_TRACE_SAMPLING_RATIO | 1 | The sampling ratio for traces. A value of 1 means all traces are sent. Must be between 0 and 1. |
FAQ
Do these OTEL variables export application logs?
These variables export Langfuse traces, not the stdout logs of langfuse-web and langfuse-worker. See this guide for an example on how to export logs: Export self-hosted Langfuse logs to ClickStack.
How do I set up observability for self-hosted Langfuse with ClickStack?
See this guide for an example on how to export logs: Export self-hosted Langfuse logs to ClickStack.
If you experience any issues when self-hosting Langfuse, please:
- Check out Troubleshooting & FAQ page.
- Use Ask AI to get instant answers to your questions.
- Ask the maintainers on GitHub Discussions.
- Create a bug report or feature request on GitHub.
Enterprise-grade support is available when self-hosting Langfuse. Learn more on our pricing page.
Was this page helpful?
Last updated on
