Vercel CLIでトレーススパンを検索可能に|vercel traces searchの使い方と活用ポイント

Vercel CLIでトレーススパンを検索可能に|vercel traces searchの使い方と活用ポイントのアイキャッチ画像

本ページはプロモーションが含まれます。広告の取り扱いについてはプライバシーポリシーをご確認ください。

AIニュース重要度
★★★★☆
4.0 / 5|重要なアップデート
正式提供・新モデル・料金・セキュリティ・企業導入など実務への影響が明確な発表を含みます。利用者・企業の実務に影響する更新のため★4としました。
目次

PR

生成AIの学び方で悩んでいませんか?

DMM 生成AI CAMP
出典:DMM 生成AI CAMP

「何から学ぶか」「続けられるか」「仕事で使えるか」が大切と分かっていても、独学では難しいですよね。

DMM 生成AI CAMP 学び放題は、DMM.comが提供する月額制の生成AIオンラインスクールです。

総額200万円相当の約1,000レッスンが学び放題。職種別・ツール別のコースを、メンターやAIチューターのサポートを受けながら継続的に学べます。

その第一歩として、入会前に中身を体験できる60分の無料セミナーが用意されています。参加すると、こんなことが分かります。

  • 自分の職種で使えるか - マーケティング・営業・人事など職種別8コースの中身を体感できる!
  • ツールごとの学び方 - ChatGPTやDifyなど、ツール別のマスターコースも確認できる!
  • 学習の進め方 - 約1,000レッスンをどう学べば短期間で身につくか、プロが提案してくれる!
  • 続けられる仕組み - 24時間対応のAIチューターやメンター相談、コミュニティの中身が分かる!
  • 生成AIの最新デモ - 生成AIの最新技術デモをその場で体験できる!

「無料セミナーで体験してから、学び放題に入会して継続的に学ぶ」という流れで始められるので、合うか分からないまま入会する心配がありません。

予約・参加は無料。入会するかはセミナーの後に決められます。

\ 予約は30秒・日時を選ぶだけ /

※無料なのはセミナーで、学び放題本体は月額制の有料サービスです。料金は公式サイトをご確認ください。
※セミナー・コース内容は変更される場合があります。

概要

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)

PR

生成AIスクール選びの不安、入会前に解消できます!

DMM 生成AI CAMP
出典:DMM 生成AI CAMP

これからの働き方を左右する生成AIの学び方選び、慎重になりますよね。

数あるスクールや教材の中から、自分に合うものを見つけるのは本当に大変です。

「なんとなく話題だから」「YouTubeで見たから」

…そんな理由だけで学び方を決めていませんか?

実は、独学や教材選びで遠回りしてしまう人は少なくありません。

  • 「ツールは触ってみたけど、仕事の成果につながらない…」
  • 「情報が多すぎて、何からどの順で学べばいいのか分からない…」
  • 「質問できる相手がいなくて、結局続かなかった…」

DMM 生成AI CAMP 学び放題は、DMM.comが提供する月額制の生成AIオンラインスクール。総額200万円相当の約1,000レッスンが学び放題で、カリキュラムは生成AIの専門家が監修し、法人での導入事例もあります。

週1回×3ヶ月のライブゼミ(全8種・追加料金なし)、24時間対応のAIチューター、受講生コミュニティなど継続して学ぶための環境がそろっており、DMMの実案件の報酬ありコンペに挑戦することもできます。

スクール選びで大切なのは、「自分の職種で使える内容か」「続けられるサポートがあるか」を入会前に確かめることだと考えています。

しかし、

  • 「公式サイトだけでは、レッスンの中身までは分からない…」
  • 「サポートやコミュニティの雰囲気は、どう確かめればいい?」
  • 「入会してから、自分に合わなかったら…?」

そこで!DMM 生成AI CAMP 学び放題では、入会の前に60分の無料セミナーで中身を体験できるようになっています!

STEP 160分の無料セミナーで体験予約・参加は無料
→
STEP 2学び放題に入会して継続学習職種別・ツール別コース

セミナーに参加すると、入会前に知りたい情報がまとめて分かります!

  • コースの全容 - 職種別8コース+ツール別コースと約1,000レッスンの中身を体感できる!
  • 学習プロセス - 短期間で身につけるための学び方を提案してもらえる!
  • 生成AIの最新デモ - 生成AIの最新技術デモをその場で体験できる!
  • サポート体制 - 24時間対応のAIチューターやプロへの相談の仕組みが分かる!
  • コミュニティ - 受講生コミュニティや限定ウェビナーの紹介もあり!

普通なら有料の生成AI学習に関するプロのアドバイスが、60分・完全無料で受けられる機会です。

予約・参加は無料で、入会するかはセミナーの後に決められます。

合わないと感じたら、入会しなければいいだけ。失うものは60分だけです。

「なんとなく」ではなく、納得したうえで学習をスタートしましょう。

\ 予約は30秒・日時を選ぶだけ /

すでに入会を決めている方や、先にコースの詳細を確認したい方はこちらからどうぞ。

※無料なのはセミナーで、学び放題本体は月額制の有料サービスです。料金は公式サイトをご確認ください。
※セミナー・コース内容は変更される場合があります。

次に読みたいAI・IT用語

この記事を読んだあとに、あわせて知っておきたい用語をピックアップしました。

用語を読み込み中…

AI・IT用語をもっと見る →

この記事が気に入ったら
フォローしてね!

この情報が役立ったら、シェアしてね!
目次