概要
Vercelは2026年9月29日、CLI(コマンドラインツール)から直接トレーススパンを検索できる新コマンド「vercel traces search」を発表しました。これにより、開発者やコーディングエージェント(AIによる自動コーディング支援)がダッシュボードを開かずに、ターミナル上でエラーや遅延、セキュリティ関連の挙動を調査できるようになります。
何が発表・更新されたのか
今回の更新は、Vercel CLIに「トレーススパン検索」機能が追加されたというものです。トレーススパンとは、1つのリクエストが処理される際の各ステップ(処理単位)を表す記録のことです。たとえばあるページの表示リクエストが、データベース呼び出し・API呼び出し・レンダリング処理など複数のステップに分かれている場合、それぞれのステップが1つの「スパン」として記録されます。
これまでこうしたトレース情報を確認するには、Vercelのダッシュボードにアクセスして該当のリクエストIDやトレースIDを探す必要がありました。今回のアップデートにより、vercel traces searchコマンドを使えば、ターミナルから直接検索できるようになりました。
変更点
公式情報によると、主な変更点は以下の通りです。
- デフォルトでは、直近1時間以内のスパンを新しい順に最大100件返す仕様になっており、事前にリクエストIDやトレースIDを調べなくても検索を始められます。
- 環境(environment)、サービス(service)、スパン名、ステータス、デプロイメントID、リクエストID、トレースID、スパンIDといった条件で結果を絞り込めます。
--sinceや--untilオプションで、時間範囲を指定して検索できます。- 専用オプションが用意されていない条件については、
--queryオプションでVercelがサポートするKibana Query Language(KQL)のサブセットを使って検索できます。duration(処理時間)やスパン・リソースの属性なども条件に指定可能です。 --jsonオプションを付けると、スパンごとに1つのJSONオブジェクトとして出力されます。これにより、スクリプトやAIエージェントが構造化されたデータとして解析しやすくなります。
使い方または対応
公式情報に掲載されているコマンド例は以下の通りです。
# 直近1時間のエラースパンを検索
vercel traces search --status error --since 1h
# 特定のトレースIDに含まれる全スパンを検索
vercel traces search --trace-id 4bf92f3577b34da6a3ce929d0e0e4736
# 処理時間が2秒を超えるスパンを検索
vercel traces search --query 'span.duration > 2000'
利用するには、まずvercel upgradeコマンドでVercel CLIを最新版に更新します。その後、vercel traces search --helpを実行すると、利用可能な全オプションを確認できます。より詳しい情報は、公式のVercel tracesドキュメントに掲載されています。
なぜ重要なのか
トレースの調査は、これまでダッシュボードを開いて条件を設定し直す作業が必要で、コンテキストの切り替え(ツール間の移動)が発生していました。CLIから直接検索できるようになることで、コードを書いている環境から離れずに調査を進められるようになります。
さらに--jsonオプションでの構造化データ出力は、コーディングエージェントのような自動化されたツールがトレース情報を直接解析し、エラー原因の特定や修正提案に活用できる点で重要です。人間の開発者だけでなく、AIエージェントによる運用支援・自動デバッグの文脈でも意味を持つ更新といえます。
誰に関係があるのか
Vercel上でアプリケーションやAPIを運用している開発者、SRE(システム信頼性を担う担当者)、DevOps担当者に関係があります。特に、エラー調査や遅延(レイテンシ)の原因分析、セキュリティ関連の挙動確認をルーティン業務として行っているチームに向けた機能です。また、コーディングエージェントを開発フローに組み込んでいる企業にとっても、エージェントが構造化データを直接扱える点で関係があります。
仕事や業務でどう使えるのか
実務では、次のような場面での活用が想定されます。
- 本番環境で障害が発生した際、ダッシュボードを開く前にターミナルから
vercel traces search --status error --since 1hのようなコマンドで即座に直近のエラーを確認する。 - 特定のトレースIDが分かっている場合に、そのトレースに含まれる全スパンを一覧表示し、どのステップで問題が起きたかを追跡する。
- パフォーマンス改善の一環として、
--query 'span.duration > 2000'のように処理時間の長いスパンを抽出し、ボトルネックとなっている処理を特定する。 - CI/CDパイプラインやスクリプトに
--json出力を組み込み、定期的なエラー監視や自動レポート作成の仕組みを構築する。
今後
公式情報からは、今後の機能拡張の予定について具体的な言及は確認できませんでした。ただし、CLIとダッシュボードの両方でトレース調査ができる体制が整ったことで、今後はコーディングエージェントとの連携がさらに進む可能性があります。継続的な情報確認には、公式のVercel tracesドキュメントの参照が推奨されます。
注意点
公式情報上では、この機能の対象プラン(無料プランを含むかどうか)や日本を含む各地域での提供状況について、詳細は確認できませんでした。利用を検討する場合は、公式のVercel CLIおよびtracesドキュメントで最新の対象条件を確認することをおすすめします。また、KQLのサポートは「Vercelがサポートする範囲のサブセット」とされているため、Kibana本来の全機能が使えるわけではない点にも留意が必要です。
公式情報
Vercel Changelog: Search trace spans from the Vercel CLI
関連キーワード
- Vercel CLI
- トレーススパン(Trace Span)
- KQL(Kibana Query Language)
- AIエージェント
- CLIツール
- デバッグ・観測性(Observability)





