Utilisation de la recherche dans Application InsightsUsing Search in Application Insights

Recherche (Search) est la fonctionnalité d’Application Insights qui vous permet de rechercher et d’explorer les éléments de télémétrie, par exemple des pages vues, des exceptions ou des requêtes web.Search is a feature of Application Insights that you use to find and explore individual telemetry items, such as page views, exceptions, or web requests. Vous pouvez également afficher le suivi et les événements de journal que vous avez codés.And you can view log traces and events that you have coded.

(Pour les requêtes plus complexes sur vos données, utilisez Analytics.)(For more complex queries over your data, use Analytics.)

Dans le portail AzureIn the Azure portal

Vous pouvez ouvrir explicitement la recherche de diagnostics à partir du panneau Vue d’ensemble d’Application Insights de votre application :You can open diagnostic search explicitly from the Application Insights Overview blade of your application:

Open diagnostic search

Capture d’écran de graphiques de recherche de diagnostic

La partie principale de Recherche de diagnostic est une liste d’éléments de télémétrie : demandes serveur, pages vues, événements personnalisés que vous avez codés, et ainsi de suite.The main body of Diagnostic Search is a list of telemetry items - server requests, page views, custom events that you have coded, and so on. En haut de la liste se trouve un graphique de synthèse indiquant le nombre d’événements au fil du temps.At the top of the list is a summary chart showing counts of events over time.

Cliquez sur Actualiser pour obtenir les nouveaux événements.Click Refresh to get new events.

Dans Visual StudioIn Visual Studio

Dans Visual Studio, il existe également une fenêtre de recherche Application Insights.In Visual Studio, there's also an Application Insights Search window. Elle est particulièrement utile pour l’affichage des événements de télémétrie générés par l’application que vous déboguez.It's most useful for displaying telemetry events generated by the application that you're debugging. Mais elle peut également afficher les événements collectés à partir de votre application publiée sur le portail Azure.But it can also show the events collected from your published app at the Azure portal.

Ouvrez la fenêtre de recherche dans Visual Studio :Open the Search window in Visual Studio:

Recherche Application Insights dans Visual Studio

La fenêtre de recherche comporte les mêmes fonctionnalités que le portail web :The Search window has features similar to the web portal:

Fenêtre de recherche Visual Studio Application Insights

L’onglet Suivi des opérations est disponible lorsque vous ouvrez une requête ou un affichage de page.The Track Operation tab is available when you open a request or a page view. Une 'Opération' est une séquence d’événements qui est associée à une demande ou un affichage de page unique.An 'operation' is a sequence of events that is associated with to a single request or page view. Par exemple, les appels de dépendance, les exceptions, les journaux d’activité de suivi et les événements personnalisés peuvent faire partie d’une opération unique.For example, dependency calls, exceptions, trace logs, and custom events might be part of a single operation. L’onglet Suivi des opérations représente graphiquement la chronologie et la durée de ces événements par rapport à la demande ou à l’affichage de page.The Track Operation tab shows graphically the timing and duration of these events in relation to the request or page view.

Inspecter les éléments un par unInspect individual items

Sélectionnez un élément de télémétrie pour afficher les champs clés et les éléments associés.Select any telemetry item to see key fields and related items.

Capture d’écran d’une demande de dépendance individuelle

Cette action lance la vue Détails de la transaction de bout en bout :This will launch the end-to-end transaction details view:

Capture d’écran de la vue Détails de la transaction de bout en bout.

Filtrer les types d’événementFilter event types

Ouvrez le panneau Filtre et choisissez les types d’événement que vous souhaitez afficher.Open the Filter blade and choose the event types you want to see. (Si vous souhaitez restaurer plus tard les filtres avec lesquels vous avez ouvert le panneau, cliquez sur Réinitialiser).(If, later, you want to restore the filters with which you opened the blade, click Reset.)

Choisissez le filtre et sélectionnez les types de télémétrie

Les types d'événements sont :The event types are:

Filtrer des valeurs de propriétésFilter on property values

Vous pouvez filtrer les événements en fonction des valeurs de leurs propriétés.You can filter events on the values of their properties. Les propriétés disponibles varient en fonction des types d’événement que vous avez sélectionnés.The available properties depend on the event types you selected.

Par exemple, les demandes avec un code de réponse spécifique.For example, pick out requests with a specific response code.

Développez une propriété et choisissez une valeur

Si vous ne choisissez aucune valeur pour une propriété, cela a le même effet que si vous sélectionniez toutes les valeurs.Choosing no values of a particular property has the same effect as choosing all values. Cela désactive le filtrage sur cette propriété.It switches off filtering on that property.

Notez que les nombres à droite des valeurs de filtre affichent le nombre d’occurrences dans le jeu actuellement filtré.Notice that the counts to the right of the filter values show how many occurrences there are in the current filtered set.

Dans cet exemple, il est clair que la demande 'Rpt/Employees' provoque la majorité des erreurs '500' :In this example, it's clear that the 'Rpt/Employees' request results in most of the '500' errors:

Développez une propriété et choisissez une valeur

Rechercher des événements avec la même propriétéFind events with the same property

Recherchez tous les éléments dont la valeur de la propriété est la même :Find all the items with the same property value:

Cliquez avec le bouton droit sur une propriété

Recherche dans les donnéesSearch the data

Notes

Pour écrire des requêtes plus complexes, ouvrez Analytics à partir du haut du panneau Recherche.To write more complex queries, open Analytics from the top of the Search blade.

Vous pouvez rechercher des termes dans une des valeurs des propriétés.You can search for terms in any of the property values. Cela est particulièrement utile si vous avez écrit des événements personnalisés avec des valeurs de propriété.This is particularly useful if you have written custom events with property values.

Vous pouvez définir une durée, car les recherches sur les plages courtes sont plus rapides.You might want to set a time range, as searches over a shorter range are faster.

Open diagnostic search

Recherchez des mots entiers, pas des sous-chaînes.Search for complete words, not substrings. Utilisez des guillemets pour délimiter les caractères spéciaux.Use quotation marks to enclose special characters.

chaînestring n’est pas trouvé paris not found by mais ceux-ci la trouventbut these do find it
HomeController.AboutHomeController.About homehome
contrôleurcontroller
outout
homecontrollerhomecontroller
aboutabout
« homecontroller.about »"homecontroller.about"
États-UnisUnited States UniUni
tedted
étatsunited
unisstates
états ET unisunited AND states
« états-unis »"united states"

Expressions de recherche utilisables :Here are the search expressions you can use:

Exemple de requêteSample query RésultatEffect
apple Trouve tous les événements dont la période comprend le mot « apple »Find all events in the time range whose fields include the word "apple"
apple AND banana
apple banana
Trouve les événements qui contiennent les deux mots.Find events that contain both words. Utilisez « AND » en lettres majuscules (et non « and » en lettres minuscules).Use capital "AND", not "and".
Forme abrégée.Short form.
apple OR banana Trouve les événements qui contiennent un des deux mots.Find events that contain either word. Utilisez « OR » en lettres capitales (et non « or » en lettres minuscules).Use "OR", not "or".
apple NOT banana Trouve les événements qui contiennent un mot, mais pas l’autre.Find events that contain one word but not the other.

échantillonnageSampling

Si votre application génère un volume important de télémétrie (et si vous utilisez le Kit SDK ASP.NET version 2.0.0-beta3 ou ultérieure), le module d'échantillonnage adaptatif réduit automatiquement le volume qui est envoyé vers le portail en envoyant uniquement une fraction représentative des événements.If your app generates a lot of telemetry (and you are using the ASP.NET SDK version 2.0.0-beta3 or later), the adaptive sampling module automatically reduces the volume that is sent to the portal by sending only a representative fraction of events. Cependant, les événements liés à la même demande sont activés ou désactivés en tant que groupe, afin que vous puissiez naviguer entre les événements connexes.However, events that are related to the same request are selected or deselected as a group, so that you can navigate between related events.

En savoir plus sur l'échantillonnage.Learn about sampling.

Création d’un élément de travailCreate work item

Vous pouvez créer un bogue dans GitHub ou Azure DevOps avec les détails d’un élément de télémétrie.You can create a bug in GitHub or Azure DevOps with the details from any telemetry item.

Cliquez sur Nouvel élément de travail, modifiez les champs, puis cliquez sur OK.

La première fois que vous procédez ainsi, vous êtes invité à configurer un lien vers votre organisation et votre projet Azure DevOps.The first time you do this, you are asked to configure a link to your Azure DevOps organization and project.

Indiquez l’URL de vos services Azure DevOps Services et le nom du projet, puis cliquez sur Autoriser

(Vous pouvez également configurer le lien dans le panneau des éléments de travail).(You can also configure the link on the Work Items blade.)

Envoyer plus de télémétrie à Application InsightsSend more telemetry to Application Insights

En plus de la télémétrie fournie par le Kit de développement logiciel (SDK) Application Insights, vous pouvez :In addition to the out-of-the-box telemetry sent by Application Insights SDK, you can:

  • Capturer le suivi du journal dans votre infrastructure de journalisation favorite dans .NET ou Java.Capture log traces from your favorite logging framework in .NET or Java. Cela signifie que vous pouvez effectuer des recherches dans le suivi du journal et les mettre en corrélation avec les pages vues, les exceptions et autres événements.This means you can search through your log traces and correlate them with page views, exceptions, and other events.
  • Écrire du code pour envoyer des événements personnalisés, des affichages de page et des exceptions.Write code to send custom events, page views, and exceptions.

Découvrez comment envoyer les journaux d’activité et la télémétrie personnalisée à Application Insights.Learn how to send logs and custom telemetry to Application Insights.

Questions et réponsesQ & A

Quelle est la quantité de données conservée ?How much data is retained?

Voir la section Synthèse des limites.See the Limits summary.

Comment puis-je consulter les données POST dans mes demandes serveur ?How can I see POST data in my server requests?

Nous n’enregistrons pas automatiquement les données POST, mais vous pouvez utiliser TrackTrace ou le journal des appels.We don't log the POST data automatically, but you can use TrackTrace or log calls. Placez les données POST dans le paramètre de message.Put the POST data in the message parameter. Vous ne pouvez pas filtrer les messages comme vous le feriez pour les propriétés, mais la limite de taille est plus importante.You can't filter on the message in the same way you can filter on properties, but the size limit is longer.

VidéoVideo

Étapes suivantesNext steps