Instrumenter une application pour le monitoring

Au niveau de base, l'« instrumentation » permet simplement à une application de capturer des données de télémétrie. Il existe deux méthodes pour instrumenter votre application :

• Instrumentation automatique (autoinstrumentation)
• Instrumentation manuelle

L’autoinstrumentation permet la collecte de données de télémétrie par le biais de la configuration sans toucher le code de l’application. Bien qu’il soit plus pratique, il a tendance à être moins configurable. Il n’est pas disponible dans toutes les langues. Consultez les environnements et les langages pris en charge par l’autoinstrumentation. Lorsque l’autoinstrumentation est disponible, il s’agit du moyen le plus simple d’activer Azure Monitor Application Insights.

L’instrumentation manuelle code sur l’API Application Insights ou OpenTelemetry. Dans le contexte d’un utilisateur, il fait généralement référence à l’installation d’un SDK spécifique à une langue dans une application. Cela signifie que vous devez gérer les mises à jour de la dernière version du package par vous-même. Vous pouvez utiliser cette option si vous devez effectuer des appels de dépendance personnalisés ou des appels d’API qui ne sont pas capturés par défaut avec l’autoinstrumentation. Il existe deux options pour l’instrumentation manuelle :

• SDK Application Insights
• Distributions OpenTelemetry Azure Monitor.

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 SDK est hébergée sur GitHub. Pour plus d’informations, consultez Version du SDK.

Activer via OpenTelemetry

Microsoft a travaillé avec les parties prenantes du projet à partir de deux projets de télémétrie open source précédemment populaires, OpenCensus et OpenTracing. Ensemble, nous avons aidé à créer un projet unique, OpenTelemetry. OpenTelemetry inclut des contributions de tous les principaux fournisseurs de gestion des performances des applications et du cloud (APM) et vit dans cloud Native Computing Foundation (CNCF). Microsoft est membre Platinum du CNCF.

Certains termes hérités dans Application Insights sont déroutants en raison de la convergence du secteur sur OpenTelemetry. Le tableau suivant met en évidence ces différences. Les termes OpenTelemetry remplacent les termes Application Insights.