# Suppression d'instrumentation spécifique ## Désactivation complète de l'agent {#disabling-the-agent-entirely}
System property: otel.javaagent.enabled Environment variable: OTEL_JAVAAGENT_ENABLED
Description: Définissez la valeur à `false` pour désactiver complètement l'agent.
## Activer uniquement une instrumentation spécifique {#enable-only-specific-instrumentation} 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.
System property: otel.instrumentation.common.default-enabled Environment variable: OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED
Description: Définissez à `false` pour désactiver toute l'instrumentation dans l'agent.
System property: otel.instrumentation.[name].enabled Environment variable: OTEL_INSTRUMENTATION_[NAME]_ENABLED
Description: Définissez à `true` pour activer chaque instrumentation souhaitée individuellement.
## Activer uniquement l'instrumentation manuelle {#enable-manual-instrumentation-only} 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 {#suppressing-specific-agent-instrumentation} Vous pouvez supprimer l'instrumentation de l'agent pour des bibliothèques spécifiques.
System property: otel.instrumentation.[name].enabled Environment variable: OTEL_INSTRUMENTATION_[NAME]_ENABLED
Description: Définissez à `false` pour supprimer l'instrumentation de l'agent pour des bibliothèques spécifiques, où `[name]` est le nom d'instrumentation correspondant :
| Bibliothèque/Framework | Nom de l'instrumentation | | ------------------------------------------------ | ------------------------------------------- | | Traces de méthodes supplémentaires | `methods` | | Annotations supplémentaires des traces | `external-annotations` | | Akka Actor | `akka-actor` | | Akka HTTP | `akka-http` | | Apache Axis2 | `axis2` | | Apache Camel | `camel` | | Apache Cassandra | `cassandra` | | Apache CXF | `cxf` | | Apache DBCP | `apache-dbcp` | | Apache Dubbo | `apache-dubbo` | | Apache Geode | `geode` | | Apache HttpAsyncClient | `apache-httpasyncclient` | | Apache HttpClient | `apache-httpclient` | | Apache Kafka | `kafka` | | Apache MyFaces | `jsf-myfaces` | | Apache Pekko Actor | `pekko-actor` | | Apache Pekko HTTP | `pekko-http` | | Apache Pulsar | `pulsar` | | Apache RocketMQ | `rocketmq-client` | | Apache Shenyu | `apache-shenyu` | | Apache Struts 2 | `struts` | | Apache Tapestry | `tapestry` | | Apache Tomcat | `tomcat` | | Apache Wicket | `wicket` | | Armeria | `armeria` | | AsyncHttpClient (AHC) | `async-http-client` | | AWS Lambda | `aws-lambda` | | AWS SDK | `aws-sdk` | | Azure SDK | `azure-core` | | Clickhouse Client | `clickhouse` | | Couchbase | `couchbase` | | C3P0 | `c3p0` | | Dropwizard Views | `dropwizard-views` | | Dropwizard Metrics | `dropwizard-metrics` | | Eclipse Grizzly | `grizzly` | | Eclipse Jersey | `jersey` | | Eclipse Jetty | `jetty` | | Eclipse Jetty HTTP Client | `jetty-httpclient` | | Eclipse Metro | `metro` | | Eclipse Mojarra | `jsf-mojarra` | | Eclipse Vert.x HttpClient | `vertx-http-client` | | Eclipse Vert.x Kafka Client | `vertx-kafka-client` | | Eclipse Vert.x Redis Client | `vertx-redis-client` | | Eclipse Vert.x RxJava | `vertx-rx-java` | | Eclipse Vert.x SQL Client | `vertx-sql-client` | | Eclipse Vert.x Web | `vertx-web` | | Elasticsearch client | `elasticsearch-transport` | | Elasticsearch REST client | `elasticsearch-rest` | | Finagle | `finagle-http` | | Google Guava | `guava` | | Google HTTP client | `google-http-client` | | Google Web Toolkit | `gwt` | | Grails | `grails` | | GraphQL Java | `graphql-java` | | GRPC | `grpc` | | Hibernate | `hibernate` | | Hibernate Reactive | `hibernate-reactive` | | HikariCP | `hikaricp` | | InfluxDB | `influxdb` | | Java HTTP Client | `java-http-client` | | Java `HttpURLConnection` | `http-url-connection` | | Java JDBC | `jdbc` | | Java JDBC `DataSource` | `jdbc-datasource` | | Java RMI | `rmi` | | Java Runtime | `runtime-telemetry` | | Java Servlet | `servlet` | | java.util.concurrent | `executors` | | java.util.logging | `java-util-logging` | | Javalin | `javalin` | | JAX-RS (Client) | `jaxrs-client` | | JAX-RS (Server) | `jaxrs` | | JAX-WS | `jaxws` | | JBoss Logging Appender | `jboss-logmanager-appender` | | JBoss Logging MDC | `jboss-logmanager-mdc` | | JMS | `jms` | | Jodd HTTP | `jodd-http` | | JSP | `jsp` | | K8s Client | `kubernetes-client` | | Ktor | `ktor` | | kotlinx.coroutines | `kotlinx-coroutines` | | Log4j Appender | `log4j-appender` | | Log4j MDC (1.x) | `log4j-mdc` | | Log4j Context Data (2.x) | `log4j-context-data` | | Logback Appender | `logback-appender` | | Logback MDC | `logback-mdc` | | Micrometer | `micrometer` | | MongoDB | `mongo` | | MyBatis | `mybatis` | | Netflix Hystrix | `hystrix` | | Netty | `netty` | | OkHttp | `okhttp` | | OpenLiberty | `liberty` | | Annotations de l'extension OpenTelemetry | `opentelemetry-extension-annotations` | | Annotations de l'instrumentation OpenTelemetry | `opentelemetry-instrumentation-annotations` | | OpenTelemetry API | `opentelemetry-api` | | Oracle UCP | `oracle-ucp` | | OSHI (Operating System and Hardware Information) | `oshi` | | Play Framework | `play` | | Play WS HTTP Client | `play-ws` | | Quarkus | `quarkus` | | Quartz | `quartz` | | R2DBC | `r2dbc` | | RabbitMQ Client | `rabbitmq` | | Ratpack | `ratpack` | | ReactiveX RxJava | `rxjava` | | Reactor | `reactor` | | Reactor Kafka | `reactor-kafka` | | Reactor Netty | `reactor-netty` | | Redis Jedis | `jedis` | | Redis Lettuce | `lettuce` | | Rediscala | `rediscala` | | Redisson | `redisson` | | Restlet | `restlet` | | Scala ForkJoinPool | `scala-fork-join` | | Spark Web Framework | `spark` | | Spring Batch | `spring-batch` | | Spring Core | `spring-core` | | Spring Data | `spring-data` | | Spring JMS | `spring-jms` | | Spring Integration | `spring-integration` | | Spring Kafka | `spring-kafka` | | Spring RabbitMQ | `spring-rabbit` | | Spring RMI | `spring-rmi` | | Spring Scheduling | `spring-scheduling` | | Spring Web | `spring-web` | | Spring WebFlux | `spring-webflux` | | Spring Web MVC | `spring-webmvc` | | Spring Web Services | `spring-ws` | | Spymemcached | `spymemcached` | | Tomcat JDBC | `tomcat-jdbc` | | Twilio SDK | `twilio` | | Twitter Finatra | `finatra` | | Undertow | `undertow` | | Vaadin | `vaadin` | | Vibur DBCP | `vibur-dbcp` | | XXL-JOB | `xxl-job` | | ZIO | `zio` | **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 {#suppressing-controller-andor-view-spans} Certaines instrumentations (par exemple, l'instrumentation Spring Web MVC) produisent des spans [SpanKind.Internal](/docs/specs/otel/trace/api/#spankind) 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](/docs/specs/otel/trace/api/#spankind).
System property: otel.instrumentation.common.experimental.controller-telemetry.enabled Environment variable: OTEL_INSTRUMENTATION_COMMON_EXPERIMENTAL_CONTROLLER_TELEMETRY_ENABLED
Default: false
Description: Définissez à `true` pour activer la télémétrie du contrôleur.
System property: otel.instrumentation.common.experimental.view-telemetry.enabled Environment variable: OTEL_INSTRUMENTATION_COMMON_EXPERIMENTAL_VIEW_TELEMETRY_ENABLED
Default: false
Description: Définissez à `true` pour activer la télémétrie de la vue.
## Comportement de l'instrumentation dans la suppression de span {#instrumentation-span-suppression-behavior} 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 :
System property: otel.instrumentation.experimental.span-suppression-strategy Environment variable: OTEL_INSTRUMENTATION_EXPERIMENTAL_SPAN_SUPPRESSION_STRATEGY
Description: La stratégie de suppression de span de l'agent Java. Les 3 stratégies suivantes sont supportées : - `semconv` : L'agent supprimera les conventions sémantiques en double. C'est le comportement par défaut de l'agent Java. - `span-kind` : L'agent supprimera les spans de même type (sauf `INTERNAL`). - `none` : L'agent ne supprimera rien du tout. **Nous ne recommandons pas d'utiliser cette option pour autre chose que le débogage, car elle génère beaucoup de données de télémétrie en double**.
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.