Instrumentation AppInsights

Cette skill permet d'envoyer les données de télémétrie d'une webapp vers Azure App Insights pour une meilleure observabilité de la santé de l'app.

Quand utiliser cette skill

Utilisez cette skill quand l'utilisateur souhaite activer la télémétrie pour sa webapp.

Prérequis

L'app dans l'espace de travail doit être l'un de ces types

• Une app ASP.NET Core hébergée dans Azure
• Une app Node.js hébergée dans Azure

Recommandations

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 la façon dont 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 ex. 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.).

Privilégier 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.

Instrumentation manuelle

Instrumentez manuellement l'app en créant la ressource AppInsights et en mettant à jour le code de l'app.

Créer la 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 ce qu'il faut ajouter. C'est la meilleure option s'il y a des fichiers de modèles Bicep existants dans l'espace de travail.
• Utiliser Azure CLI. Voir scripts/appinsights.ps1 pour la commande Azure CLI à exécuter afin de créer la ressource App Insights.

Peu importe l'option choisie, recommandez à l'utilisateur de créer la ressource App Insights dans un groupe de ressources pertinent 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 dans Azure.

Modifier le code applicatif

• 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.