發生什麼事
@mastra がspan queriesの公開を発表しました。公式ブログによると、従来のtrace queriesでは失敗したツール呼び出しを含む記録を見つけられますが、返されるのはtrace全体です。span queriesは、各traceの中から条件に一致するステップだけを返します（公式ブログ）。種類、名前、状態、エラー、所要時間で絞り込み、回数、エラー率、p50、p95、p99のレイテンシを集計できます。1回のクエリで指定できる条件は最大100個、1ページあたりの返却件数は最大1,000件です。グループ集計では最大2つのディメンションを指定でき、期間は最長365日です。
どんな影響があるか
Mastra platformとStudioのSpansタブから直接利用できます。コーディングエージェント自身に調べさせるには、CLIをmastra 1.36.0以上に更新し、mastra api span queryとmastra api span aggregateを使います。SDKは@mastra/client-js 1.57.0以上が必要です。セルフホスト環境では、observabilityのストレージにDuckDB、PostgreSQL、ClickHouseのいずれかを使う必要があります。ブログには、どのプランにこの機能が含まれるか記載がありません。本サイトでは未検証です（🗣 自述）。