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

Application Insights envoie la télémétrie à partir de votre application web sur le Portail Azure afin que vous puissiez analyser le niveau de performance et l’utilisation de votre application. Le modèle de télémétrie est normalisé afin qu’il soit possible de créer une plateforme et un monitoring indépendant du langage.

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

Les types de télémétrie suivants sont utilisés pour surveiller l’exécution de votre application. Le kit de développement logiciel (SDK) Application Insights de l’infrastructure d’application web collecte automatiquement ces trois types :

• Requête : généré pour enregistrer une requête reçue par votre application. Par exemple, le Kit de développement logiciel (SDK) web Application Insights génère automatiquement un élément de télémétrie de demande pour chaque demande HTTP reçue par votre application web.

  Une opération désigne les threads d’exécution qui traitent une requête. Vous pouvez également écrire du code pour surveiller d’autres types d’opération, comme une « sortie de veille » dans une tâche ou une fonction web qui traite périodiquement des données. Chaque opération a un ID. L’ID peut être utilisé pour regrouper toutes les données de télémétrie générées lors du traitement de la requête par votre application. Chaque opération réussit ou échoue et a une certaine durée.

• Exception : représente normalement une exception qui provoque l’échec d’une opération.

• Dépendance : représente un appel depuis votre application vers un service ou un stockage externe, comme une API REST ou SQL. Dans ASP.NET, les appels de dépendance vers SQL sont définis par System.Data. Les appels vers les points de terminaison HTTP sont définis par System.Net.

Application Insights fournit trois types de données pour la télémétrie personnalisée :

• Trace : utilisé directement ou via un adaptateur pour implémenter la journalisation des diagnostics à l’aide d’une infrastructure d’instrumentation qui vous est familière, comme Log4Net ou System.Diagnostics.
• Événement : normalement utilisé pour capturer l’interaction de l’utilisateur avec votre service afin d’analyser les modèles d’utilisation.
• Métrique : utilisé pour générer des rapports sur les mesures scalaires périodiques.

Chaque élément de télémétrie peut définir les informations de contexte comme la version de l’application ou l’ID de session utilisateur. Le contexte est un ensemble de champs fortement typés qui débloque certains scénarios. Quand la version de l’application est correctement initialisée, Application Insights peut détecter les nouveaux modèles de comportement de l’application en corrélation avec un redéploiement.

Vous pouvez utiliser l’ID de session pour calculer un impact sur une panne ou un problème sur les utilisateurs. Calculer des nombres distincts de valeurs d’ID de session pour certaines dépendances en échec, suivis des erreurs ou exceptions critiques vous donne une bonne compréhension d’un impact.

Le modèle de télémétrie d’Application Insights définit un moyen de mettre en corrélation la télémétrie et l’opération dont elle fait partie. Par exemple, une requête peut appeler SQL Database et enregistrer les informations de diagnostic. Vous pouvez définir le contexte de corrélation pour relier ces éléments de télémétrie aux données de télémétrie de la demande.

Améliorations du schéma

Le modèle de données d’Application Insights est certes simple et basique, mais suffisamment puissant pour modéliser les données de télémétrie de votre application. 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.

Pour signaler des problèmes de modèles de données ou de schémas avec des suggestions, utilisez notre référentiel GitHub.

Requête

Un élément de télémétrie de requête dans Application Insights 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 duration et a une certain durée (fail). 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 des requêtes prend en charge le modèle d’extensibilité standard en utilisant les properties et measurements personnalisés.

Notes

Le support de l’ingestion de clé d’instrumentation prendra fin le 31 mars 2025. L’ingestion de clé d’instrumentation continuera de fonctionner, mais nous ne fournirons plus de mises à jour ni de support pour la fonctionnalité. Passez aux chaînes de connexion pour tirer parti des nouvelles fonctionnalités.

Nom

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.

Longueur maximale : 1 024 caractères

id

L’ID est l’identificateur d’une instance d’appel de requête. C’est 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.

Longueur maximale : 128 caractères

URL

L’URL est l’URL de requête avec tous les paramètres de chaîne de requête.

Longueur maximale : 2 048 caractères

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.

Longueur maximale : 1 024 caractères

Duration

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.

Response code

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.

Longueur maximale : 1 024 caractères

Succès

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.

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

• 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)

Notes

• 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

Dépendance

La télémétrie des dépendances (dans Application Insights) représente une interaction du composant supervisé avec un composant distant tel que SQL ou un point de terminaison HTTP.

Nom

Ce champ est le 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.

id

ID est l’identificateur d’une instance d’appel de dépendance. Il est utilisé pour la corrélation avec l’élément de télémétrie de demande correspondant à cet appel de dépendance. Pour plus d’informations, consultez l’article Corrélation de télémétrie dans Application Insights.

Données

Ce champ est la commande lancée par cet appel de dépendance. Exemples : instruction SQL et URL HTTP avec tous les paramètres de requête.

Type

Ce champ est le 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.

Cible

Ce champ est 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.

Duration

La durée de la demande est au format DD.HH:MM:SS.MMMMMM. Elle doit être inférieure à 1000 jours.

Code de résultat

Ce champ est le code résultat d’un appel de dépendance. Exemples : code d’erreur SQL et code d’état HTTP.

Succès

Ce champ est l’indication d’un appel réussi ou infructueux.

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

• 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)

Notes

• 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

Exception

Dans Application Insights, une instance d’exception représente une exception prise en charge ou non prise en charge générée pendant l’exécution de l’application supervisée.

ID du problème

L’ID du problème identifie l’endroit où l’exception a été levée dans le code. Il est utilisé pour le regroupement d’exceptions. Généralement, une combinaison de type d’exception et une fonction de la pile des appels.

Longueur maximale : 1 024 caractères

Niveau de gravité

Ce champ est le niveau de gravité de la trace. La valeur peut être Verbose, Information, Warning, Error ou Critical.

Détails de l’exception

(À développer)

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

• 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)

Notes

• 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

Trace

La télémétrie des traces dans Application Insights représente des instructions de traces de type printf qui font l’objet de recherches textuelles. 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é.

Message

Message de trace.

Longueur maximale : 32 768 caractères

Niveau de gravité

Niveau de gravité de trace.

Valeurs : Verbose, Information, Warning, Error et Critical

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

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

Événement

Vous pouvez créer des éléments de télémétrie (dans Application Insights) 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.

Sur le plan sémantique, les événements ne sont pas forcément corrélés aux requêtes. Si la télémétrie des événements est utilisée correctement, elle est plus importante que les requêtes ou les traces. Les événements représentent la télémétrie métier et doivent faire l’objet d’un échantillonnage distinct, moins agressif.

Nom

Nom d’événement : pour permettre le regroupement approprié et des mesures 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.

Longueur maximale : 512 caractères

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

• 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)

Notes

• 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

Métrique

Application Insights prend en charge deux types de télémétrie de métrique : une seule mesure et une métrique prédéfinie. La mesure unique consiste simplement dans un nom et une valeur. La mesure pré-agrégée spécifie les valeurs minimale et maximale de la mesure dans l’intervalle d’agrégation, ainsi que son écart standard.

La télémétrie des mesures pré-agrégées suppose que cette période d’agrégation est d’une minute.

Application Insights prend en charge plusieurs noms de métriques connus. Ces métriques sont placées dans la table performanceCounters.

Le tableau suivant montre les métriques qui représentent les compteurs système et de processus.

Nom .NET	Nom sans plateforme spécifiée	Description
\Processor(_Total)\% Processor Time	Travail en cours...	Nombre total de processeurs de l’ordinateur.
\Memory\Available Bytes	Travail en cours...	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	Travail en cours...	Processeur du processus hébergeant l’application.
\Process(??APP_WIN32_PROC??)\Private Bytes	Travail en cours...	Mémoire utilisée par le processus hébergeant l’application.
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec	Travail en cours...	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	Travail en cours...	Taux de demandes traitées par une application.
\.NET CLR Exceptions(??APP_CLR_PROC??)\# of Exceps Thrown / sec	Travail en cours...	Taux d’exceptions levées par une application.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Request Execution Time	Travail en cours...	Durée moyenne d’exécution des requêtes.
\ASP.NET Applications(??APP_W3SVC_PROC??)\Requests In Application Queue	Travail en cours...	Nombre de requêtes en attente de traitement dans une file d’attente.

Pour plus d’informations sur l’API REST Métriques, consultez Métriques – Get.

Nom

Ce champ est le nom de la métrique que vous souhaitez voir dans l’interface utilisateur et le portail Application Insights.

Valeur

Ce champ est la valeur unique pour la mesure. Il s’agit de la somme des mesures individuelles pour l’agrégation.

Count

Ce champ est la pondération métrique de la métrique agrégée. Il ne doit pas être défini pour une mesure.

Min

Ce champ est la valeur minimale de la métrique agrégée. Il ne doit pas être défini pour une mesure.

Max

Ce champ est la valeur maximale de la métrique agrégée. Il ne doit pas être défini pour une mesure.

Écart type

Ce champ est l’écart type de la métrique agrégée. Il ne doit pas être défini pour une mesure.

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.

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. Les emplacements de déploiement qui génèrent la télémétrie ou des éléments de télémétrie de propriété spécifique comme des numéros de commande sont des exemples.

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

PageView

La télémétrie PageView (dans Application Insights) est journalisée lorsqu’un utilisateur d’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.

Notes

• Par défaut, le SDK 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.

Mesurer browserTiming dans Application Insights

Les navigateurs modernes exposent des mesures pour les actions de chargement de page avec l’API Performance. Application Insights simplifie ces mesures en regroupant les minutages associés dans les métriques de navigateur standard, comme défini par ces définitions de temps de traitement :

• Client <--> DNS : le client accède au DNS pour résoudre le nom d’hôte du site web. Le DNS répond avec l’adresse IP.

• Client <--> serveur web : le client établit une liaison TCP, puis TLS avec le serveur web.

• Client <--> serveur web : le client envoie la charge utile de la demande, attend que le serveur exécute la demande et reçoit le premier paquet de réponse.

• Client <-- serveur web : le client reçoit le reste des octets de charge utile de la réponse du serveur web.

• Client : le client dispose désormais d’une charge utile de réponse complète. Il doit restituer le contenu dans le navigateur et charger le DOM.

• browserTimings/networkDuration = #1 + #2

• browserTimings/sendDuration = #3

• browserTimings/receiveDuration = #4

• browserTimings/processingDuration = #5

• browsertimings/totalDuration = #1 + #2 + #3 + #4 + #5

• pageViews/duration

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

Context

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.

Version de l’application

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.

Longueur maximale : 1,024

Adresse IP du client

Ce champ est l’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 d’emplacement géographique de l’adresse IP du client puis les tronque. L’IP du client en elle-même ne peut pas être utilisée comme information identifiable de l’utilisateur.

Longueur maximale : 46

Type d’appareil

À l’origine, ce champ était utilisé pour indiquer le type de l’appareil utilisé par l’utilisateur de l’application. Aujourd’hui, il est utilisé principalement pour distinguer la télémétrie JavaScript avec le type d’appareil Browser de la télémétrie côté serveur avec le type d’appareil PC.

Longueur maximale : 64

ID de l'opération

Ce champ est 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.

Longueur maximale : 128

ID d’opération parent

Ce champ est l’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.

Longueur maximale : 128

Nom d’opération

Ce champ est le 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 généralement levées dans cette page ? »

Longueur maximale : 1,024

Source synthétique de l’opération

Ce champ est le 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.

Longueur maximale : 1,024

ID de la session

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.

Longueur maximale : 64

Identifiant utilisateur anonyme

L’ID d’utilisateur anonyme (User.Id) 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.

Notes

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

Longueur maximale : 128

Identifiant utilisateur authentifié

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.

Longueur maximale : 1,024

ID de compte

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.

Longueur maximale : 1,024

Rôle cloud

Ce champ est le nom du rôle dont l’application fait partie. Il est mappé 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.

Longueur maximale : 256

Instance de rôle cloud

Ce champ est le nom de l’instance où l’application s’exécute. Par exemple, il s’agit du nom de l’ordinateur local ou du nom de l’instance pour Azure.

Longueur maximale : 256

Interne : Version du SDK

Pour plus d’informations, consultez Version du kit de développement logiciel (SDK).

Longueur maximale : 64

Interne : Nom du nœud

Ce champ représente le nom du nœud utilisé pour la facturation. Utilisez-le pour remplacer la détection standard de nœuds.

Longueur maximale : 256

Forum aux questions

Cette section fournit des réponses aux questions fréquentes.

Comment puis-je mesurer l’impact d’une campagne de surveillance ?

La télémétrie PageView inclut une URL et vous pouvez analyser le paramètre UTM en tirant parti d’une fonction regex dans Kusto.

Ces données peuvent parfois être manquantes ou inexactes si l’utilisateur ou l’entreprise désactive l’envoi de l’agent utilisateur dans les paramètres du navigateur. Les expressions régulières d’UA Parser peuvent ne pas inclure toutes les informations sur l’appareil. Ou bien Application Insights n’a peut-être pas intégré les dernières mises à jour.

Pourquoi une mesure personnalisée réussit-elle sans erreur, sans pour autant que le journal s’affiche ?

Cela peut se produire si vous utilisez des valeurs de chaîne. Seules des valeurs numériques fonctionnent avec des mesures personnalisées.

Étapes suivantes

Découvrez comment utiliser l’API Application Insights pour les événements et les mesures personnalisés, dont :

• Télémétrie de requête personnalisée
• Télémétrie des dépendances personnalisées
• Télémétrie de trace personnalisées
• Télémétrie d’événement personnalisées
• Télémétrie de métrique personnalisée

Configurer le suivi des dépendances pour :

• .NET
• Java

Pour en savoir plus :

• Découvrez quelles plateformes sont prises en charge par Application Insights.
• Découvrez la configuration de la collection de propriétés de contexte standard.
• Découvrir les journaux de trace .NET dans Application Insights.
• Découvrir les journaux de trace Java dans Application Insights.
• Apprenez-en plus sur l’intégration Azure Functions incorporé à Azure Application Insights pour superviser des exécutions de fonction.
• Découvrez comment configurer une application ASP.NET Core avec Application Insights.
• Découvrez comment diagnostiquer les exceptions dans vos applications web avec Application Insights.
• Découvrez comment étendre et filtrer la télémétrie.
• Utilisez l’échantillonnage pour réduire la quantité de données de télémétrie basées sur le modèle de données.