Suppressing specific instrumentation

Estás viendo la versión en inglés de está página porque aún no ha sido traducida. ¿Te interesa ayudar? Mira en Contribuir.

Disabling the agent entirely

System property: otel.javaagent.enabled

Environment variable: OTEL_JAVAAGENT_ENABLED

Description: Set the value to false to disable the agent entirely.

Enable only specific instrumentation

You can disable all default auto instrumentation and selectively re-enable individual instrumentation. This may be desirable to reduce startup overhead or to have more control of which instrumentation is applied.

System property: otel.instrumentation.common.default-enabled

Environment variable: OTEL_INSTRUMENTATION_COMMON_DEFAULT_ENABLED

Description: Set to false to disable all instrumentation in the agent.

System property: otel.instrumentation.[name].enabled

Environment variable: OTEL_INSTRUMENTATION_[NAME]_ENABLED

Description: Set to true to enable each desired instrumentation individually.

Advertencia

Some instrumentation relies on other instrumentation to function properly. When selectively enabling instrumentation, be sure to enable the transitive dependencies too. Determining this dependency relationship is left as an exercise to the user. This is considered advanced usage and is not recommended for most users.

Enable manual instrumentation only

You can suppress all auto instrumentations but have support for manual instrumentation with @WithSpan and normal API interactions by using -Dotel.instrumentation.common.default-enabled=false -Dotel.instrumentation.opentelemetry-api.enabled=true -Dotel.instrumentation.opentelemetry-instrumentation-annotations.enabled=true

Suppressing specific agent instrumentation

You can suppress agent instrumentation of specific libraries.

System property: otel.instrumentation.[name].enabled

Environment variable: OTEL_INSTRUMENTATION_[NAME]_ENABLED

Description: Set to false to suppress agent instrumentation of specific libraries, where [name] is the corresponding instrumentation name:

Library/Framework	Instrumentation name
Additional methods tracing	`methods`
Additional tracing annotations	`external-annotations`
Activej HTTP	`activej-http`
Avaje Jex	`avaje-jex`
Akka Actor	`akka-actor`
Akka HTTP	`akka-http`
Alibaba Druid	`alibaba-druid`
Apache Axis2	`axis2`
Apache Camel	`camel`
Apache Cassandra	`cassandra`
Apache CXF	`cxf`
Apache DBCP	`apache-dbcp`
Apache Dubbo	`apache-dubbo`
Apache ElasticJob	`apache-elasticjob`
Apache Geode	`geode`
Apache HttpAsyncClient	`apache-httpasyncclient`
Apache HttpClient	`apache-httpclient`
Apache Iceberg	`iceberg`
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 API client	`elasticsearch-api-client`
Elasticsearch client	`elasticsearch-transport`
Elasticsearch REST client	`elasticsearch-rest`
Failsafe	`failsafe`
Finagle	`finagle-http`
Google Guava	`guava`
Google HTTP client	`google-http-client`
Google Web Toolkit	`gwt`
Grails	`grails`
GraphQL Java	`graphql-java`
GRPC	`grpc`
Helidon	`helidon`
Hibernate	`hibernate`
Hibernate Reactive	`hibernate-reactive`
HikariCP	`hikaricp`
InfluxDB	`influxdb`
Java HTTP Client	`java-http-client`
Java HTTP Server	`java-http-server`
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`
JFinal	`jfinal`
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`
NATS Client	`nats`
Netflix Hystrix	`hystrix`
Netty	`netty`
OkHttp