Guide d'instrumentation AppInsights
Cette skill fournit des conseils et du matériel de référence pour instrumenter des webapps avec Azure Application Insights.
⛔ AJOUTER DES COMPOSANTS ?
Si l'utilisateur souhaite ajouter App Insights à son application, 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 durant la phase de recherche
- L'utilisateur souhaite comprendre les concepts d'App Insights
Quand utiliser azure-prepare à la place
- L'utilisateur dit « ajouter de la télémétrie à mon application »
- L'utilisateur dit « ajouter App Insights »
- L'utilisateur souhaite modifier son projet
- Toute demande de modification/ajout de composants
Prérequis
L'application dans l'espace de travail doit être l'un de ces types
- Une application ASP.NET Core hébergée dans Azure
- Une application Node.js hébergée dans Azure
Recommandations
Collecter les informations de contexte
Identifiez le tuple (langage de programmation, framework d'application, 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 hypothèse éclairée. Confirmez avec l'utilisateur les points 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 un Azure App Service en tant que code, dans un Azure App Service en tant que conteneur, dans un Azure Container App, etc.).
Privilégiez l'auto-instrumentation si possible
Si l'application est une application C# ASP.NET Core hébergée dans Azure App Service, utilisez le guide AUTO pour aider l'utilisateur à auto-instrumenter l'application.
Instrumenter manuellement
Instrumentez manuellement l'application en créant la ressource AppInsights et en mettant à jour le code de l'application.
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 savoir quoi ajouter. C'est la meilleure option s'il y a des fichiers de modèle Bicep existants dans l'espace de travail.
- Utiliser Azure CLI. Voir scripts/appinsights.ps1 pour connaître la commande Azure CLI à exécuter afin de 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 que celui contenant les ressources de l'application hébergée dans Azure.
Modifier le code de l'application
- Si l'application est une application ASP.NET Core, voir le guide ASPNETCORE pour savoir comment modifier le code C#.
- Si l'application est une application Node.js, voir le guide NODEJS pour savoir comment modifier le code JavaScript/TypeScript.
- Si l'application est une application Python, voir le guide PYTHON pour savoir comment modifier le code Python.
Références rapides du SDK
- Distribution OpenTelemetry : Python | TypeScript
- Exportateur OpenTelemetry : Python | Java