Modèle de données de télémétrie d’Application Insights

Application Insights envoie des données de télémétrie de votre application web au portail Azure pour fournir des insights sur les performances et l’utilisation de votre application et de votre infrastructure. Pour mieux comprendre et organiser les données de télémétrie, nous les catégorisons en types distincts.

Le modèle de données de télémétrie est normalisé, ce qui permet de créer une supervision indépendante de la plateforme et du langage. Nous faisons en sorte que ce modèle reste le plus simple et le plus léger possible pour prendre en charge des scénarios essentiels et permettre l’extension du schéma pour une utilisation avancée.

Les données collectées par Application Insights modélisent ce modèle d’exécution d’application classique :

¹availabilityResults ne sont pas disponibles par défaut et nécessitent la configuration des tests de disponibilité.
²customEvents et customMetrics sont disponibles uniquement avec l’instrumentation personnalisée.

Remarque

Application Insights stocke les journaux d’activité dans la table traces pour des raisons héritées. Les étendues des traces distribuées sont stockées dans les tables et requests les dependencies. Nous prévoyons de résoudre ce problème dans une prochaine version afin d’éviter toute confusion.

Types de télémétrie

Les types de télémétrie suivants sont utilisés pour surveiller l’exécution de votre application. Le module Azure Monitor OpenTelemetry Distro et le kit SDK JavaScript d’Application Insights collectent les éléments suivants :

Type de télémétrie	Nom de la table (Application Insights)	Nom de la table (Log Analytics)	Descriptif
Disponibilité	availabilityResults	AppAvailabilityResults	Surveille la disponibilité et la réactivité de votre application en envoyant des requêtes web à intervalles réguliers et en vous alertant si l’application ne répond pas ou si le temps de réponse est trop lent.
Chronométrage du navigateur	browserTimings	AppBrowserTimings	Mesure les performances des pages web, y compris les temps de chargement de page et les durées réseau.
Dépendance	dependencies	AppDependencies	Effectue le suivi des appels de votre application vers un service ou un stockage externe, tel qu’une API REST ou une base de données SQL, et mesure la durée et la réussite de ces appels.
Événement	customEvents	AppEvents	Généralement utilisé pour capturer les interactions utilisateur et d’autres occurrences importantes au sein de votre application, telles que des clics de bouton ou des commandes, pour analyser les modèles d’utilisation.
Exception	exceptions	AppExceptions	Capture les informations d’erreur cruciales pour la résolution et la compréhension des échecs.
Mesure	performanceCounters customMetrics	AppPerformanceCounters AppMetrics	Les compteurs de performances fournissent des données numériques sur différents aspects des performances de l’application et du système, tels que l’utilisation du processeur et la consommation de mémoire. En outre, les métriques personnalisées vous permettent de définir et de suivre des mesures spécifiques propres à votre application, ce qui offre une flexibilité pour surveiller les indicateurs de performances personnalisés.
Affichage de page	pageViews	AppPageViews	Suit les pages affichées par les utilisateurs, fournissant des insights sur la navigation et l’engagement des utilisateurs au sein de votre application.
Requête	requests	AppRequests	Journalise les demandes reçues par votre application, en fournissant des détails tels que l’ID d’opération, la durée et l’état de réussite ou d’échec.
Trace	traces	AppTraces	Enregistre des événements spécifiques à l’application, tels que des messages de diagnostic personnalisés ou des instructions de trace, qui sont utiles pour le débogage et la surveillance du comportement de l’application au fil du temps.

Important

Vous pouvez interroger les données de télémétrie d’application à partir d’Application Insights et log Analytics (recommandé), mais les noms de table et de champ sont différents. Cette distinction conserve la compatibilité descendante, par exemple pour garantir que les tableaux de bord clients avec des requêtes personnalisées créées avant la convention d’affectation de noms Log Analytics continuent de fonctionner correctement.

Pour comparer les noms de champs dans le portail Azure, ouvrez Application Insights>Logs, exécutez une requête, et copiez le contenu d'un élément de télémétrie (par exemple, Id1234a5b6c7de8f90). Ensuite, ouvrez un nouvel onglet dans votre navigateur, accédez à Log Analytics>Journaux d’activité, passez en mode KQL et exécutez la requête :

AppDependencies // Notice that table names are also different.
| where Id == "1234a5b6c7de8f90"

Développez les deux éléments de télémétrie en sélectionnant le chevron à gauche de chaque ligne pour afficher toutes leurs propriétés.

Chaque élément de télémétrie peut inclure des informations contextuelles telles que la version de l’application ou l’ID de session utilisateur. Le contexte se compose d’un ensemble de champs fortement typés qui permettent différents scénarios d’analyse.

Par exemple, lorsque la version de l’application est correctement initialisée, Application Insights peut détecter de nouveaux modèles dans le comportement de l’application mis en corrélation avec le redéploiement. De même, vous pouvez utiliser l’ID de session pour évaluer l’impact des pannes ou des problèmes sur les utilisateurs. En calculant le nombre d’ID de session uniques associés aux dépendances ayant échoué, aux traces d’erreurs ou aux exceptions critiques, vous obtenez une image plus claire de l’impact de l’utilisateur.

Le modèle de télémétrie Application Insights prend également en charge la corrélation des éléments de télémétrie aux opérations auxquelles ils appartiennent. Par exemple, si une demande déclenche un appel SQL Database, la requête et l’appel de dépendance peuvent inclure des données de diagnostic et être liées via un contexte de corrélation partagé, ce qui vous permet de suivre le flux complet de l’opération.

Cet article traite des champs spécifiques à chaque type de télémétrie. Pour afficher la liste complète des champs disponibles (y compris les champs de contexte) pour n’importe quel type de télémétrie, suivez le lien fourni sous chaque table appropriée.

Télémétrie de disponibilité

La télémétrie de disponibilité implique une surveillance synthétique, où les tests simulent les interactions utilisateur pour vérifier que l’application est disponible et réactive. Nous vous recommandons de configurer des tests de disponibilité standard pour surveiller la disponibilité de votre application à partir de différents points du monde entier et d’envoyer vos propres informations de test à Application Insights.

Champs spécifiques à la disponibilité :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
id	Id	Identificateur unique d’un résultat de test de disponibilité, utilisé pour la corrélation entre les exécutions de tests individuelles, ce qui peut aider à tracer des défaillances ou des modèles spécifiques au fil du temps. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.
name	Name	Nom d’un test de disponibilité. Elle est définie lors de la création du test (par exemple, « Test ping de la page d’accueil »).
location	Location	Emplacement géographique ou région du centre de données à partir de laquelle un test de disponibilité a été exécuté (par exemple, USA Ouest, Europe Nord). Il permet d’identifier les pannes régionales ou les problèmes de latence.
success	Success	Ce champ indique si un test de disponibilité a réussi ou non. Il s’agit d’une valeur booléenne où true signifie que le test a réussi et false qu’il a échoué.
message	Message	Message descriptif contenant des détails sur le résultat du test. Il contient souvent des détails d’exception ou des réponses d’erreur.
duration	Duration	Durée d’exécution du test de disponibilité. Il permet de mesurer les performances et d’identifier les problèmes de temps de réponse. La durée est généralement mesurée en millisecondes.

Pour obtenir la liste de tous les champs disponibles, consultez AppAvailabilityResults.

Télémétrie des temps de minutage du navigateur

Les navigateurs exposent des mesures pour les actions de chargement de page avec l’API Performance. Application Insights simplifie ces mesures en consolidant les minutages associés dans les métriques de navigateur standard.

Champs spécifiques au minutage du navigateur :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
networkDuration	NetworkDurationMs	Le client accède au DNS pour résoudre le nom d’hôte du site web, et DNS répond avec l’adresse IP. Le client crée des liaisons TCP, puis TLS avec le serveur web.
sendDuration	SendDurationMs	Le client envoie la charge utile de la demande, attend que le serveur exécute la requête et reçoit le premier paquet de réponse.
receiveDuration	ReceiveDurationMs	Le client reçoit le reste des octets de charge utile de réponse du serveur web.
processingDuration	ProcessingDurationMs	Le client dispose désormais d’une charge utile de réponse complète et doit afficher le contenu dans le navigateur et charger le DOM.
totalDuration	TotalDurationMs	Somme de tous les minutages du navigateur.

Pour obtenir la liste de tous les champs disponibles, consultez AppBrowserTimings.

Télémétrie des dépendances

Un élément de télémétrie de dépendance représente une interaction du composant surveillé avec un composant distant tel que SQL ou un point de terminaison HTTP.

Champs spécifiques aux dépendances :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
id	Id	Identificateur unique d’une instance d’appel de dépendance, utilisé pour la corrélation avec l’élément de télémétrie de requête qui correspond à cet appel de dépendance. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.
target	Target	Le site cible d’un appel de dépendance. Exemples : nom de serveur et adresse d’hôte. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.
type	DependencyType	Nom du type de dépendance. Il s’agit d’une valeur de faible cardinalité pour le regroupement logique de dépendances et l’interprétation d’autres champs comme commandName et resultCode. Exemples : SQL, table Azure et HTTP.
name	Name	Nom de la commande lancée avec cet appel de dépendance. Il a une valeur de cardinalité faible. Exemples : nom de procédure stockée et modèle de chemin d’accès d’URL.
data	Data	Commande lancée par cet appel de dépendance. Exemples : instruction SQL et URL HTTP avec tous les paramètres de requête.
success	Success	Ce champ indique si un appel a réussi ou non. Il s’agit d’une valeur booléenne où true l’appel a réussi et false signifie qu’il a échoué.
resultCode	ResultCode	Code de résultat d’un appel de dépendance. Exemples : code d’erreur SQL et code d’état HTTP.
duration	DurationMs	La durée de la demande est au format DD.HH:MM:SS.MMMMMM. Elle doit être inférieure à 1000 jours.

Pour obtenir la liste de tous les champs disponibles, consultez AppDependencies.

Télémétrie des événements

Vous pouvez créer des éléments de télémétrie d’événement pour représenter un événement qui s’est produit dans votre application. En général, il s’agit d’une interaction utilisateur comme un clic sur un bouton ou une validation de commande. Il peut aussi s’agir d’un événement lié au cycle de vie de l’application, comme une initialisation ou une mise à jour de configuration.

Pour en savoir plus sur la création de données de télémétrie d’événements personnalisées, consultez Ajouter et modifier Azure Monitor OpenTelemetry pour .NET, Java, Node.jset les applications Python.

Champs spécifiques à l’événement :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
name	Name	Pour permettre un regroupement approprié et des métriques utiles, limitez votre application afin qu’elle génère quelques noms d’événements distincts. Par exemple, n’utilisez pas un nom distinct pour chaque instance générée d’un événement.

Pour obtenir la liste de tous les champs disponibles, consultez AppEvents.

Télémétrie des exceptions

Un élément de télémétrie d’exception représente une exception gérée ou non gérée qui s’est produite pendant l’exécution de l’application surveillée.

Champs spécifiques à l’exception :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
problemId	ProblemId	Identifie l’emplacement où l’exception a été levée dans le code. Il est utilisé pour le regroupement d’exceptions. Généralement, c'est une combinaison d'un type d’exception et d'une fonction de la pile des appels.
type	ExceptionType	Type spécifique d’exception qui s’est produite. Cela inclut généralement l’espace de noms et le nom de classe, tels que System.NullReferenceException ou System.InvalidOperationException.
assembly	Assembly	L'assemblée où l’exception a été levée. Cela est utile pour identifier le composant de l’application responsable de l’exception.
method	Method	Nom de méthode dans l’assembly où l’exception a été levée. Cela fournit des informations contextuelles sur l’emplacement dans le code où l’erreur s’est produite.
outerType	OuterType	Si l'exception actuelle est imbriquée dans une autre exception, le type de l'exception externe (d'enveloppement). Cela est utile pour comprendre le contexte dans lequel l’exception interne s’est produite et peut vous aider à tracer la séquence d’erreurs.
outerMessage	OuterMessage	Ce message fournit une explication lisible par l’homme de l’exception externe et peut être utile pour comprendre le problème plus large.
outerAssembly	OuterAssembly	L'assemblage où l'exception externe est apparue.
outerMethod	OuterMethod	Méthode de l’exception externe. Cela fournit des informations détaillées sur le point de défaillance dans l’exception externe.
severityLevel	SeverityLevel	Le niveau de gravité de la trace peut être l’une des valeurs suivantes : Verbose, , Information, Warning, Errorou Critical.
details	Details	Contient des informations d’exception telles que le message d'erreur et la pile des appels.

Pour obtenir la liste de tous les champs disponibles, consultez AppExceptions.

Télémétrie métrique

Application Insights prend en charge deux types de télémétrie des indicateurs de performance :

• Une seule mesure a un nom et une valeur.
• Une métrique prédéfinie prend plusieurs mesures dans une période d’agrégation de 1 minute.

Compteurs de performance

Les compteurs de performances sont toujours des métriques de mesure uniques avec un name et un value, mais sont fournis avec les champs categorysupplémentaires , counteret pour les applications Windows également instance.

Champs spécifiques aux compteurs de performances :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
name	Name	Nom de la métrique que vous souhaitez voir dans le portail Application Insights.
value	Value	Valeur unique pour la mesure. Il s’agit de la somme des mesures individuelles pour l’agrégation.
category	Category	Représente un groupe de compteurs de performances associés (par exemple, Process).
counter	Counter	Spécifie la métrique de performances particulière mesurée dans une catégorie (par exemple). IO Data Bytes/sec
instance	Instance	Identifie une occurrence spécifique d’un compteur dans une catégorie (par exemple, ??APP_WIN32_PROC??).

Pour obtenir la liste de tous les champs disponibles, consultez AppPerformanceCounters.

Pour en savoir plus sur les métriques, consultez Métriques dans Application Insights. Pour plus d’informations sur l’API REST Metrics, consultez Metrics - Get.

Compteurs système et de processus

Nom .NET	Descriptif
\Processor(_Total)\% Processor Time	Nombre total de processeurs de l’ordinateur.
\Memory\Available Bytes	Affiche la quantité de mémoire physique (en octets) disponible pour les processus en cours d’exécution sur l’ordinateur. Elle est calculée en additionnant la quantité d’espace sur les listes de mémoire mises à zéro, libres et en attente. La mémoire libre est prête à être utilisée. La mémoire mise à zéro se compose de pages de mémoire remplies de zéros pour empêcher les processus ultérieurs de voir les données utilisées par un processus précédent. La mémoire en attente est la mémoire qui a été supprimée de l’ensemble de travail d’un processus (sa mémoire physique) en route vers le disque, mais qui est toujours disponible pour être rappelée. Voir Objet mémoire.
\Process(??APP_WIN32_PROC??)\% Processor Time	Processeur du processus hébergeant l’application.
\Process(??APP_WIN32_PROC??)\Private Bytes	Mémoire utilisée par le processus hébergeant l’application.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Taux d’opérations d’E/S exécutées par le processus hébergeant l’application.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests/Sec	Taux de demandes traitées par une application.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Taux d’exceptions levées par une application.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Durée moyenne d’exécution des requêtes.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Nombre de requêtes en attente de traitement dans une file d’attente.

Propriétés personnalisées

Si la propriété personnalisée CustomPerfCounter d’une métrique est définie sur true, celle-ci représente le compteur de performances Windows. Ces métriques sont placées dans la table performanceCounters, et non dans customMetrics. De plus, le nom de cette métrique est analysé pour extraire la catégorie, le compteur et les noms d’instance.

Métriques personnalisées

Les métriques personnalisées sont des indicateurs de performances ou des métriques spécifiques à l’entreprise que vous définissez et collectez pour obtenir des insights qui ne sont pas couverts par les métriques standard. Pour en savoir plus sur les métriques personnalisées, consultez Métriques personnalisées dans Azure Monitor (préversion).

Champs spécifiques aux métriques personnalisées :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Mesure unique	Métrique préggrégée
name	Name	Ce champ est le nom de la métrique que vous souhaitez voir dans l’interface utilisateur et le portail Application Insights.
value	Value	Ce champ est la valeur unique pour la mesure. Il s’agit de la somme des mesures individuelles pour l’agrégation.	Pour une métrique prédéfinie, la valeur est égale à Somme.
Max	Max	Pour une métrique de mesure unique, Max est égal à Valeur.	Ce champ est la valeur maximale de la métrique agrégée. Cela ne devrait pas être utilisé pour une mesure.
Min	Min	Pour une métrique de mesure unique, Min est égal à Valeur.	Ce champ est la valeur minimale de la métrique agrégée. Cela ne devrait pas être utilisé pour une mesure.
Sum	Sum	Pour une métrique de mesure unique, Somme est égale à La valeur.	Somme de toutes les valeurs de la métrique agrégée. Cela ne devrait pas être utilisé pour une mesure.
Count	Count	Pour une métrique de mesure unique, Count est 1.	Nombre de mesures dans une période d’agrégation de 1 minute. Cela ne devrait pas être utilisé pour une mesure.

Pour obtenir la liste de tous les champs disponibles, consultez AppMetrics.

Remarque

Pour calculer la moyenne, divisez Somme par nombre.

Télémétrie d’affichage de page

La télémétrie de la vue de page est enregistrée lorsqu’un utilisateur de l’application ouvre une nouvelle page d’une application surveillée. Page, dans ce contexte, représente une unité logique définie par le développeur comme un onglet d’application ou un écran. Elle n’est pas nécessairement corrélée à une action de chargement ni d’actualisation de la page web du navigateur.

Cette distinction se comprend mieux dans le contexte des applications monopages (SPA, Single-Page Application), où le basculement entre les pages n’est pas lié à des actions portant sur les pages du navigateur. pageViews.duration est le temps nécessaire à l’application pour présenter la page à l’utilisateur.

Champs spécifiques à l’affichage de page :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
name	Name	Nom de la page qui a été consultée par l’utilisateur (par exemple, "Home" ou "Shopping Cart").
url	Url	URL complète de la page qui a été consultée. Ce champ est essentiel pour l’analyse du trafic et du comportement de l’utilisateur dans l’application.
duration	DurationMs	La durée de PageView provient de l’interface de chronométrage des performances du navigateur, PerformanceNavigationTiming.duration. Si PerformanceNavigationTiming est disponible, cette durée est utilisée. Si ce n’est pas le cas, l’interface déconseilléePerformanceTiming est utilisée et la différence entre NavigationStart et LoadEventEnd est calculée. Le développeur spécifie une valeur de durée lors de la journalisation des événements PageView personnalisés à l’aide de l’appel d’API trackPageView.

Pour obtenir la liste de tous les champs disponibles, consultez AppPageViews.

Remarque

• Par défaut, le SDK JavaScript Application Insights journalise les événements PageView uniques sur chaque action de chargement de page web du navigateur, avec pageViews.duration prenant la valeur du chronométrage du navigateur. Les développeurs peuvent étendre le suivi des événements PageView à l’aide de l’appel d’API trackPageView.

• La rétention par défaut des journaux est de 30 jours. Si vous souhaitez afficher les statistiques PageView sur une période plus longue, vous devez ajuster le paramètre.

Demande de télémétrie

La télémétrie de requête représente des informations relatives aux requêtes HTTP entrantes à votre application. Ce type de télémétrie vous permet de surveiller les performances et la réussite des services web de votre application. Un élément de télémétrie de requête représente la séquence logique d’exécution déclenchée par une requête externe à votre application. Chaque exécution de requête est identifiée par un id et une url uniques contenant tous les paramètres d’exécution.

Vous pouvez regrouper des requêtes par name logique et définir la source de cette requête. L’exécution du code peut donner success ou fail et a une certain durée (duration). Vous pouvez regrouper davantage les exécutions réussies et ayant échoué à l’aide de resultCode. L’heure de début de la télémétrie des requêtes est définie sur le niveau enveloppe. La télémétrie de requête prend en charge le modèle d'extensibilité standard en utilisant personnalisé properties et measurements.

Champs spécifiques à la demande :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
id	Id	Identificateur unique d’une instance d’appel de requête, utilisé pour la corrélation entre la requête et d’autres éléments de télémétrie. L’ID doit être globalement unique. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.
source	Source	La source est la source de la requête. Il s’agit par exemple de la clé d’instrumentation de l’appelant ou de l’adresse IP de l’appelant. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.
name	Name	Ce champ est le nom de la demande et il représente le chemin de code utilisé pour traiter la demande. Une valeur de faible cardinalité permet de mieux regrouper les requêtes. Pour les requêtes HTTP, elle représente la méthode HTTP et le modèle de chemin d’URL comme GET /values/{id} sans la valeur id réelle. Le kit de développement logiciel (SDK) web d’Application Insights envoie un nom de la requête « en l’état » concernant le respect de la casse. Le regroupement sur l’interface utilisateur est sensible à la casse, si bien que GET /Home/Index est comptabilisé séparément de GET /home/INDEX, même s’ils entraînent souvent la même exécution de contrôleur et d’action. Cela est dû au fait que les URL sont généralement sensibles à la casse. Vous souhaitez peut-être savoir si toutes les erreurs 404 ont été générées pour des URL tapées en majuscules. Vous pouvez en apprendre davantage sur la collecte de noms de requêtes par le SDK web ASP.NET dans ce billet de blog.
url	Url	L’URL est l’URL de requête avec tous les paramètres de chaîne de requête.
success	Success	Réussi indique si un appel a réussi ou échoué. Ce champ doit obligatoirement être renseigné. Lorsqu’une requête n’est pas définie explicitement sur false, elle est considérée comme ayant réussi. Si une exception ou un code de résultat d’erreur retourné a interrompu l’opération, définissez cette valeur sur false. Pour les applications web, Application Insights définit les requêtes comme ayant réussi lorsque le code de réponse est inférieur à 400 ou égal à 401. Toutefois, il arrive que ce mappage par défaut ne corresponde pas à la sémantique de l’application. Le code de réponse 404 peut indiquer « aucun enregistrement », qui peut faire partie d’un flux régulier. Il peut également indiquer un lien rompu. Pour les liens rompus, vous pouvez implémenter une logique plus avancée. Vous ne pouvez marquer les liens rompus en tant qu’échecs que lorsque ces liens sont situés sur le même site en analysant le point d’accès de l’URL. Vous pouvez aussi les marquer en tant qu’échecs lors de l’accès à partir de l’application mobile de l’entreprise. De même 301 et 302 indiquent un échec lors de l’accès à partir du client qui ne prend pas en charge la redirection. Un contenu partiellement accepté 206 peut indiquer l’échec d’une requête globale. Par exemple, un point de terminaison Application Insights peut recevoir un lot d’éléments de télémétrie sous la forme d’une seule requête. Il retourne 206 lorsque certains éléments du lot n'ont pas été traités avec succès. Une fréquence croissante de 206 indique un problème qui doit être examiné. Une logique similaire s’applique au code multi-état 207 où la réussite peut être le pire des codes de réponse distincts.
resultCode	ResultCode	Le code de réponse est le résultat d’une exécution de requête. Il s’agit du code d’état HTTP des requêtes HTTP. Cela peut être une valeur HRESULT ou un type d’exception pour les autres types de requêtes.
duration	DurationMs	La durée de la requête est au format DD.HH:MM:SS.MMMMMM. Elle doit être positive et inférieure à 1000 jours. Ce champ est obligatoire, car la télémétrie des requêtes représente l’opération avec un début et une fin.

Pour obtenir la liste de tous les champs disponibles, consultez AppRequests.

Télémétrie de trace

La télémétrie de traçage représente les instructions de traçage de type printf qui sont recherchées par texte. Log4Net, NLog et les autres entrées de fichier journal de type texte sont converties en instances de ce type. La trace ne comporte pas de mesures comme l’extensibilité.

Champs spécifiques aux traces :

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
message	Message	Message de trace.
severityLevel	SeverityLevel	Niveau de gravité des traces

Pour obtenir la liste de tous les champs disponibles, consultez AppTraces.

Remarque

Les valeurs de severityLevel sont énumérées et spécifiques à la plateforme.

Propriétés et mesures personnalisées

Propriétés personnalisées

Collection des noms-valeurs des propriétés personnalisées : cette collection est utilisée pour étendre la télémétrie standard avec des dimensions personnalisées. Des exemples incluent l'emplacement de déploiement qui a produit une télémétrie ou la propriété spécifique d'un élément de télémétrie, comme le numéro de commande.

• Longueur de clé maximale : 150
• Longueur maximale de la valeur : 8 192

Mesures personnalisées

Collection de mesures personnalisées : utilisez cette collection pour signaler des mesures nommées associées à l’élément de télémétrie. Les cas d’utilisation classiques sont :

• Taille de charge utile de télémétrie des dépendances.
• Nombre d’éléments d’attente traités par la télémétrie des requêtes.
• Temps passé par un client pour finaliser l’étape de l’Assistant afin de terminer la télémétrie d’événement.

Vous pouvez interroger les mesures personnalisées dans l’analyse des applications :

customEvents
| where customMeasurements != ""
| summarize avg(todouble(customMeasurements["Completion Time"]) * itemCount)

Remarque

• Des mesures personnalisées sont associées à l’élément de télémétrie auquel elles appartiennent. Ils sont soumis à un échantillonnage à l’aide de l’élément de télémétrie qui contient ces mesures. Pour effectuer le suivi d’une mesure dont la valeur est indépendante de tout autre type de données de télémétrie, utilisez Télémétrie des mesures.
• N’utilisez aucune valeur de chaîne pour les mesures personnalisées. Seules les valeurs numériques sont prises en charge.

Longueur de clé maximale : 150

Contexte

Chaque élément de télémétrie peut avoir un champ de contexte fortement typé. Chaque champ permet un scénario de surveillance spécifique. Utilisez la collection de propriétés personnalisées pour stocker des informations contextuelles personnalisées ou spécifiques à l’application.

Nom du champ (Application Insights)	Nom du champ (Log Analytics)	Descriptif
account_ID	user_AccountId	Dans les applications multilocataires, l’ID de compte est l’ID ou le nom du compte du locataire avec lequel l’utilisateur agit. Il est utilisé pour une segmentation supplémentaire des utilisateurs quand l’ID d’utilisateur et l’ID d’utilisateur authentifié ne suffisent pas. Il peut s’agir par exemple d’un ID d’abonnement pour le portail Azure ou un nom de blog pour une plateforme de blogs.
application_Version	AppVersion	Les informations dans les champs de contexte d’application concernent toujours l’application qui envoie les données de télémétrie. La version d’application est utilisée pour analyser la tendance des changements dans le comportement des applications et sa corrélation avec les déploiements.
appId	ResourceGUID	Identificateur unique de votre ressource Application Insights pour distinguer les données de télémétrie de différentes applications.
appName	N/A	Dans Application Insights, appName est identique à _ResourceId.
client_Browser	ClientBrowser	Nom du navigateur web utilisé par le client.
client_City	ClientCity	Ville où se trouvait le client lorsque les données de télémétrie ont été collectées (en fonction de la géolocalisation IP).
client_CountryOrRegion	ClientCountryOrRegion	Pays ou région où se trouvait le client lorsque les données de télémétrie ont été collectées (en fonction de la géolocalisation IP).
client_IP	ClientIP	Adresse IP de l’appareil client. IPv4 et IPv6 sont pris en charge. Quand des données de télémétrie sont envoyées à partir d’un service, le contexte de l’emplacement concerne l’utilisateur qui a lancé l’opération dans le service. Application Insights extrait les informations de géolocalisation à partir de l’adresse IP du client, puis la tronque. L’IP du client en elle-même ne peut pas être utilisée comme information identifiable de l’utilisateur.
client_OS	ClientOS	Indique le système d’exploitation du client qui a généré les données de télémétrie.
client_StateorProvince	ClientStateOrProvince	État ou province où se trouvait le client lorsque les données de télémétrie ont été collectées (en fonction de la géolocalisation IP).
client_Type	ClientType	Décrit le type d’appareil client qui a envoyé la télémétrie (par exemple, Browser ou PC.)
cloud_RoleInstance	AppRoleInstance	Nom de l’instance où l’application est en cours d’exécution. Par exemple, il s’agit du nom de l’ordinateur local ou du nom de l’instance pour Azure.
cloud_RoleName	AppRoleName	Nom du rôle dont l’application fait partie. Cela correspond directement au nom de rôle dans Azure. Il peut également être utilisé pour distinguer des microservices, qui font partie d’une même application.
iKey	IKey	Identificateur unique hérité utilisé pour associer des données de télémétrie à une ressource Application Insights spécifique.
itemId	N/A	Identificateur unique d’un élément de télémétrie spécifique.
itemCount	ItemCount	Nombre d’occurrences ou de nombres associés à un événement de télémétrie unique.
operation_Id	OperationId	L’identificateur unique de l’opération racine. Cet identificateur permet de regrouper les données de télémétrie pour plusieurs composants. Pour plus d’informations, consultez Corrélation de télémétrie. Une demande ou une vue de page crée l’ID d’opération. Le reste de la télémétrie définit ce champ sur la valeur correspondant à la demande ou à la vue de page qui la contient.
operation_Name	OperationName	Nom (groupe) de l’opération. Une demande ou une vue de page crée le nom de l’opération. Tous les autres éléments de télémétrie définissent ce champ sur la valeur correspondant à la demande ou à la vue de page qui la contient. Le nom d’opération est utilisé pour rechercher tous les éléments de télémétrie d’un groupe d’opérations (par exemple GET Home/Index). Cette propriété de contexte est utilisée pour répondre à des questions comme « Quelles sont les exceptions typiquement levées sur cette page ? »
operation_ParentId	ParentId	Identificateur unique du parent immédiat de l’élément de télémétrie. Pour plus d’informations, consultez Corrélation de télémétrie.
operation_SyntheticSource	SyntheticSource	Nom de la source synthétique. Certaines données de télémétrie de l’application peuvent représenter le trafic synthétique. Il peut s’agir d’un robot d’indexation web indexant le site web, de tests de disponibilité du site ou de traces des bibliothèques de diagnostic, comme le SDK Application Insights lui-même.
sdkVersion	SDKVersion	Version du Kit de développement logiciel (SDK) Application Insights qui envoie des données de télémétrie. Pour plus d’informations, consultez Version du kit de développement logiciel (SDK).
session_Id	SessionId	L’ID de session est l’instance de l’interaction de l’utilisateur avec l’application. Les informations dans les champs de contexte de session concernent toujours l’utilisateur. Quand des données de télémétrie sont envoyées à partir d’un service, le contexte de session concerne l’utilisateur qui a lancé l’opération dans le service.
user_AuthenticatedId	UserAuthenticatedId	Un ID d’utilisateur authentifié est le contraire d’un ID d’utilisateur anonyme. Ce champ représente l’utilisateur avec un nom convivial. Cet ID est collecté par défaut uniquement avec l’élément AuthenticatedUserIdTelemetryInitializer du SDK ASP.NET Framework. Utilisez le SDK Application Insights pour initialiser l’ID d’utilisateur authentifié avec une valeur qui identifie l’utilisateur de manière permanente sur les navigateurs et les appareils. De cette façon, tous les éléments de télémétrie sont attribués à cet ID unique. Cet ID permet d’interroger toutes les données de télémétrie collectées pour un utilisateur spécifique (sous réserve des configurations d’échantillonnage et du filtrage des données de télémétrie). Les identifiants d’utilisateur peuvent être croisés avec les identifiants de session pour fournir des dimensions télémétriques uniques et établir l’activité de l’utilisateur sur la durée d’une session.
user_Id	UserId	L’ID d’utilisateur anonyme représente l’utilisateur de l’application. Quand des données de télémétrie sont envoyées à partir d’un service, le contexte utilisateur concerne l’utilisateur qui a lancé l’opération dans le service. L’échantillonnage est une des techniques pour réduire la quantité de données de télémétrie collectées. L’algorithme d’échantillonnage tente de prélever des échantillons dans ou en dehors de toute la télémétrie corrélée. L’ID d’utilisateur anonyme est utilisé pour la génération du score d’échantillonnage, ce doit donc être une valeur suffisamment aléatoire. Le nombre d’ID d’utilisateur anonyme n’est pas le même que le nombre d’utilisateurs d’application uniques. Le nombre d’ID d’utilisateur anonymes est généralement plus élevé, car chaque fois que l’utilisateur ouvre votre application sur un autre appareil ou navigateur, ou nettoie les cookies de navigateur, un nouvel ID d’utilisateur anonyme unique est alloué. Ce calcul peut entraîner la prise en compte des mêmes utilisateurs physiques plusieurs fois. Les identifiants d’utilisateur peuvent être croisés avec les identifiants de session pour fournir des dimensions télémétriques uniques et établir l’activité de l’utilisateur sur la durée d’une session. L’utilisation d’un ID d’utilisateur anonyme pour stocker un nom d’utilisateur n’est pas une bonne utilisation du champ. Utilisez un ID d’utilisateur authentifié.
_ResourceId	_ResourceId	ID de ressource Azure complet du composant Application Insights, qui inclut l’abonnement, le groupe de ressources et le nom de la ressource.

Étapes suivantes

• Consulter les questions fréquentes (FAQ) : FAQ sur le modèle de données de télémétrie
• Découvrez quelles plateformes sont prises en charge par Application Insights.
• Découvrez comment collecter des données de télémétrie personnalisées à l’aide de la distribution OpenTelemetry Azure Monitor.
• Découvrez comment utiliser l’API Application Insights pour les événements et les métriques personnalisés.
• Découvrez comment étendre et filtrer la télémétrie.
• Découvrez comment utiliser l’échantillonnage pour réduire la quantité de données de télémétrie en fonction du modèle de données.