Suppression d'instrumentation spécifique

Désactivation complète de l’agent

Activer uniquement une instrumentation spécifique

Vous pouvez désactiver toute l’instrumentation automatique par défaut et réactiver sélectivement les instrumentations individuelles. Cela peut être souhaitable pour réduire la surcharge au démarrage ou pour avoir plus de contrôle sur l’instrumentation appliquée.

Activer uniquement l’instrumentation manuelle

Vous pouvez supprimer toutes les instrumentations automatiques mais avoir le support pour l’instrumentation manuelle avec @WithSpan et les interactions API normales en utilisant -Dotel.instrumentation.common.default-enabled=false -Dotel.instrumentation.opentelemetry-api.enabled=true -Dotel.instrumentation.opentelemetry-instrumentation-annotations.enabled=true

Suppression de l’instrumentation spécifique de l’agent

Vous pouvez supprimer l’instrumentation de l’agent pour des bibliothèques spécifiques.

Note: Lors de l’utilisation de variables d’environnement, les tirets (-) doivent être convertis en tirets bas (_). Par exemple, pour supprimer les traces de la bibliothèque akka-actor, définissez OTEL_INSTRUMENTATION_AKKA_ACTOR_ENABLED à false.

Suppression des spans de contrôleur et/ou de vue

Certaines instrumentations (par exemple, l’instrumentation Spring Web MVC) produisent des spans SpanKind.Internal pour capturer l’exécution du contrôleur et/ou de la vue. Ces spans peuvent être supprimés en utilisant les paramètres de configuration ci-dessous, sans supprimer l’instrumentation entière ce qui désactiverait également la capture par l’instrumentation de http.route et le nom de span associé sur le span parent SpanKind.Server.

Comportement de l’instrumentation dans la suppression de span

Certaines bibliothèques que cet agent instrumente utilisent à leur tour des bibliothèques de niveau inférieur, qui sont également instrumentées. Cela entraînerait normalement des spans imbriqués contenant des données de télémétrie en double. Par exemple :

• Les spans produits par l’instrumentation du client HTTP Reactor Netty auraient des spans de client HTTP en double produits par l’instrumentation Netty ;
• Les spans Dynamo DB produits par l’instrumentation du SDK AWS auraient des spans de client HTTP enfants produits par sa bibliothèque de client HTTP interne (qui est également instrumentée) ;
• Les spans produits par l’instrumentation Tomcat auraient des spans de serveur HTTP en double produits par l’instrumentation générique de l’API Servlet.

L’agent Java empêche ces situations en détectant et en supprimant les spans imbriqués qui dupliquent les données de télémétrie. Le comportement de suppression peut être configuré en utilisant l’option de configuration suivante :

Par exemple, supposons que nous instrumentons un client de base de données qui utilise en interne le client HTTP Reactor Netty ; qui à son tour utilise Netty.

L’utilisation de la stratégie de suppression semconv par défaut entraînerait 2 spans CLIENT imbriqués :

• Span CLIENT avec des attributs sémantiques de client de base de données émis par l’instrumentation du client de base de données ;
• Span CLIENT avec des attributs sémantiques de client HTTP émis par l’instrumentation Reactor Netty.

L’instrumentation Netty serait supprimée, car elle duplique l’instrumentation du client HTTP Reactor Netty.

L’utilisation de la stratégie de suppression span-kind n’entraînerait qu’un seul span :

• Span CLIENT avec des attributs sémantiques de client de base de données émis par l’instrumentation du client de base de données.

Les instrumentations Reactor Netty et Netty seraient supprimées, car elles émettent également des spans CLIENT.

Enfin, l’utilisation de la stratégie de suppression none entraînerait 3 spans :

• Span CLIENT avec des attributs sémantiques de client de base de données émis par l’instrumentation du client de base de données ;
• Span CLIENT avec des attributs sémantiques de client HTTP émis par l’instrumentation Reactor Netty ;
• Span CLIENT avec des attributs sémantiques de client HTTP émis par l’instrumentation Netty.