Introducing Span Queries

Mastra now offers span queries that filter and group individual spans across traces, letting you return only matching spans rather than whole traces. Span queries are available in Mastra platform and Studio, the Mastra CLI ([email protected] or later), the Mastra Client SDK, and HTTP observability endpoints, and work on self-hosted projects where storage.observability uses DuckDB, PostgreSQL, or ClickHouse. Each query can combine up to 100 conditions, returns up to 1,000 spans per page, and span groups can group by up to 2 dimensions over a time range of up to 365 days.