Après avoir découvert Application Insights, nous allons maintenant voir comment l’ajouter à votre application Web.

Deux cas de figure s’offrent à vous, soit vous commencez un nouveau projet Web, soit vous en avez déjà un.

Commençons par le cas d’un nouveau projet.

Créer un projet Web intégrant Application Insights

En fait, c’est simple ! Il n’y a qu’une case à cocher lors de la création de votre projet Web.

new project

Pour cela, il faut tout de même avoir l’extension “ Application Insights Tools for Visual Studio ”, qui est installée par défaut depuis l’Update 3 de Visual Studio 2013.

extensions and updates

Avec Visual Studio 2015, c’est le même fonctionnement. L’extension est aussi intégrée mais dans une version plus récente.

new project

Sur une version comme sur l’autre le fonctionnement reste le même. Vous cochez la case “ Ajouter Application Insights au projet ”. Visual Studio vous demande alors de vous identifier avec votre compte Microsoft utilisé sur Azure. Il vous faudra ensuite choisir sur quelle souscription vous voulez ajouter Application Insights.

La dernière étape est de choisir la ressource Application Insights à laquelle rattacher ce projet. Par défaut, il vous est proposé de créer une nouvelle ressource, avec le nom de votre projet. Vous pouvez également vous lier avec une ressource déjà existante.

new project

Une fois votre projet créé, après avoir choisi les options de type de template, d’authentification, si hébergement dans Azure ou non, des fichiers auront été ajouté.

Tout d’abord, il y’a le fichier ApplicationInsights. config. Comme son nom l’indique, c’est ici que vous allez pouvoir configurer quelles fonctionnalités d’Application Insights activer sur votre site.

Un certain nombre de packages sont également ajoutés ainsi que les dlls qui vont avec.

<packages>
  <!-- ... -->
  <package id="Microsoft.ApplicationInsights" version="1.2.3" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.Agent.Intercept" version="1.2.0" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.DependencyCollector" version="1.2.3" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.JavaScript" version="0.21.5-build00175" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.PerfCounterCollector" version="1.2.3" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.Web" version="1.2.3" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.WindowsServer" version="1.2.3" targetFramework="net45" />
  <package id="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel" version="1.2.3" targetFramework="net45" />
  <!-- ... -->
</packages>

Application Insights est maintenant prêt à être utilisé.

Ajouter Application Insights à un projet existant

Ce n’est pas beaucoup plus compliqué !

Faite un clic droit sur votre projet Web et cliquez sur “ Add Application Insights ”

solution explorer

Visual Studio vous demande de vous authentifier avec votre compte Azure et de sélectionner la ressource Application Insights à créer ou utiliser (comme pour un nouveau projet)

add application insights to project

Une fois cliqué sur “ Ajouter ”, Visual Studio installe les packages NuGet nécessaires (ceux vu plus haut).

visual studio

Et voilà ! Simple non ?

Ajouter le suivi des pages vues

Dans cet article je ne rentrerai pas dans le détail du code pour utiliser toutes les fonctionnalités Application Insights mais on va néanmoins voir comment ajouter le suivi des pages vues.

Pour ce faire, nous allons ajouter un peu de javascript dans la page _Layout. cshtml afin d’avoir le suivi sur toutes les pages de notre site. Là où est Microsoft est malin, c’est que ce code nous est fourni, il n’y a qu’à le copier-coller ! Ceci est valable uniquement si vous avez ajouté Application Insights à un projet existant puisque dans le cas d’un nouveau projet cela est déjà fait.

Ce code est disponible sur Azure, dans le menu “ Démarrage Rapide ” (Quick Start) de votre ressource Application Insights. Mais comme décidément Microsoft veut nous aider, un lien direct vers Azure est ajouté avec le fichier de configuration.

fichier de configuration

Une fois sur Azure, Démarrage rapide > Surveiller application coté Client > Copier

preview

Ce script est à placer avant la balise </head> de fermeture et avant tout autre script.

La partie importante – et variable – de ce code est l’instrumentation key, qui correspond à l’identifiant de votre ressource Application Insights. Vous retrouvez cette clé dans le fichier de configuration et qui servira pour la partie Serveur.

Lors de la première exécution de votre site, Visual Studio vous indiquera que vous avez envoyé vos premières données.

première exécution

Et un compteur dans la barre d’outils vous permet de suivre les données envoyées

barre d'outils

Les données elles-mêmes peuvent être visualisées dans la fenêtre Output.

fenêtre output

Conclusion

Maintenant vous pouvez démarrer l’utilisation d’Application Insights. Pour en savoir plus sur l’implémentation, je vous conseille d’aller faire un tour sur la documentation du site d’Azure (lien ci-dessous). Nous verrons dans d’autres articles les autres fonctionnalités disponibles.

Ne ratez plus aucunes actualités avec la newsletter mensuelle de SoftFluent