> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.trytilde.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Langfuse

> Connect Tilde to your self-hosted Langfuse to store and analyse agent traces, sessions, and model usage.

Tilde uses [Langfuse](https://langfuse.com) as the system of record for traces. The gateway delivers every agent trace to your self-hosted Langfuse. The Tilde UI then reads traces and sessions back through the Langfuse API.

You run Langfuse yourself, inside the same private network as the gateway. Agent traces never leave your infrastructure.

## Deploy Langfuse

Langfuse has its own web and worker services, and its own dependencies.

| Dependency | Note |
| - | - |
| PostgreSQL | Separate from Tilde's database. |
| ClickHouse | Separate from Tilde's log database. |
| Redis | For Langfuse's queues. |
| S3-compatible storage | For events and media. |

Follow the [Langfuse self-hosting guide](https://langfuse.com/self-hosting). Then create a Langfuse project for Tilde, and create an API key pair in it.

## Configure Tilde

You give the gateway your Langfuse address and a project API key pair. Optionally, you also give it the address your operators' browsers use, so Tilde can link straight to records in Langfuse.

Langfuse credentials stay on the gateway. They never reach sidecars, agents, or browsers.

## What Tilde sends

Tilde delivers OTLP spans to Langfuse's OpenTelemetry ingestion endpoint. It keeps trace IDs, span IDs, and parent links intact.

| Langfuse field | Filled from |
| - | - |
| Session ID | The verified Tilde thread ID. A Tilde [session](https://enterprise-docs.trytilde.ai/sessions.md) and a Langfuse session are the same conversation. |
| Model, input, output, usage, and errors | OpenTelemetry and AI SDK span attributes from your agent. |
| Observation metadata | The agent, run, and invocation IDs, and the Tilde SDK, sidecar, and gateway versions. |
| Session metadata | The channel provider, connection, participant identity IDs, message count, and last turn time. |

Session metadata contains identity IDs, not identity values, and no message bodies. The gateway sets it, so an agent cannot forge it.

Tilde does not send pricing. Langfuse applies its own model prices. For spend that Tilde enforces, see [Inference providers](https://enterprise-docs.trytilde.ai/inference-providers.md#usage-and-cost).

## Use Langfuse with Tilde

* Operators read traces in Tilde's native viewer, without a Langfuse login. See [Traces](https://enterprise-docs.trytilde.ai/traces.md).
* Each trace, observation, and session in Tilde links to the same record in Langfuse, for analysis that needs Langfuse's own tools.
* Use Langfuse for evaluations, datasets, and dashboards across agents.
* Set trace retention in Langfuse. Tilde keeps no permanent trace history of its own.

## Delivery guarantees

The gateway queues traces durably and retries until Langfuse accepts them, without delivering duplicates. If Langfuse is unavailable, your agents are unaffected.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.