Instrumenter une application pour le monitoring
À un niveau de base, « l’instrumentation » consiste simplement à permettre à une application de capturer la télémétrie. Il existe deux méthodes pour instrumenter votre application :
- Instrumentation automatique (auto-instrumentation)
- Instrumentation manuelle
L’auto-instrumentation permet de collecter des données de télémétrie via une configuration sans toucher au code de l’application. Bien qu’il s’agisse d’une méthode plus pratique, elle a tendance à être moins configurable. Elle n’est pas non plus disponible dans toutes les langues. Consultez Langages et environnements pris en charge par l’auto-instrumentation. Lorsque l’auto-instrumentation est disponible, il s’agit du moyen le plus simple d’activer Azure Monitor Application Insights.
L’instrumentation manuelle consiste à coder sur Application Insights ou l’API OpenTelemetry. Dans le contexte d’un utilisateur, cela fait généralement référence à l’installation d’un kit SDK spécifique au langage dans une application. Cela signifie que vous devez gérer vous-mêmes les mises à jour vers la dernière version du package. Vous pouvez utiliser cette option si vous devez effectuer des appels de dépendance ou des appels d’API personnalisés qui ne sont pas capturés par défaut avec l’instrumentation automatique. Il existe deux options pour l’instrumentation manuelle :
Activation via les SDK Application Insights
Vous n’avez besoin d’installer le SDK Application Insights que dans les circonstances suivantes :
- Vous avez besoin d’événements et de métriques personnalisés
- Vous avez besoin de contrôler le flux de télémétrie
- L’instrumentation automatique n’est pas disponible (généralement en raison de limitations linguistiques ou de plateforme)
Pour utiliser le SDK, vous installez un petit package d’instrumentation dans votre application et vous instrumentez ensuite l’application web, tous les composants en arrière-plan et JavaScript dans les pages web. L’application et ses composants n’ont pas besoin d’être hébergés dans Azure. L’instrumentation supervise votre application et dirige les données de télémétrie vers une ressource Application Insights en utilisant un jeton unique.
Une liste des versions et noms du kit de développement logiciel (SDK) est hébergée sur GitHub. Pour plus d’informations, consultez Version du SDK.
Activer via OpenTelemetry
Microsoft a collaboré avec les parties prenantes de deux projets de télémétrie open source populaires, OpenCensus et OpenTracing. Ensemble, nous avons contribué à la création d’un seul projet, OpenTelemetry. OpenTelemetry inclut les contributions de tous les principaux fournisseurs de solutions cloud et de gestion des performances des applications (APM). Il s’inscrit dans le cadre de la Cloud Native Computing Foundation (CNCF). Microsoft est un membre Platinum de la CNCF.
Certains termes hérités dans Application Insights prêtent à confusion en raison de la convergence du secteur par rapport à OpenTelemetry. Le tableau suivant met en évidence ces différences. Les termes OpenTelemetry remplacent les termes d’Application Insights.
| Application Insights | OpenTelemetry |
|---|---|
| Autocollectors | Bibliothèques d’instrumentation |
| Canal | Exportateur |
| Sans code/basé sur un agent | Auto-instrumentation |
| Traces | Journaux d’activité |
| Demandes | Étendues de serveur |
| Les dépendances | Autres types d’étendues (client, interne, etc.) |
| ID d’opération | ID de trace |
| ID ou ID parent de l’opération | ID d’étendue |