Guide d'instrumentation AppInsights
Cette skill fournit des conseils et documents de référence pour instrumenter des webapps avec Azure Application Insights.
⛔ AJOUT DE COMPOSANTS ?
Si l'utilisateur souhaite ajouter App Insights à son app, invoquez azure-prepare à la place. Cette skill fournit du matériel de référence—azure-prepare orchestre les modifications réelles.
Quand utiliser cette skill
- L'utilisateur demande comment instrumenter (conseils, patterns, exemples)
- L'utilisateur a besoin d'instructions de configuration du SDK
- azure-prepare invoque cette skill pendant la phase de recherche
- L'utilisateur veut comprendre les concepts d'App Insights
Quand utiliser azure-prepare à la place
- L'utilisateur dit « ajouter de la télémétrie à mon app »
- L'utilisateur dit « ajouter App Insights »
- L'utilisateur veut modifier son projet
- Toute demande de changement/ajout de composants
Prérequis
L'app dans l'espace de travail doit être de l'un de ces types
- Une app ASP.NET Core hébergée sur Azure
- Une app Node.js hébergée sur Azure
Directives
Collecter les informations de contexte
Identifiez le tuple (langage de programmation, framework applicatif, hébergement) de l'application pour laquelle l'utilisateur essaie d'ajouter le support de télémétrie. Cela détermine comment l'application peut être instrumentée. Lisez le code source pour faire une estimation éclairée. Confirmez avec l'utilisateur tout ce que vous ne connaissez pas. Vous devez toujours demander à l'utilisateur où l'application est hébergée (par exemple sur un ordinateur personnel, dans Azure App Service en tant que code, dans Azure App Service en tant que conteneur, dans Azure Container App, etc.).
Préférer l'auto-instrumentation si possible
Si l'app est une app C# ASP.NET Core hébergée dans Azure App Service, utilisez le guide AUTO pour aider l'utilisateur à auto-instrumenter l'app.
Instrumenter manuellement
Instrumentez manuellement l'app en créant la ressource AppInsights et en mettant à jour le code de l'app.
Créer une ressource AppInsights
Utilisez l'une des options suivantes qui correspond à votre environnement.
- Ajouter AppInsights à un modèle Bicep existant. Voir examples/appinsights.bicep pour ce qu'il faut ajouter. C'est la meilleure option s'il y a des fichiers modèles Bicep existants dans l'espace de travail.
- Utiliser Azure CLI. Voir scripts/appinsights.ps1 pour connaître la commande Azure CLI à exécuter pour créer la ressource App Insights.
Quelle que soit l'option choisie, recommandez à l'utilisateur de créer la ressource App Insights dans un groupe de ressources significatif qui facilite la gestion des ressources. Un bon candidat sera le même groupe de ressources qui contient les ressources de l'app hébergée sur Azure.
Modifier le code de l'application
- Si l'app est une app ASP.NET Core, voir le guide ASPNETCORE pour savoir comment modifier le code C#.
- Si l'app est une app Node.js, voir le guide NODEJS pour savoir comment modifier le code JavaScript/TypeScript.
- Si l'app est une app Python, voir le guide PYTHON pour savoir comment modifier le code Python.
Références rapides du SDK
- OpenTelemetry Distro : Python | TypeScript
- OpenTelemetry Exporter : Python | Java
Guides spécifiques à la plateforme
- Container Apps : Guide d'observabilité