メインコンテンツまでスキップ

コーディングエージェントのアクティビティを監視

Unity Gateway でチームのコーディングエージェント(コーディングエージェントのアクティビティ、モデルの使用状況、リクエストトレース)を監視します。使用状況ダッシュボードから開始し、トレースを使用して個別のリクエストとエージェントの実行を調査します。

Usage dashboard

Unity Gateway > Govern > Usage Dashboard を開きます。The Coding Agents tab には、アクティブな日数、コーディングセッション、commit、追加または削除されたコード行などのアクティビティが表示されます。ダッシュボードの使用状況、パフォーマンス、およびコストのビューを使用して、消費量と支出を調査します。

Coding agent dashboard

ダッシュボードが作成されていない場合、アカウント管理者は Govern > 使用状況ダッシュボードを作成する から作成できます。「組み込みの使用状況ダッシュボード」を参照してください。

使用状況の追跡

クエリー system.ai_gateway.usage to analyze model requests by user, model, or ワークスペース, including トークン usage, latency, and errors.アクセス要件とテーブル スキーマについては、モデルの使用状況の追跡をご覧ください。

トレーシング

備考

ベータ版

統合トレーステーブルはベータ版です。アカウント管理者は、アカウントコンソールの [Previews] ページから Enhanced Unity Gateway のプレビュー版を有効にする必要があります。Databricksのプレビューを管理するを参照してください。

統合トレーステーブルには、ゲートウェイのリクエストトレースとクライアント側のエージェントトレースが同じUnity Catalogテーブルに保存されます。

  • Gateway トレース は、Unity Gatewayによって処理されたモデルおよびMCPのリクエストをキャプチャします。統合トレースを有効にすると収集が開始されます。
  • Client-side traces capture activity emitted by the coding agent on the developer's machine.Enable them through the Unity Gateway CLI to add agent execution details to the same table.

統合トレーシングの設定

With the Enhanced Unity Gateway preview enabled, a metastore admin creates the trace table once for ワークスペース attached to the metastore:

  1. Unity Gateway > Govern > Traces を開き、 [トレーシングの設定] をクリックします。
  2. トレーステーブルのカタログとスキーマを選択します。
  3. 保存 をクリックします。

トレースは、セットアップ時に選択した Unity Catalog のロケーションに保存されます:<catalog>.<schema>.<table>Govern > Traces を開いて検査するか、Databricks SQL でテーブルをクエリーします。他のユーザーがクエリーを実行する前に、テーブル所有者がアクセス権を付与する必要があります。

Claude Codeおよびモデルのリクエストを同じ統合トレーステーブルに表示するトレースビュー

アクセス制御とクエリーの例については、統合トレーステーブルを使用したすべての AI アクティビティの監視を参照してください。列とスパンの属性については、統合トレーステーブルスキーマのリファレンスを参照してください。

ベータ版の間、統合トレーステーブルにはいくつかの制限があります。制限事項を参照してください。

クライアント側トレースの有効化

Unity Gateway CLI は、上で設定した統合トレーステーブルにトレースを送信するように Claude Code と Codex を構成します。

In your coding agent configuration, add the following setting inside each supported agent's existing config object, then publish the update:

JSON
{
"tracing": {
"enabled": true
}
}

開発者はug claudeまたはug codexを介してエージェントを起動します。CLIはトレーシング設定を適用し、エクスポートEndpointと認証を構成します。更新をただちに適用するには、構成更新の同期を参照してください。

次のステップ