Trace Pipeline Health

Return queue depth + drop count from the running exporter.

Safe-default: when no exporter is attached to app.state (engine booted without a trace pipeline, or T7 wiring not present), return zeroes plus writer_running=False so the UI panel stays renderable instead of erroring.

Declared before the /{otel_trace_id} route so the literal path takes precedence over the path-parameter route at match time — FastAPI iterates in declaration order.

Also surfaces database_dialect (read off the sessionmaker bind) so the UI can conditionally render the SQLite operational banner without a second round-trip.

GET

admin

api

traces

_health

Trace Pipeline Health

curl --request GET \
  --url https://api.example.com/admin/api/v1/traces/_health

{
  "queueDepth": 123,
  "maxQueueSize": 123,
  "overflowCount": 123,
  "writerRunning": true,
  "databaseDialect": "unknown",
  "instrumentorStatus": "ok",
  "instrumentorMessage": "<string>"
}

Response

200 - application/json

Successful Response

Body of GET /admin/api/v1/traces/_health.

Reflects the running StandaloneSpanExporter's queue. When the trace pipeline is not attached (engine booted without traces) the router returns zeroes + writer_running=False instead of 404 so the UI panel can render a stable "pipeline idle" state.

database_dialect lets the UI conditionally render the SQLite operational banner without a second round-trip; it mirrors the SQLAlchemy bind dialect name ("sqlite" or "postgresql") and falls back to "unknown" when no bind is reachable.

queueDepth

integer

required

maxQueueSize

integer

required

overflowCount

integer

required

writerRunning

boolean

required

databaseDialect

string

default:unknown

instrumentorStatus

string

default:ok

instrumentorMessage

string | null

Last modified on May 22, 2026

Bulk Delete Traces

Get Trace Detail

Trace Pipeline Health

curl --request GET \
  --url https://api.example.com/admin/api/v1/traces/_health

{
  "queueDepth": 123,
  "maxQueueSize": 123,
  "overflowCount": 123,
  "writerRunning": true,
  "databaseDialect": "unknown",
  "instrumentorStatus": "ok",
  "instrumentorMessage": "<string>"
}

Documentation Index

Response