Ajouter Azure Application Insights à l’aide des services connectés de Visual Studio

  • Article

Avec Visual Studio, vous pouvez connecter les éléments suivants à Azure Application Insights à l’aide de la fonctionnalité Services connectés :

  • Application console .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • ASP.NET Core
  • .NET Core (y compris l’application console, WPF, Windows Forms, bibliothèque de classes)
  • Rôle de travail .NET Core
  • Azure Functions
  • Application de plateforme Windows universelle
  • Xamarin
  • Cordova

La fonctionnalité de service connecté ajoute l’ensemble des références et du code de connexion nécessaires à votre projet, et modifie vos fichiers de configuration de manière appropriée.

Prérequis

Se connecter à Azure Application Insights à l’aide des services connectés

  1. Ouvrez votre projet dans Visual Studio.

  2. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter un service connecté.

  3. Sous l’onglet Services connectés, sélectionnez l’icône + pour les Dépendances de service.

    Capture d’écran montrant l’écran « Ajouter une dépendance de service ».

    Si vous ne voyez pas le nœud Services connectés, choisissez Projet>Services connectés>Ajouter.

  4. Dans la page Ajouter une dépendance, sélectionnez Azure Application Insights.

    Capture d’écran montrant l’écran « Ajouter Azure Application Insights ».

    Si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure. Si vous n’en avez pas, vous pouvez demander un essai gratuit.

  5. Dans l’écran Configurer Azure Application Insights, sélectionnez un composant Azure Application Insights existant, puis sélectionnez Suivant.

    Si vous avez besoin de créer un nouveau composant, passez à l’étape suivante. Sinon, passez à l’étape 7.

    Capture d’écran de l’écran « Se connecter au composant Application Insights existant ».

  6. Pour créer un composant Application Insights :

    1. Sélectionnez Créer un composant Application Insights au bas de l’écran.

    2. Renseignez l’écran Application Insights : Créer, puis sélectionnez Créer.

      Capture d’écran montrant l’écran « Nouveau composant Azure App Insights ».

    3. Lorsque l’écran Configurer Azure Application Insights s’affiche, le nouveau composant apparaît dans la liste. Sélectionnez le nouveau composant dans la liste, puis sélectionnez Suivant.

  7. Entrez un nom de clé d’instrumentation ou choisissez le nom par défaut, puis indiquez si vous voulez que la chaîne de connexion soit stockée dans un fichier de secrets local ou dans Azure Key Vault.

    Capture d’écran montrant l’écran « Spécifier la chaîne de connexion ».

  8. L’écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.

    Capture d’écran montrant l’écran « Résumé des modifications ».

  9. La connexion apparaît sous la section Dépendances de service de l’onglet Services connectés.

    Capture d’écran montrant l’écran « Dépendance de service ».

Se connecter à Azure Application Insights à l’aide des services connectés

Note

Pour les projets .NET Framework, l’interface utilisateur de Services connectés est légèrement différente. Pour voir les différences, comparez à la version Visual Studio 2019 de cette page.

  1. Ouvrez votre projet dans Visual Studio.

  2. Dans Explorateur de solutions, cliquez avec le bouton de droite sur le nœud Services connectés, puis, dans le menu contextuel, sélectionnez Ajouter pour ouvrir le menu des services disponibles.

    Capture d’écran montrant les options du menu contextuel Services connectés.

    Si vous ne voyez pas le nœud Services connectés, choisissez Projet>Services connectés>Ajouter.

  3. Choisir Azure Application Insights. La page Se connecter à la dépendance s’affiche. Vous devez voir deux options, l’une pour un émulateur local, le Kit de développement logiciel (Sdk) Application Insights (local) et l’autre pour la connexion au service Azure Application Insights en direct. Vous pouvez réduire les coûts et simplifier le développement précoce en commençant par l’émulateur local. Vous pouvez migrer vers le service actif ultérieurement en répétant ces étapes et en choisissant l’autre option.

    Capture d’écran montrant les choix Application Insights.

    Si vous choisissez d’utiliser le SDK Application Insights localement, cliquez sur Suivant pour afficher l’écran Résumé des modifications, qui montre comment votre projet est modifié. Une référence de package NuGet est ajoutée à votre projet et le code de connexion de l’émulateur local est ajouté à votre projet.

    Si vous souhaitez vous connecter au service Azure, passez à l’étape suivante ou, si vous n’êtes pas déjà connecté, connectez-vous à votre compte Azure avant de continuer. Si vous n’en avez pas, vous pouvez demander un essai gratuit.

  4. Dans l’écran Configurer Azure Application Insights, sélectionnez un composant Azure Application Insights existant, puis sélectionnez Suivant.

    Si vous avez besoin de créer un nouveau composant, passez à l’étape suivante. Sinon, passez à l’étape 7.

    Capture d’écran de l’écran « Se connecter au composant Application Insights existant ».

  5. Pour créer un composant Application Insights :

    1. Sélectionnez Créer un composant Application Insights au bas de l’écran.

    2. Renseignez l’écran Application Insights : Créer, puis sélectionnez Créer.

      Capture d’écran montrant l’écran « Nouveau composant Azure App Insights ».

    3. Lorsque l’écran Configurer Azure Application Insights s’affiche, le nouveau composant apparaît dans la liste. Sélectionnez le nouveau composant dans la liste, puis sélectionnez Suivant.

  6. Entrez un nom pour le paramètre de connexion et un nom de clé d’instrumentation, ou acceptez les valeurs par défaut.

    Capture d’écran montrant l’écran « Fournir les paramètres de configuration de connexion ».

    Remarque

    Pour améliorer la sécurité, dans Visual Studio 17.12 et versions ultérieures, cette étape crée un nom de paramètre de connexion ; les versions précédentes créent un chaîne de connexion. Les chaînes de connexion stockées dans le système de fichiers local peuvent entraîner un risque de sécurité, s’ils sont exposés par inadvertance.

  7. Cliquez sur Paramètres supplémentaires, puis choisissez si vous souhaitez que le chaîne de connexion stocké dans un fichier de secrets local ou dans Azure Key Vault.

    Capture d’écran montrant Se connecter à Application Insights - écran paramètres supplémentaires.

  8. L’écran Résumé des modifications affiche toutes les modifications qui seront apportées à votre projet si vous terminez le processus. Si les modifications semblent correctes, choisissez Terminer.

    Capture d’écran montrant l’écran « Résumé des modifications ».

  9. Dans Explorateur de solutions, double-cliquez sur le nœud Services connectés pour ouvrir l’onglet Services connectés. La connexion apparaît sous la section Dépendances de service :

    Capture d’écran montrant la section « Dépendances de service ».

    Si vous cliquez sur les trois points en regard de la dépendance que vous avez ajoutée, vous pouvez voir différentes options telles que Se connecter pour rouvrir l’Assistant et modifier la connexion. Vous pouvez également cliquer sur les trois points en haut à droite de la fenêtre pour afficher les options permettant de démarrer les dépendances locales, de modifier les paramètres, etc.

  10. Ouvrez votre fichier de code de démarrage (Program.cs dans les modèles). Vous voyez qu’une ligne similaire à celle-ci a été ajoutée :

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);

Étapes suivantes

Pour les projets ASP.NET Core, découvrez comment activer le monitoring de votre application dans Application Insights pour les applications ASP.NET Core.

Pour les projets ASP.NET, consultez Configurer Application Insights pour votre site web ASP.NET.

Les liens vous redirigent vers la section des articles après les étapes de la configuration initiale, que vous avez déjà faites.

Contenu connexe