Broadcast

Broadcast copies every request you make, as a trace, to your own monitoring tool — no instrumentation in your code. You add a destination once, with a management key; from then on each request is sent there after it has been settled.

How it works#

1. You add a destination at POST /v1/observability/destinations: its type, and the settings that tool needs.
2. A request runs on any /v1 model route — chat, messages, responses, embeddings, rerank, pictures, speech, transcription, video, System One, batches.
3. Once the request is settled, its trace is queued for every destination whose filters it passes.
4. Each destination receives it in its own format. A destination that does not answer is retried three more times — after 10 seconds, a minute, and five minutes — and then the trace is dropped.

Every request sends a trace: one answered from the response cache (0 DA), one refused before a model ran, one whose model failed, and every stream.

Supported destinations#

Up to five destinations of one type. Every address is HTTPS on the public internet. Every type also takes headers in its config — an object of strings, sent with each delivery.

Add a destination#

curl https://opendunes.com/v1/observability/destinations \
  -H "Authorization: Bearer $OPENDUNES_MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Souk Bot traces",
    "type": "langfuse",
    "config": { "publicKey": "pk-lf-…", "secretKey": "sk-lf-…" }
  }'

The answer is the destination, 201, with its secrets masked. The routes, the filters and every setting are on the Observability reference.

What a trace carries#

The provider on a trace is the lab that served the request.

Name and group your traces#

Add a trace object to any request body. trace_id groups several requests under one trace, trace_name, span_name and generation_name name them, parent_span_id nests one under another; every other key arrives as metadata.

{
  "model": "anthropic/claude-sonnet-5",
  "messages": [{ "role": "user", "content": "Wach kayen iPhone 16?" }],
  "user": "customer-4521",
  "session_id": "chat-2026-09-24-001",
  "trace": {
    "trace_name": "souk-bot-answer",
    "shop": "algiers-center"
  }
}

Choose what is sent#