Utilisation de la recherche dans Application Insights

Recherche de transaction 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. Vous pouvez également afficher le suivi et les événements de journal que vous avez codés.

(Pour les requêtes plus complexes sur vos données, utilisez Analytics.)

Dans le portail Azure

Vous pouvez ouvrir la recherche de transaction à 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.

Search tab

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. 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.

Cliquez sur le menu déroulant ou actualisez pour afficher les nouveaux événements.

Dans Visual Studio

Dans Visual Studio, il existe également une fenêtre de recherche Application Insights. 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. Mais elle peut également afficher les événements collectés à partir de votre application publiée sur le portail Azure.

Ouvrez la fenêtre de recherche dans Visual Studio :

Visual Studio open Application Insights search

La fenêtre de recherche comporte les mêmes fonctionnalités que le portail web :

Visual Studio Application Insights search window

L’onglet Suivi des opérations est disponible lorsque vous ouvrez une requête ou un affichage de page. Une 'Opération' est une séquence d’événements qui est associée à une demande ou un affichage de page unique. 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. 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.

Inspecter les éléments un par un

Sélectionnez un élément de télémétrie pour afficher les champs clés et les éléments associés.

Screenshot of an individual dependency request

Cette action lance la vue des détails de la transaction de bout en bout.

Filtrer les types d’événement

Ouvrez le menu déroulant Types d’événements et choisissez les types d’événements que vous souhaitez afficher. (Si vous souhaitez restaurer plus tard les filtres, cliquez sur Réinitialiser).

Les types d'événements sont :

Filtrer des valeurs de propriétés

Vous pouvez filtrer les événements en fonction des valeurs de leurs propriétés. Les propriétés disponibles varient en fonction des types d’événement que vous avez sélectionnés. Cliquez sur l’icône de filtre Filter icon pour commencer.

Si vous ne choisissez aucune valeur pour une propriété, cela a le même effet que si vous sélectionniez toutes les valeurs. Cela désactive le filtrage sur cette propriété.

Notez que les nombres à droite des valeurs de filtre affichent le nombre d’occurrences dans le jeu actuellement filtré.

Rechercher des événements avec la même propriété

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.

Click the checkbox of a property in the filter tab

Recherche dans les données

Notes

Pour écrire des requêtes plus complexes, ouvrez Logs (Analytics) à partir du haut du panneau Recherche.

Vous pouvez rechercher des termes dans une des valeurs des propriétés. Cela est utile si vous avez écrit des événements personnalisés avec des valeurs de propriété.

Vous pouvez définir une durée, car les recherches sur les plages courtes sont plus rapides.

Open diagnostic search

Recherchez des mots entiers, pas des sous-chaînes. Utilisez des guillemets pour délimiter les caractères spéciaux.

String Introuvable. Trouvé
HomeController.About home
controller
out
homecontroller
about
"homecontroller.about"
États-Unis Uni
ted
united
states
united AND states
"united states"

Expressions de recherche utilisables :

Exemple de requête Résultat
apple Trouve tous les événements dont la période comprend le mot « apple »
apple AND banana
apple banana
Trouve les événements qui contiennent les deux mots. Utilisez « AND » en lettres majuscules (et non « and » en lettres minuscules).
Forme abrégée.
apple OR banana Trouve les événements qui contiennent un des deux mots. Utilisez « OR » en lettres capitales (et non « or » en lettres minuscules).
apple NOT banana Trouve les événements qui contiennent un mot, mais pas l’autre.

échantillonnage

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. 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.

En savoir plus sur l'échantillonnage.

Création d’un élément de travail

Vous pouvez créer un bogue dans GitHub ou Azure DevOps avec les détails d’un élément de télémétrie.

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.

Click New Work Item, edit the fields, and then click OK.

La première fois que vous procédez ainsi, vous êtes invité à configurer un lien vers votre organisation et votre projet Azure DevOps.

(Vous pouvez également configurer le lien sous l’onglet Éléments de travail).

Envoyer plus de télémétrie à Application Insights

En plus de la télémétrie fournie par le Kit de développement logiciel (SDK) Application Insights, vous pouvez :

  • Capturer le suivi du journal dans votre infrastructure de journalisation favorite dans .NET ou 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.
  • Écrire du code pour envoyer des événements personnalisés, des affichages de page et des exceptions.

Découvrez comment envoyer les journaux d’activité et la télémétrie personnalisée à Application Insights.

Questions-réponses

Quelle est la quantité de données conservée ?

Voir la section Synthèse des limites.

Comment puis-je consulter les données POST dans mes demandes serveur ?

Nous n’enregistrons pas automatiquement les données POST, mais vous pouvez utiliser TrackTrace ou le journal des appels. Placez les données POST dans le paramètre de message. Vous ne pouvez pas filtrer les messages comme vous le feriez pour les propriétés, mais la limite de taille est plus importante.

Étapes suivantes