Skip to main content

agentrouter.traces.v1.TracesService

TracesService is the staff-facing, cross-tenant read surface over the LLM and MCP traces the data planes send to the observability store. It backs the Admin Console's Traces viewer: a list of trace summaries and one trace with its span tree.

A trace is a per-request record whose span attributes can carry the captured prompt and completion, so it is request-log data, not an aggregate metric. Authorization is RequestLogsService's: the request_logs_reader scope (admin implies it) plus the additive request_logs.read permission. A scoped key is confined to its own customer, and a project-tier key to its own project, whatever the request names.

The service answers Unimplemented when the management plane has no trace query backend configured.