AI JobsStart a program

AuraOne / Docs / Agent Studio Open / Observe

OTEL ingest cookbook

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

All Agent Studio Open docs

At a glance

Agent Studio Open guide

Guide overview
Entry
OTEL ingest cookbook
Reading
9 min
Sections
1
Applies to
Applies to the current Agent Studio Open source release. Check the product page and repository for the latest version, supported platforms, and installation details.

01

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.

  • Drop an OTEL JSON file into Trace Browser.
  • Start the local receiver on port 4318 for OTLP HTTP.
  • Use gRPC when the emitting service cannot send JSON.
  • Convert a failed span to a regression case with redaction preview.
agentstudio otlp receive --store ./traces.ast --host 127.0.0.1 --port 4318
OTEL_EXPORTER_OTLP_ENDPOINT=http://127.0.0.1:4318 npm test
agentstudio import-trace ./phoenix-export.json --format phoenix --store ./traces.ast