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

# OTLP Receiver

> Ingest OpenTelemetry traces into ProvenLog

ProvenLog's server can receive OpenTelemetry trace spans via OTLP/HTTP, mapping them to ProvenLog events with full attribute preservation.

## Setup

```bash theme={null}
# Start the ProvenLog server
plog serve

# Point your OTLP exporter at the ProvenLog endpoint
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:7600/v1/traces
```

## How it works

The OTLP receiver accepts standard OTLP/HTTP requests (both Protobuf and JSON encoding) and converts each span into a `ProvenLogEvent`:

| Span Field | Event Field             |
| ---------- | ----------------------- |
| Span name  | `action_name`           |
| Span kind  | Mapped to `action_type` |
| Attributes | `metadata`              |
| Status     | `action_status`         |
| Duration   | `duration_ms`           |
| Trace ID   | `session_id`            |

## Use cases

* Consolidate OpenTelemetry traces and ProvenLog audit events in one place
* Add cryptographic integrity to existing OTLP instrumentation
* Bridge existing observability pipelines into a tamper-evident audit trail