> ## 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.

# OpenTelemetry

> Tilde receives agent logs and traces over OTLP, stores logs in ClickHouse, and can forward a copy of logs to your own OpenTelemetry collector.

The Tilde gateway has an OpenTelemetry receiver built in. Agents send logs and traces to the gateway over OTLP/HTTP, so you do not need to run a collector for Tilde to work.

If you already run an observability stack, Tilde can forward a copy of agent logs to your own collector.

![Telemetry flow: agents send OTLP logs and traces to the gateway, which stores logs in ClickHouse, delivers traces to Langfuse, and can forward a copy of logs to your OpenTelemetry collector](https://mintcdn.com/tilde-enterprise/E0-xiX0zmRn_ubi0/images/telemetry-flow.drawio.svg?fit=max\&auto=format\&n=E0-xiX0zmRn_ubi0\&q=85\&s=e65fe4017532e2a72bb7fc832db6ee00)

&#x20;*Click to zoom*

## Signals

| Signal | Protocol | Stored in | Forwarded to your collector |
| - | - | - | - |
| Logs | OTLP/HTTP | ClickHouse | Yes |
| Traces | OTLP/HTTP | Langfuse | See [Langfuse](https://enterprise-docs.trytilde.ai/integrations/langfuse.md). |

## Agent logs

The Tilde SDK exports your agent's logs for you. It authenticates each upload, and the gateway then sets the identifying attributes itself, so an agent cannot forge them.

| Log scope | Authenticated by | Attributes the gateway sets |
| - | - | - |
| Invocation | The invocation token | Agent, invocation, run, and thread |
| Deployment | The deployment token | Agent and deployment |

Deployment-scoped logs cover startup and background work, when no invocation is active.

Read logs in the agent's **Logs** tab. Filter by session, run, invocation, trace, scope, and severity. A log line's trace link opens that trace in the native viewer.

## Forward logs to your collector

Point Tilde at your collector's OTLP/HTTP endpoint, with any headers it needs for authentication. Tilde then sends it a copy of every agent log.

Forwarding runs independently of Tilde's own log history. If your collector is unavailable, the **Logs** tab is unaffected.

## Reliable delivery

The gateway buffers logs durably before it delivers them, so an outage in your log store or collector does not drop logs, and never slows your agents.

## Use your own OpenTelemetry provider in an agent

If your agent already configures OpenTelemetry, add Tilde's processors to your provider.

| Signal | Processor | SDK option |
| - | - | - |
| Traces | `agentSpanProcessor` | `tracing: "existing"` |
| Logs | `agentLogProcessor` | `logging: "existing"` |

See [Traces](https://enterprise-docs.trytilde.ai/traces.md#use-your-own-opentelemetry-provider) for an example.


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