RESOURCES · DOCS · AGENT STUDIO · OBSERVE

OTEL ingest cookbook

Import OpenTelemetry GenAI spans, Phoenix JSON, OTLP HTTP JSON/proto, and OTLP gRPC into local traces.

SECTION
Observe

Where this entry sits in the docs index.

READ TIME
9 min

Pace it for a coffee or a coffee break.

SECTIONS
1

Each one stands alone and is copy-paste safe.

INSTRUMENT READOUT · OBSERVE
THE WALKTHROUGH

What you will actually do.

STEP 01
OBSERVE

Import paths

Observe supports file import and a local receiver. Desktop can listen on OTLP HTTP and gRPC; browser edition cannot listen and only imports files.

Phoenix JSON exports and OpenAI-style event traces are normalized into the same local session model so failed spans can become replays.

01

Drop an OTEL JSON file into Trace Browser.

↳ CHECK
02

Start the local receiver on port 4318 for OTLP HTTP.

↳ CHECK
03

Use gRPC when the emitting service cannot send JSON.

↳ CHECK
04

Convert a failed span to a regression case with redaction preview.

↳ CHECK
↳ COMMANDS
agentstudio observe start --http 4318 --grpc 4317
OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318 npm test
agentstudio observe import ./phoenix-export.json --format phoenix
OBSERVE

Next time, it's already a replay.

The path you just read becomes the path you can repeat. One trace, one artifact, one gate the next release has to clear.

OTEL ingest cookbook | Agent Studio Open Docs