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

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

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と認証を構成します。更新をただちに適用するには、構成更新の同期を参照してください。

次のステップ​