Surveiller l’activité des agents de codage
Surveillez les agents de codage de votre équipe dans Unity Gateway : activité des agents de codage, utilisation des modèles et traces des requêtes. Start avec le tableau de bord d’utilisation, puis analysez les requêtes individuelles et l’exécution des agents à l’aide du traçage.
Tableau de bord d’utilisation
Ouvrez Unity Gateway > Gouverner > Tableau de bord d’utilisation . La Coding Agents tab shows activity such as active days, coding sessions, commit, and lines of code added or removed. Utilisez les vues d’utilisation, de performances et de coûts du tableau de bord pour examiner la consommation et les dépenses.
Si aucun tableau de bord n’a été créé, un administrateur de compte peut le créer à partir de Govern > Create Usage Dashboard . Consultez Tableau de bord d’utilisation intégré.
Suivi de l’utilisation
Effectuez une query system.ai_gateway.usage pour analyser les requêtes de modèle par utilisateur, modèle ou Workspace, y compris l’utilisation des jetons, la latence et les erreurs. Consultez Suivi de l'utilisation du modèle pour connaître les conditions d'accès et le schéma de la table.
Traçage
Bêta
La table de traces unifiée est en version bêta. Un administrateur de compte doit activer l'aperçu d' Enhanced Unity Gateway depuis la page Aperçus de la console du compte. Consultez Gérer les aperçus Databricks.
La table de traces unifiée stocke les traces de requêtes de passerelle et les traces d'agent côté client dans la même table Unity Catalog :
- Les traces de la Gateway capturent les requêtes de modèle et 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 l'interface CLI de Unity Gateway pour ajouter des détails d'exécution d'agent à la même table.
Configurer le traçage unifié
Lorsque la version préliminaire d’ Enhanced Unity Gateway est activée, un administrateur de métastore crée la table de traçage une seule fois pour les Workspace rattachés au métastore :
- Ouvrez Unity Gateway > Govern > Traces et cliquez sur Set up tracing .
- Sélectionnez le catalogue et le schéma pour la table de traces.
- Cliquez sur Enregistrer .
Les traces sont stockées à l'emplacement Unity Catalog 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 la query.
Pour les contrôles d'accès et les exemples de requêtes, consultez Surveiller toute l'activité d'IA à l'aide de la table de traces unifiée. Pour les colonnes et les attributs d'étendue, consultez la Référence du schéma de la table de traces unifiée.
Pendant la phase de bêta-test, la table de traces unifiée présente certaines limitations. Consultez la page Limitations.
Activer le traçage côté client
La CLI Unity Gateway configure Claude Code et Codex pour envoyer leurs traces vers la table de traces unifiée que vous avez configurée ci-dessus.
Dans votre configuration d'agent de codage, ajoutez le paramètre suivant dans l'objet config existant de chaque agent pris en charge, puis publiez la mise à jour :
{
"tracing": {
"enabled": true
}
}
Developers launch the agent through ug claude or ug codex. La CLI applique le paramètre de traçage et configure l’endpoint d’exportation ainsi que l’authentification. To apply an update immediately, see Sync configuration updates.