- はじめに
- エージェント
- インテグレーション
- Watchdog
- イベント
- ダッシュボード
- モバイルアプリケーション
- インフラストラクチャー
- サーバーレス
- メトリクス
- ノートブック
- アラート設定
- APM & Continuous Profiler
- CI Visibility
- RUM & セッションリプレイ
- データベース モニタリング
- ログ管理
- セキュリティプラットフォーム
- Synthetic モニタリング
- ネットワークモニタリング
- 開発者
- API
- アカウントの管理
- データセキュリティ
- ヘルプ
The Java Datadog Trace library is open source - view the GitHub repository for more information.
Datadog officially supports the Java JRE 1.7 and higher of both Oracle JDK and OpenJDK. Datadog does not officially support any early-access versions of Java.
Beta integrations are disabled by default but can be enabled individually:
-Ddd.integration.<INTEGRATION_NAME>.enabled=true
DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true
dd-java-agent
includes support for automatically tracing the following web frameworks.
Web Framework tracing provides:
Server | Versions | Support Type | Instrumentation Names (used for configuration) |
---|---|---|---|
Akka-Http Server | 10.0+ | Fully Supported | akka-http , akka-http-server |
Finatra Web | 2.9+ | Fully Supported | finatra |
Grizzly | 2.0+ | Fully Supported | grizzly |
Grizzly-HTTP | 2.3.20+ | Fully Supported | grizzly-filterchain |
Java Servlet Compatible | 2.3+, 3.0+ | Fully Supported | servlet , servlet-2 , servlet-3 |
Jax-RS Annotations | JSR311-API | Fully Supported | jax-rs , jaxrs , jax-rs-annotations , jax-rs-filter |
Jetty | 7.0-9.x | Fully Supported | jetty |
Micronaut HTTP Server | 2.x | Fully Supported | micronaut |
Mulesoft | 4 | Fully Supported | mule |
Netty HTTP Server | 3.8+ | Fully Supported | netty , netty-3.8 , netty-4.0 , netty-4.1 |
Play | 2.3-2.8 | Fully Supported | play , play-action |
Ratpack | 1.5+ | Fully Supported | ratpack |
Restlet HTTP Server | 2.2 - 2.4 | Fully Supported | restlet-http . |
Spark Java | 2.3+ | Beta | sparkjava (requires jetty ) |
Spring Web (MVC) | 4.0+ | Fully Supported | spring-web |
Spring WebFlux | 5.0+ | Fully Supported | spring-webflux |
Tomcat | 5.5+ | Fully Supported | tomcat |
Vert.x | 3.4-3.9.x | Fully Supported | vertx , vertx-3.4 |
Note: Many application servers are Servlet compatible and are automatically covered by that instrumentation, such as Websphere, Weblogic, and JBoss. Also, frameworks like Spring Boot inherently work because it usually uses a supported embedded application server (Tomcat/Jetty/Netty).
Integrations Disabled By Default
The following instrumentations are disabled by default and can be enabled with the following settings:
Instrumentation | To Enable |
---|---|
JAX-WS | -Ddd.integration.jax-ws.enabled=true |
Mulesoft | -Ddd.integration.mule.enabled=true , -Ddd.integration.grizzly-client.enabled=true , -Ddd.integration.grizzly-filterchain.enabled=true |
Grizzly | -Ddd.integration.grizzly-client.enabled=true |
Grizzly-HTTP | -Ddd.integration.grizzly-filterchain.enabled=true |
Note: JAX-WS integration instruments endpoints annotated with @WebService (JAX-WS 1.x) and @WebServiceProvider (JAX-WS 2.x).
Don’t see your desired web frameworks? Datadog is continually adding additional support. Contact Datadog support if you need help.
dd-java-agent
includes support for automatically tracing the following networking frameworks.
Networking tracing provides:
Framework | Versions | Support Type | Instrumentation Names (used for configuration) |
---|---|---|---|
Apache HTTP Client | 4.0+ | Fully Supported | httpclient , apache-httpclient , apache-http-client |
Apache HTTP Async Client | 4.0+ | Fully Supported | httpasyncclient , apache-httpasyncclient |
AWS Java SDK | 1.11+, 2.2+ | Fully Supported | aws-sdk |
Commons HTTP Client | 2.0+ | Fully Supported | commons-http-client |
Google HTTP Client | 1.19.0+ | Fully Supported | google-http-client |
Grizzly HTTP Client | 1.9+ | Beta | grizzly-client |
gRPC | 1.5+ | Fully Supported | grpc , grpc-client , grpc-server |
HttpURLConnection | all | Fully Supported | httpurlconnection , urlconnection |
Kafka-Clients | 0.11+ | Fully Supported | kafka |
Kafka-Streams | 0.11+ | Fully Supported | kafka , kafka-streams |
Java RMI | all | Fully Supported | rmi , rmi-client , rmi-server |
Jax RS Clients | 2.0+ | Fully Supported | jax-rs , jaxrs , jax-rs-client |
Jersey Client | 1.9-2.29 | Fully Supported | jax-rs , jaxrs , jax-rs-client |
JMS | 1 and 2 | Fully Supported | jms , jms-1 , jms-2 |
Netty HTTP Client | 4.0+ | Fully Supported | netty , netty-4.0 , netty-4.1 |
Ning HTTP Client | 1.9.0+ | Beta | ning |
OkHTTP | 2.2+ | Fully Supported | okhttp , okhttp-2 ,okhttp-3 |
Play WSClient | 1.0+ | Fully Supported | play-ws |
Rabbit AMQP | 2.7+ | Fully Supported | amqp , rabbitmq |
Spring SessionAwareMessageListener | 3.1+ | Fully Supported | spring-jms-3.1 |
Spring WebClient | 5.0+ | Fully Supported | spring-webflux , spring-webflux-client |
Note: Datadog’s Kafka integration works with Kafka version 0.11+
, which supports the Header API. This API is used to inject and extract trace context. If you are running a mixed version environment, the Kafka broker can incorrectly report the newer version of Kafka. This causes an issue when the tracer tries to inject headers that are not supported by the local producer. Additionally, older consumers are unable to consume the message because of the presence of headers. To prevent these issues, if you are running a mixed version Kafka environment with versions older than 0.11, disable context propagation with the environment variable: DD_KAFKA_CLIENT_PROPAGATION_ENABLED=false
.
Don’t see your desired networking framework? Datadog is continually adding additional support. Contact Datadog support if you need help.
dd-java-agent
includes support for automatically tracing the following database frameworks/drivers.
Datastore tracing provides:
Database | Versions | Support Type | Instrumentation Names (used for configuration) |
---|---|---|---|
Aerospike | 4.0+ | Fully Supported | aerospike |
Couchbase | 2.0+ | Fully Supported | couchbase |
Cassandra | 3.0+ | Fully Supported | cassandra |
Elasticsearch Transport | 2.0+ | Fully Supported | elasticsearch , elasticsearch-transport , elasticsearch-transport-{2,5,6,7} (pick one) |
Elasticsearch Rest | 5.0+ | Fully Supported | elasticsearch , elasticsearch-rest , elasticsearch-rest-{5,6,7} (pick one) |
JDBC | N/A | Fully Supported | jdbc , jdbc-datasource |
Jedis | 1.4+ | Fully Supported | jedis , redis |
Lettuce | 4.0+ | Fully Supported | lettuce , lettuce-4-async , lettuce-5-rx |
MongoDB | 3.0-4.0+ | Fully Supported | mongo |
RediScala | 1.5+ | Fully Supported | rediscala , redis |
SpyMemcached | 2.12+ | Fully Supported | spymemcached |
Vert.x Cassandra Client | 3.9 | Fully Supported | cassandra |
Vert.x Redis Client | 3.9 | Fully Supported | vertx-redis-client |
Vert.x MySQL Client | 3.9 | Fully Supported | vertx-sql-client |
dd-java-agent
is also compatible with common JDBC drivers including:
Integrations Disabled By Default
The following instrumentations are disabled by default and can be enabled with the following settings:
Instrumentation | To Enable |
---|---|
JDBC-Datasource | -Ddd.integration.jdbc-datasource.enabled=true |
Don’t see your desired datastores? Datadog is continually adding additional support. Contact Datadog support if you need help.
dd-java-agent
includes support for automatically tracing the following frameworks.
Framework | Versions | Support Type | Instrumentation Names (used for configuration) |
---|---|---|---|
Datanucleus JDO | 4.0+ | Fully Supported | datanucleus |
Dropwizard Views | 0.7+ | Fully Supported | dropwizard , dropwizard-view |
Hibernate | 3.5+ | Fully Supported | hibernate , hibernate-core |
Hystrix | 1.4+ | Fully Supported | hystrix |
JSP Rendering | 2.3+ | Fully Supported | jsp , jsp-render , jsp-compile |
JUnit | 4.1+, 5.3+ | Fully Supported | junit , junit-4 , junit-5 |
Project Reactor | 3.1+ | Fully Supported | reactor-core |
Quartz | 2.x | Fully Supported | quartz |
RxJava | 2.x | Fully Supported | rxjava |
Spring Data | 1.8+ | Fully Supported | spring-data |
Spring Scheduling | 3.1+ | Fully Supported | spring-scheduling |
Twilio SDK | < 8.0 | Fully Supported | twilio-sdk |
Don’t see your desired frameworks? Datadog is continually adding additional support. To request a framework, contact our awesome support team.
To improve visibility into applications using unsupported frameworks, consider:
Most integrations are enabled by default. The following setting can change the default to disabled.
-Ddd.integrations.enabled=false
DD_INTEGRATIONS_ENABLED=false
Integrations can be enabled or disabled individually (overriding the default above).
-Ddd.integration.<INTEGRATION_NAME>.enabled=true
DD_INTEGRATION_<INTEGRATION_NAME>_ENABLED=true
(See above for each integration’s name.)
Running the Java tracer in Bitbucket is not supported.
お役に立つドキュメント、リンクや記事: