Configurer Application Insights pour votre site web ASP.NETSet up Application Insights for your ASP.NET website

Cette procédure configure votre application web ASP.NET pour l’envoi de données de télémétrie au service Azure Application Insights.This procedure configures your ASP.NET web app to send telemetry to the Azure Application Insights service. Elle fonctionne pour les applications ASP.NET hébergées sur votre propre serveur IIS local ou dans le cloud.It works for ASP.NET apps that are hosted either in your own IIS server on-premises or in the Cloud. Vous obtenez des graphiques et un langage de requête puissant, qui vous aident à comprendre les performances de votre application et son utilisation, ainsi que des alertes automatiques sur les défaillances ou les problèmes de performances.You get charts and a powerful query language that help you understand the performance of your app and how people are using it, plus automatic alerts on failures or performance issues. De nombreux développeurs trouvent ces fonctionnalités exceptionnelles telles quelles, mais vous pouvez également étendre et personnaliser les données de télémétrie si vous en avez besoin.Many developers find these features great as they are, but you can also extend and customize the telemetry if you need to.

L’installation se fait en seulement quelques clics dans Visual Studio.Setup takes just a few clicks in Visual Studio. Vous avez la possibilité d’éviter des frais en limitant le volume de données de télémétrie.You have the option to avoid charges by limiting the volume of telemetry. Cette fonctionnalité vous permet de tester et de déboguer, ou de surveiller un site avec peu d’utilisateurs.This functionality allows you to experiment and debug, or to monitor a site with not many users. Si vous décidez plus tard de vous lancer et de surveiller votre site de production, il sera facile d’augmenter la limite.When you decide you want to go ahead and monitor your production site, it's easy to raise the limit later.

PrérequisPrerequisites

Pour Application Insights à votre site web ASP.NET, vous devez :To add Application Insights to your ASP.NET website, you need to:

  • Installez Visual Studio 2019 pour Windows avec les charges de travail suivantes :Install Visual Studio 2019 for Windows with the following workloads:
    • Développement ASP.NET et web (ne décochez pas les composants optionnels)ASP.NET and web development (Do not uncheck the optional components)
    • Développement AzureAzure development

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.If you don't have an Azure subscription, create a free account before you begin.

Étape 1 : Ajouter le Kit SDK Application InsightsStep 1: Add the Application Insights SDK

Important

Les captures d’écran de cet exemple sont basées sur Visual Studio 2017 version 15.9.9 ou ultérieure.The screenshots in this example are based on Visual Studio 2017 version 15.9.9 and later. L’expérience d’ajout d’Application Insights varie selon les versions de Visual Studio et le type de modèle ASP.NET.The experience to add Application Insights varies across versions of Visual Studio as well as by ASP.NET template type. Les versions plus anciennes peuvent comporter du texte de remplacement tel que « Configurer Application Insights ».Older versions may have alternate text such as "Configure Application Insights".

Faites un clic droit sur le nom de votre application web dans l’Explorateur de solutions, puis choisissez Ajouter > Application Insights TelemetryRight-click your web app name in the Solution Explorer, and choose Add > Application Insights Telemetry

Capture d’écran de l’Explorateur de solutions, avec l’option Configurer Application Insights en surbrillance

(Selon la version de votre SDK d’Application Insights, vous pouvez être invité à passer à la dernière version du Kit de développement logiciel (SDK).(Depending on your Application Insights SDK version you may be prompted to upgrade to the latest SDK release. Si vous y êtes invité, sélectionnez Mettre à jour le SDK.)If prompted, select Update SDK.)

Capture d’écran : Une nouvelle version du SDK Microsoft Application Insights est disponible.

Écran de configuration d’Application Insights :Application Insights Configuration screen:

Sélectionnez Prise en main.Select Get Started.

Capture d’écran de la page Inscrire votre application auprès d’Application Insights

Si vous souhaitez définir le groupe de ressources ou l’emplacement où vos données sont stockées, cliquez sur Configurer les paramètres.If you want to set the resource group or the location where your data is stored, click Configure settings. Les groupes de ressources sont utilisés pour contrôler l’accès aux données.Resource groups are used to control access to data. Par exemple, si vous possédez plusieurs applications qui font partie du même système, vous pourrez placer leurs données Application Insights dans le même groupe de ressources.For example, if you have several apps that form part of the same system, you might put their Application Insights data in the same resource group.

Sélectionnez Inscription.Select Register.

Capture d’écran de la page Inscrire votre application auprès d’Application Insights

Sélectionnez Projet > Gérer les packages NuGet > Source du package : nuget.org > Confirmez que vous disposez de la dernière version stable du Kit de développement logiciel (SDK) Application Insights.Select Project > Manage NuGet Packages > Package source: nuget.org > Confirm that you have the latest stable release of the Application Insights SDK.

Les données de télémétrie seront envoyées au portail Azure, pendant le débogage et une fois que vous aurez publié votre application.Telemetry will be sent to the Azure portal, both during debugging and after you have published your app.

Notes

Si vous ne souhaitez pas envoyer de données de télémétrie au portail pendant le débogage, ajoutez simplement le kit de développement logiciel (SDK) Application Insights à votre application, mais ne configurez pas de ressource dans le portail.If you don't want to send telemetry to the portal while you're debugging, just add the Application Insights SDK to your app but don't configure a resource in the portal. Vous êtes en mesure de voir les données de télémétrie dans Visual Studio pendant le débogage.You are able to see telemetry in Visual Studio while you are debugging. Plus tard, vous pouvez revenir à cette page de configuration, ou vous pouvez attendre d’avoir déployé votre application et activer les données de télémétrie au moment de l’exécution.Later, you can return to this configuration page, or you could wait until after you have deployed your app and switch on telemetry at run time.

Étape 2 : Exécutez l'application.Step 2: Run your app

Exécutez votre application en appuyant sur F5.Run your app with F5. Ouvrez différentes pages pour générer des données de télémétrie.Open different pages to generate some telemetry.

Un décompte des événements consignés s’affiche dans Visual Studio.In Visual Studio, you will see a count of the events that have been logged.

Capture d’écran de Visual Studio.

Étape 3 : afficher vos données de télémétrieStep 3: See your telemetry

Vous pouvez voir vos données de télémétrie dans Visual Studio ou sur le portail web Application Insights.You can see your telemetry either in Visual Studio or in the Application Insights web portal. Recherchez les données de télémétrie dans Visual Studio pour vous aider à déboguer votre application.Search telemetry in Visual Studio to help you debug your app. Surveillez les performances et l’utilisation dans le portail web lorsque votre système est en ligne.Monitor performance and usage in the web portal when your system is live.

Afficher vos données de télémétrie dans Visual StudioSee your telemetry in Visual Studio

Dans Visual Studio, pour afficher les données d’Application Insights.In Visual Studio, to view Application Insights data. Sélectionnez Explorateur de solutions > Services connectés > faites un clic droit sur Application Insights, puis cliquez sur Rechercher parmi la télémétrie active.Select Solution Explorer > Connected Services > right-click Application Insights, and then click Search Live Telemetry.

Dans la fenêtre de recherche de Visual Studio Application Insights, vous verrez les données de votre application pour consulter les données de télémétrie générées côté serveur de votre application.In the Visual Studio Application Insights Search window, you will see the data from your application for telemetry generated in the server side of your app. Faites des essais avec les filtres, puis cliquez sur n’importe quel événement pour afficher plus de détails.Experiment with the filters, and click any event to see more detail.

Capture d’écran des données de la session de débogage dans la fenêtre Application Insights.

Conseil

Si aucune donnée n’apparaît, assurez-vous que l’intervalle de temps est correct, puis cliquez sur l’icône de recherche.If you don't see any data, make sure the time range is correct, and click the Search icon.

En savoir plus sur les outils Application Insights dans Visual Studio.Learn more about Application Insights tools in Visual Studio.

Afficher les données de télémétrie dans le portail webSee telemetry in web portal

Vous pouvez également afficher les données de télémétrie dans le portail web Application Insights, à moins que vous n’ayez choisi d’installer le Kit de développement logiciel (SDK) uniquement.You can also see telemetry in the Application Insights web portal (unless you chose to install only the SDK). Le portail offre plus de graphiques, d’outils d’analyse et de vues de plusieurs composants que Visual Studio.The portal has more charts, analytic tools, and cross-component views than Visual Studio. Le portail fournit également des alertes.The portal also provides alerts.

Ouvrez votre ressource Application Insights.Open your Application Insights resource. Connectez-vous dans le portail Azure et trouvez-les ici, ou bien sélectionnez Explorateur de solutions > Services connectés > faites un clic droit sur Application Insights > Ouvrir le portail Application Insights et attendez pour y accéder.Either sign into the Azure portal and find it there, or select Solution Explorer > Connected Services > right-click Application Insights > Open Application Insights Portal and let it take you there.

Lorsque le portail s’ouvre, il affiche les données de télémétrie de votre application.The portal opens on a view of the telemetry from your app.

Capture d’écran de la page de présentation Application Insights

Dans le portail, cliquez sur n’importe quelle mosaïque ou n’importe quel graphique pour afficher plus de détails.In the portal, click any tile or chart to see more detail.

Étape 4 : Publier votre applicationStep 4: Publish your app

Publiez votre application sur votre serveur IIS ou sur Azure.Publish your app to your IIS server or to Azure. Vérifiez Live Metrics Stream (Flux continu de mesures) pour vous assurer que tout fonctionne correctement.Watch Live Metrics Stream to make sure everything is running smoothly.

Vos données de télémétrie s’affichent dans le portail Application Insights, où vous pouvez surveiller les mesures et effectuer une recherche dans vos données de télémétrie.Your telemetry builds up in the Application Insights portal, where you can monitor metrics, search your telemetry. Vous pouvez également utiliser la puissante langue de requête Kusto pour analyser l’utilisation et les performances ou rechercher des événements spécifiques.You can also use the powerful Kusto query language to analyze usage and performance, or to find specific events.

Vous pouvez également continuer à analyser vos données de télémétrie dans Visual Studio à l’aide d’outils comme la recherche de diagnostic et les tendances.You can also continue to analyze your telemetry in Visual Studio, with tools such as diagnostic search and trends.

Notes

Si votre application envoie tellement de données de télémétrie qu’elle approche de la limite, l’échantillonnage automatique s’active.If your app sends enough telemetry to approach the throttling limits, automatic sampling switches on. L’échantillonnage réduit la quantité de données de télémétrie envoyées depuis votre application, tout en conservant les données liées au diagnostic.Sampling reduces the quantity of telemetry sent from your app, while preserving correlated data for diagnostic purposes.

Vous êtes prêt.You're all set

Félicitations !Congratulations! Vous avez installé le package Application Insights dans votre application et l’avez configuré pour envoyer des données de télémétrie au service Application Insights dans Azure.You installed the Application Insights package in your app, and configured it to send telemetry to the Application Insights service on Azure.

La ressource Azure qui reçoit les données de télémétrie de votre application est identifiée par une clé d’instrumentation.The Azure resource that receives your app's telemetry is identified by an instrumentation key. Vous trouverez cette clé dans le fichier ApplicationInsights.config.You'll find this key in the ApplicationInsights.config file.

Mettre à niveau vers les versions ultérieures du Kit de développement logiciel (SDK)Upgrade to future SDK versions

Pour passer à la nouvelle version du Kit de développement logiciel (SDK), ouvrez le gestionnaire de package NuGet et filtrez les packages qui ont été installés.To upgrade to a new release of the SDK, open the NuGet package manager, and filter on installed packages. Sélectionnez Microsoft.ApplicationInsights.Web et choisissez Mettre à niveau.Select Microsoft.ApplicationInsights.Web, and choose Upgrade.

Si vous avez apporté des personnalisations à ApplicationInsights.config, conservez-en une copie avant d’effectuer la mise à niveau.If you made any customizations to ApplicationInsights.config, save a copy of it before you upgrade. Fusionnez ensuite vos modifications dans la nouvelle version.Then, merge your changes into the new version.

VidéoVideo

Étapes suivantesNext steps

Vous pouvez consulter d’autres rubriques selon les aspects qui vous intéressent :There are alternative topics to look at if you are interested in:

Données de télémétrie supplémentairesMore telemetry

AnalyseAnalysis

AlertesAlerts

  • Tests de disponibilité : créez des tests pour vous assurer que votre site est visible sur le web.Availability tests: Create tests to make sure your site is visible on the web.
  • Diagnostics intelligents : ces tests s’exécutent automatiquement, sans que vous n’ayez rien à faire pour les configurer.Smart diagnostics: These tests run automatically, so you don't have to do anything to set them up. Ils vous indiquent si votre application affiche un taux inhabituel de demandes ayant échoué.They tell you if your app has an unusual rate of failed requests.
  • Alertes de métriques : Définissez des alertes qui vous avertissent si un indicateur de performance dépasse un seuil.Metric alerts: Set alerts to warn you if a metric crosses a threshold. Vous pouvez définir des mesures personnalisées que vous codez dans votre application.You can set them on custom metrics that you code into your app.

AutomatisationAutomation