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 la recherche de diagnostic à partir de l’onglet de vue d’ensemble d’Application Insights de votre application (situé dans la barre supérieure) ou effectuer un examen sur la gauche.You can open diagnostic search from the Application Insights Overview tab of your application (located at in the top bar) or under investigate on the left.

Onglet Rechercher

Accédez au menu déroulant des types d’événements pour voir 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.Go to the Event types' drop-down menu to see a list of telemetry items- server requests, page views, custom events that you have coded, and so on. En haut de la liste des résultats se trouve un graphique de synthèse indiquant le nombre d’événements au fil du temps.At the top of the results' list, is a summary chart showing counts of events over time.

Cliquez sur le menu déroulant ou actualisez pour afficher les nouveaux événements.Click out of the drop-down menu or 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 des détails de la transaction de bout en bout.This will launch the end-to-end transaction details view.

Filtrer les types d’événementFilter event types

Ouvrez le menu déroulant Types d’événements et choisissez les types d’événements que vous souhaitez afficher.Open the Event types' drop-down menu and choose the event types you want to see. (Si vous souhaitez restaurer plus tard les filtres, cliquez sur Réinitialiser).(If, later, you want to restore the filters, click Reset.)

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. Cliquez sur l’icône de filtreClick on the filter icon Icône de filtre pour commencer.to start.

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.

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

Pour rechercher tous les éléments avec la même valeur de propriété, tapez cette dernière dans la barre de recherche ou cliquez sur la case à cocher lorsque vous examinez les propriétés sous l’onglet Filtre.To find all the items with the same property value, either type it into the search bar or click the checkbox when looking through properties in the filter tab.

Cliquez sur la case à cocher d’une propriété sous l’onglet Filtre.

Recherche dans les donnéesSearch the data

Notes

Pour écrire des requêtes plus complexes, ouvrez Logs (Analytics) à partir du haut du panneau Recherche.To write more complex queries, open Logs (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 utile si vous avez écrit des événements personnalisés avec des valeurs de propriété.This is 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.

StringString Introuvable.Not found TrouvéFound
HomeController.AboutHomeController.About home
controller
out
homecontroller
about
"homecontroller.about"
États-UnisUnited States Uni
ted
united
states
united AND states
"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 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 large amount 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.

Accédez à la vue Détails de la transaction de bout en bout en cliquant sur un élément de télémétrie, puis sélectionnez Créer un élément de travail.Go to the end-to-end transaction detail view by clicking on any telemetry item then select Create work 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.

(Vous pouvez également configurer le lien sous l’onglet Éléments de travail).(You can also configure the link on the Work Items tab.)

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.

Étapes suivantesNext steps