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

# OpenTelemetry

> Request stored trace payloads with conversation details and plan instrumentation without assuming an exporter exists.

Trace data can help correlate a conversation with work performed by its supporting services. Threetone currently exposes a representation for trace data already stored with a conversation.

<Note>
  The conversation read path does not generate spans or export telemetry. No first-party collector setup or end-to-end trace production workflow is released by this API.
</Note>

You need an accessible conversation ID. A transcript alone does not imply that trace data exists.

<Steps>
  <Step title="Request the trace representation" id="otel-request-representation">
    Call [Get conversation details](/api-reference/agents-platform/get-conversation-details) with `format=opentelemetry`. The default format is `json`.
  </Step>

  <Step title="Inspect stored coverage" id="otel-inspect-coverage">
    Check `otlp_traces` for an existing payload. If it is absent or null, record that trace evidence is unavailable. Repeating the request does not instrument an older conversation.
  </Step>

  <Step title="Keep correlation context" id="otel-correlation-context">
    Retain the conversation, agent, branch, and version IDs with any trace investigation. Confirm timestamps and the producing service before attributing a delay to a model or tool.
  </Step>
</Steps>

Workspace webhook settings also accept `webhooks.transcript_format=opentelemetry`. Webhook delivery is unavailable, so this preference does not configure a functioning exporter. A future rollout needs verified producers, propagation, sampling, redaction, and a supported destination.

<AccordionGroup>
  <Accordion title="Does the format parameter create traces?" id="otel-faq-generation">No. It exposes a stored field when present.</Accordion>
  <Accordion title="Can I configure a collector URL here?" id="otel-faq-collector">There is no verified public collector configuration or automatic export workflow to document yet.</Accordion>
</AccordionGroup>


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