Surveillez l’activité des agents codants

Surveillez l’adoption des agents de codage, l’utilisation des tokens et le coût des sessions avec Unity Gateway. Interrogez les enregistrements d’utilisation pour des analyses personnalisées, utilisez le tableau de bord intégré pour comparer les agents et enquêter sur les sessions, ou inspectez les traces pour examiner l’activité détaillée des agents.

Vérifiez l’utilisation dans l’interface CLI ug

Vérifiez vos limites de dépenses personnelles et partagées pour Unity Gateway depuis votre terminal :

ug usage

Exemple de sortie :

Your Unity Gateway spend limits

[█████████████████████████░░░░░] 85% used
Monthly personal limit (budget 8f3c2a91)
$85.00 of $100.00 used · $15.00 remaining this month

[██████████████████░░░░░░░░░░░░] 60% used
Monthly shared limit (budget 4d7b9e02)

[███████░░░░░░░░░░░░░░░░░░░░░░░] 25% used
Daily personal limit (budget 8f3c2a91)
$5.00 of $20.00 used · $15.00 remaining today

Le résultat affiche jusqu’à cinq limites applicables et le pourcentage utilisé pour chacune, classés du pourcentage utilisé le plus élevé au plus faible. Exécutez ug usage --all pour voir toutes les limites applicables.

Pour plus d’informations, voir la référence ug CLI.

Suivi de l’utilisation

Unity Gateway enregistre les requêtes de modèles et MCP dans system.ai_gateway.usage, incluant l’utilisateur demandeur, l’espace de travail, le service et le statut. Les demandes de modèles incluent également des informations sur le modèle, l’utilisation des jetons et la latence.

Le tableau inclut également les métadonnées de session suivantes pour l’activité de l’agent de codage :

• IDs de session et de sous-agents : Connecter les requêtes à une session de codage et à ses sous-agents.
• Agent de codage et version de l’agent : Identifiez l’agent et sa version signalée.
• Surface : Une liste de surfaces délimitée par des espaces représentant la pile cliente complète.
• Effort de raisonnement et nom du routeur intelligent : Décrivez la configuration de raisonnement de la requête et la formule de routage rapportée.

Pour les besoins d’accès et le schéma complet, voir Suivre l’utilisation du modèle. Pour les champs de session, voir Métadonnées de session.

Tableau de bord de l’utilisation

Ouvre Unity Gateway > Govern > Usage Dashboard, puis sélectionne Coding Agents.

Utilisez cet onglet pour :

• Suivre l’adoption : Comparez les utilisateurs actifs et les sessions entre les agents de codage.
• Comprenez les workflows : voyez quels outils d’orchestration d’agents les développeurs utilisent et avec quels agents de codage ils les associent.
• Comparer l’utilisation : Examinez la moyenne des sessions quotidiennes par utilisateur, des jetons par session et des sous-agents par session.
• Explorez l’utilisation des modèles : Voyez quels modèles sont utilisés dans les sessions d’agents de codage. Une session peut utiliser plusieurs modèles.
• Enquêtez sur la dépense des sessions : Consultez les Top 1000 des sessions par dépenses estimées pour identifier les sessions à forte dépense et examiner leurs utilisateurs, modèles, services, utilisation de jetons et sous-agents.

Utilisez le sélecteur Coding Agents pour vous concentrer sur des agents spécifiques. Les métriques de la session reflètent l’activité dans les dates sélectionnées. La durée de la session inclut le temps d’inactivité entre les appels enregistrés ; elle ne mesure pas le temps de codage actif.

Si aucun tableau de bord n’a été créé, un administrateur du compte peut le créer à partir de Govern > Create Usage Dashboard. Consultez le tableau de bord d’utilisation intégré.

Tracing

La table de traces unifiée stocke les traces des requêtes de la passerelle et les traces de l’agent côté client dans la même table Unity Catalog :

• Les traces de passerelle capturent le modèle et les requêtes MCP gérées par Unity Gateway. La collecte commence lorsque vous activez le traçage unifié.
• Les traces côté client capturent l’activité émise par l’agent de codage sur la machine du développeur. Activez-les via la ligne de commande Unity Gateway pour ajouter les détails d’exécution des agents à la même table.

Mettre en place un traçage unifié

Avec l’aperçu amélioré de Unity Gateway activé, un administrateur du metastore crée une seule fois la table de trace pour les espaces de travail attachés au metastore :

1. Ouvre Unity Gateway>, Gouverne > les traces et clique sur Configurer le traçage.
2. Sélectionnez le catalogue et le schéma pour la table de traces.
3. Cliquez sur Enregistrer.

Les traces sont stockées à l’emplacement du catalogue Unity sélectionné lors de la configuration : <catalog>.<schema>.<table>. Ouvrez Govern > Traces pour les inspecter, ou interrogez la table dans Databricks SQL. Le propriétaire de la table doit accorder l’accès avant que d’autres utilisateurs ne puissent l’interroger.

Pour des exemples de contrôles d’accès et de requêtes, voir Surveiller toute l’activité IA à l’aide de la table de traces unifiée. Pour les colonnes et les attributs d’étendue, voir la référence du schéma unifié de table de traces.

Pendant la version Bêta, la table de trace unifiée présente certaines limitations. Consultez Limitations.

Activez le traçage côté client

La CLI de la passerelle Unity configure Claude Code et Codex pour envoyer leurs traces à la table de traces unifiée que vous avez configurée ci-dessus.

Dans la configuration de votre agent de codage, ajoutez le paramètre suivant à l’intérieur de l’objet existant config de chaque agent supporté, puis publiez la mise à jour :

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

Les développeurs lancent l’agent via ug claude ou ug codex. La CLI applique le paramètre de traçage et configure le point d’accès d’exportation ainsi que l’authentification. Pour appliquer une mise à jour immédiatement, voir Synchronisation des mises à jour de configuration.

Pour envoyer des traces côté client de vos propres applications vers la table de traces unifiée, voir Envoyer des traces côté client depuis votre application.

Étapes suivantes

• Configurez les agents de codage de manière centralisée
• Gérer les budgets