Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Les éléments indiqués comme (aperçu) dans cet article sont en aperçu public. Cette préversion est fournie sans contrat de niveau de service. Nous vous déconseillons donc de l’utiliser dans des charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités contraintes. Pour plus d’informations, consultez Conditions d'utilisation supplémentaires pour les versions préliminaires de Microsoft Azure.
Note
Le suivi est généralement disponible pour les agents prompt et les agents hébergés. Workflow et les agents externes sont en préversion.
Utilisez le traçage pour déboguer vos agents IA et surveiller leur comportement en production. Le suivi capture des données de télémétrie détaillées , notamment la latence, les exceptions, le contenu d’invite et les opérations de récupération, afin de pouvoir identifier et résoudre les problèmes plus rapidement.
Le point de départ recommandé est le suivi côté serveur. Foundry l’active automatiquement après avoir connecté une ressource Application Insights à votre projet. Aucune modification du code n’est requise et les traces sont disponibles en quelques minutes pour l’activer. Le suivi côté serveur fonctionne pour n’importe quel agent hébergé dans Foundry. Lorsque vous avez besoin d’une visibilité sur votre propre code d’application , par exemple, pour tracer une logique personnalisée entourant un appel d’agent, vous pouvez ajouter l’instrumentation côté client en deuxième étape.
La compétence Microsoft Foundry peut vous aider à choisir le suivi côté serveur ou côté client et à résoudre les problèmes de télémétrie manquantes.
Conditions préalables
- Un projet Foundry.
- Une ressource Application Insights Azure Monitor pour stocker les traces (créez-en une ou connectez-en une existante).
- Accès à la ressource Application Insights connectée à votre projet.
- Le rôle Log Analytics Reader sur la ressource Application Insights connectée (obligatoire pour interroger la télémétrie). Si les tables Log Analytics sous-jacentes sont protégées, attribuez également le rôle Lecteur de données de surveillance privilégié.
Connecter Application Insights à votre projet Foundry
Foundry stocke les traces dans Application Insights à l’aide de conventions sémantiques OpenTelemetry.
-
Connectez-vous à Microsoft Foundry. Vérifiez que le commutateur New Foundry est activé. Ces étapes font référence à Foundry (nouveau).
Ouvrez votre projet Foundry.
Dans le volet de navigation gauche, sélectionnez Agents.
En haut, sélectionnez Traces.
À droite, sélectionnez Connexion pour créer une ressource Application Insights ou vous y connecter.
- Pour connecter une ressource existante, sélectionnez la ressource, puis sélectionnez Se connecter.
- Pour créer une nouvelle ressource, sélectionnez Création, puis complétez l’assistant.
Un message de confirmation s’affiche lorsque la connexion réussit.
Utilisez le chemin d’accès des détails du projet
Si vous ne voyez pas la barre de messages ou le bouton Se connecter, utilisez cette autre méthode pour activer Azure Monitor Application Insights.
- Sélectionnez Gérer dans le volet de navigation supérieur droit, puis sélectionnez Project détails.
- Sélectionnez l’onglet Ressources connectées , puis sélectionnez Ajouter une connexion.
- Dans Choisir une connexion, sélectionnez Application Insights.
Pour l’ingestion de trace authentifiée par Entra, consultez Configurer l’authentification Microsoft Entra pour l’ingestion de trace de l’assistant Foundry (version préliminaire).
Une fois que vous avez connecté la ressource, votre projet est prêt à utiliser le suivi.
Important
Vérifiez que vous disposez des autorisations nécessaires pour interroger les données de télémétrie.
- Pour les requêtes basées sur les journaux, commencez par attribuer le rôle Lecteur de Log Analytics. Si les tables Log Analytics sous-jacentes sont protégées, attribuez également le rôle Lecteur de données de surveillance privilégié.
- Pour savoir comment attribuer des rôles, consultez Assigner des rôles Azure à l’aide du portail Azure.
- Pour gérer l’accès à grande échelle, utilisez des groupes Microsoft Entra.
Instrumentation des agents d'IA
Choisissez l’approche qui correspond à la façon dont vous construisez et exécutez votre agent.
Traces côté serveur dans le portail Foundry
Commencez par les traces côté serveur. Foundry journalise les traces pour les scénarios courants d’agent et de flux de travail sans modifier votre code.
- Foundry enregistre automatiquement les traces côté serveur pour les agents de requête, les agents hôtes et les flux de travail dans le portail de Foundry. Une fois le suivi activé dans votre projet Foundry, vous avez accès aux traces prêtes à l’emploi des 90 jours précédents.
- Foundry prend également en charge une intégration facile avec les principaux frameworks d’agents.
Traces côté client avec le SDK Microsoft Foundry (Python)
Installez OpenTelemetry et le plug-in de suivi Kit de développement logiciel (SDK) Azure en procédant comme suit :
pip install azure-ai-projects azure-identity opentelemetry-sdk azure-core-tracing-opentelemetry
Référence : azure-ai-projects, azure-core-tracing-opentelemetry
Important
Pour utiliser le point de terminaison d'un projet dans votre application, vous devez configurer Microsoft Entra ID. Si vous ne configurez pas Microsoft Entra ID, utilisez le chaîne de connexion Application Insights.
Après avoir exécuté votre agent, vous pouvez afficher et analyser les traces dans le portail Foundry.
Pour obtenir des instructions détaillées et des exemples de code spécifiques au kit SDK, consultez Suivi avec azure-ai-projects (kit SDK Python) et des échantillons de télémétrie pour les agents.
Effectuer un traçage local avec l’extension Microsoft Foundry Toolkit pour Visual Studio Code
L’extension Microsoft Foundry Toolkit pour Visual Studio Code vous permet de tracer localement dans VS Code à l’aide d’un collecteur compatible OTLP local. Cette approche est idéale pour le développement et le débogage.
Le kit de ressources prend en charge les frameworks IA tels que Foundry Agent Service, OpenAI, Anthropic et LangChain via OpenTelemetry. Vous pouvez voir les traces instantanément dans VS Code sans avoir besoin d’un accès cloud.
Pour obtenir des instructions d’installation détaillées et des exemples de code spécifiques au Kit de développement logiciel (SDK), consultez Suivi dans Foundry Toolkit.
Afficher et analyser les traces
Afficher les traces dans le portail Foundry
Dans votre projet Foundry, accédez à l’onglet Traces de vos agents ou flux de travail. Vous pouvez effectuer des recherches, filtrer ou trier des traces ingérées au cours des 90 derniers jours.
Sélectionnez une trace pour parcourir chaque étendue, identifier les problèmes et observer la façon dont votre application répond. Ce processus vous aide à déboguer et à identifier les problèmes dans votre application.
Afficher les traces dans Azure Monitor
Vos traces sont envoyées à Azure Monitor Application Insights, ce qui vous permet de les afficher.
Pour plus d’informations sur l’envoi de traces à Azure Monitor et la création d’une ressource Azure Monitor, consultez Azure Monitor documentation OpenTelemetry.
Afficher les résultats de la conversation
Une conversation est le contexte persistant d’un historique de dialogue de bout en bout entre un utilisateur et un agent. Dans le portail Foundry, vous pouvez afficher les résultats de Conversation de votre agent dès le départ, ainsi que les traces sur la page Traces.
Effectuez une recherche par ID de réponse ou par UN ID de trace qui correspond à cette conversation. Sélectionnez ensuite un ID de conversation à examiner :
- Détails de l’historique des conversations
- Informations et jetons de réponse dans un processus
- Actions ordonnées, étapes d’exécution et appels d’outils
- Entrées et sorties entre un utilisateur et un agent
Vérifier que le suivi fonctionne
Vérifiez que votre projet est connecté à Application Insights. Si nécessaire, suivez les étapes décrites dans Connecter Application Insights à votre projet Foundry.
Exécutez votre agent ou workflow au moins une fois (par exemple, à l’aide du portail ou de votre application).
Dans votre projet Foundry, ouvrez la vue Traces et confirmez qu’une nouvelle trace s’affiche.
Lorsque le suivi fonctionne correctement, vous voyez une liste de traces récentes avec des horodatages, des durées et des indicateurs d’état. Sélectionnez une trace pour afficher ses détails de périmètre.
Si vous ne voyez pas de nouvelles traces, attendez quelques minutes et actualisez, puis consultez Résolution des problèmes.
Sécurité et confidentialité
Le suivi peut capturer des informations sensibles, telles que les entrées utilisateur, les sorties de modèle et les arguments et les résultats des outils. Utilisez ces pratiques pour réduire les risques :
- Ne stockez pas de secrets, d’informations d’identification ou de jetons dans des invites, des arguments d’outil ou des attributs d’étendue.
- Réactez ou réduisez les données personnelles et d’autres contenus sensibles avant qu’elles ne s’affichent dans la télémétrie.
- Traitez les données de trace comme des données de télémétrie de production et appliquez les mêmes contrôles d’accès et stratégies de rétention que vous utilisez pour les journaux et les métriques.
Pour plus d’informations, consultez Sécurité et confidentialité.
Rétention et coût des données
Foundry stocke les traces dans la ressource Application Insights connectée à votre projet. La rétention et la facturation des données suivent votre configuration Application Insights et Log Analytics.
Dépannage
| Problème | Cause | Résolution |
|---|---|---|
| Vous ne voyez aucune trace dans le portail Foundry | Le suivi n’est pas connecté, il n’y a pas de trafic récent, ou l’ingestion est retardée | Confirmez la connexion Application Insights, générez le nouveau trafic de l’agent et actualisez après quelques minutes. |
| Vous voyez des erreurs d’autorisation lorsque vous interrogez ou affichez des données de télémétrie | Autorisations RBAC manquantes sur Application Insights ou Log Analytics | Confirmez l’accès dans le contrôle d’accès (IAM) pour les ressources connectées. Pour les requêtes de journal, affectez le rôle lecteur Log Analytics. Si les tables sont protégées, attribuez également un lecteur de données de surveillance privilégié. |
| Les traces côté client n’apparaissent pas | L’instrumentation n’est pas installée ou configurée | Revérifiez l’installation de votre package et suivez les instructions du Kit de développement logiciel (SDK) liées dans Traces côté client avec le SDK Microsoft Foundry (Python). |
| Le contenu sensible apparaît dans les traces | Les invites, les arguments d’outil ou les sorties contiennent des données sensibles | Réactez les données sensibles avant d’entrer dans la télémétrie et suivez les instructions de sécurité et de confidentialité. |
Contenu connexe
Maintenant que vous avez configuré le suivi, explorez ces ressources pour approfondir votre compréhension et étendre vos fonctionnalités d’observabilité :