Java 互換性要件

Java 互換性要件

互換性

Java Datadog Trace ライブラリはオープンソースです。詳細については、Github リポジトリをご覧ください。

Datadog は、Oracle JDK と OpenJDK の両方の Java JRE 1.7 以上を公式にサポートしています。Datadog は Java のアーリーアクセスバージョンを公式にサポートしていません。

ベータインテグレーションはデフォルトで無効になっていますが、個別に有効にできます。

  • システムプロパティ: -Ddd.integration.<インテグレーション名>.enabled=true
  • 環境変数: DD_INTEGRATION_<インテグレーション名>_ENABLED=true

Web フレームワークの互換性

dd-java-agent には、次のウェブフレームワークの自動トレースのサポートが含まれます。

Web フレームワークのトレーシングでは以下の確認が可能です。

  • HTTP リクエストの応答タイミング
  • HTTP リクエスト用のタグ (ステータスコード、メソッドなど)
  • エラーとスタックトレースの取得
  • Web リクエストと分散型トレーシングの間で作成された作業のリンク
サーバーバージョンサポートの種類インスツルメンテーション名 (コンフィギュレーションに使用)
Akka-Http サーバー10.0+完全対応akka-http、akka-http-server
Finatra Web2.9+完全対応finatra
Grizzly2.0+ベータgrizzly
Grizzly-HTTP2.3.20+ベータgrizzly-filterchain
Java Servlet 互換2.3+、3.0+完全対応servlet、servlet-2、servlet-3
Jax-RS アノテーションJSR311-API完全対応jax-rs、jaxrs、jax-rs-annotations、jax-rs-filter
Jetty (非 Servlet)8+ベータjetty、jetty-8
Netty HTTP サーバー3.8+完全対応netty, netty-3.8, netty-4.0, netty-4.1
Play2.3-2.8完全対応play、play-action
Ratpack1.5+完全対応ratpack
Spark Java2.3+ベータsparkjava (要 jetty)
Spring Web (MVC)4.0+完全対応spring-web
Spring WebFlux5.0+完全対応spring-webflux

注: 多くのアプリケーションサーバーは Servlet 互換でそのインスツルメンテーションによって自動的にカバーされます (Tomcat、Jetty、Websphere、Weblogic、JBoss)。 また、Spring Boot のようなフレームワークは、通常サポートされた組み込みアプリケーションサーバーを使うため、本質的に機能します (Tomcat/Jetty/Netty)。

希望するウェブフレームワークが見つかりませんか？Datadog では継続的にサポートを追加しています。サポートが必要な場合は、Datadog サポートにお問い合わせください。

ネットワーキングフレームワークの互換性

dd-java-agent には、次のネットワーキングフレームワークの自動トレースのサポートが含まれます。

ネットワーキングのトレーシングでは以下の確認が可能です

  • リクエストの応答タイミング
  • リクエスト用のタグ (応答コードなど)
  • エラーとスタックトレースの取得
  • 分散型トレーシング
フレームワークバージョンサポートの種類インスツルメンテーション名 (コンフィギュレーションに使用)
Apache HTTP クライアント4.0+完全対応httpclient、apache-httpclient、apache-http-client
Apache HTTP 非同期クライアント4.0+完全対応httpasyncclient、apache-httpasyncclient
AWS Java SDK1.11+、2.2+完全対応aws-sdk
Commons HTTP クライアント2.0+完全対応commons-http-client
Google HTTP クライアント1.19.0+完全対応google-http-client
Grizzly HTTP クライアント1.9+ベータgrizzly-client
gRPC1.5+完全対応grpc、grpc-client、grpc-server
HttpURLConnectionすべて完全対応httpurlconnection、urlconnection
Kafka-Clients0.11+完全対応kafka
Kafka-Streams0.11+完全対応kafka、kafka-streams
Java RMIすべて完全対応rmi、rmi-client、rmi-server
Jax RS クライアント2.0+完全対応jax-rs、jaxrs、jax-rs-client
Jersey クライアント1.9+完全対応jax-rs、jaxrs、jax-rs-client
JMS1 と 2完全対応jms、jms-1、jms-2
Netty HTTP クライアント4.0+完全対応netty、netty-4.0、netty-4.1
Ning HTTP クライアント1.9.0+ベータning
OkHTTP2.2+完全対応okhttp、okhttp-2、okhttp-3
Play WSClient1.0+完全対応play-ws
Rabbit AMQP2.7+完全対応amqp、rabbitmq
Spring SessionAwareMessageListener3.1+完全対応spring-jms-3.1
Spring WebClient5.0+完全対応spring-webflux、spring-webflux-client

注: Datadog’s Kafka インテグレーションは、ヘッダー API をサポートする Kafka のバージョン 0.11+ で機能します。この API はトレースコンテキストの挿入と抽出に使用されます。バージョンが混在する環境でシステムを稼働させている場合は、Kafka ブローカーが Kafka のより新しいバージョンを間違って報告する場合があります。この場合、トレーサーがローカルのプロデューサーでサポートされていないヘッダーを挿入しようとしたときに問題が発生することがあります。また、古いバージョンのコンシューマーはヘッダーが存在するためにメッセージを収集することができません。これらの問題を回避するために、0.11 より前の Kafka のバージョンが混在している環境では、環境変数: DD_KAFKA_CLIENT_PROPAGATION_ENABLED=false を伴うコンテキストの伝搬を無効化するようにしてください。

希望するネットワーキングフレームワークが見つかりませんか？Datadog では継続的にサポートを追加しています。サポートが必要な場合は、Datadog サポートにお問い合わせください。

データストアの互換性

dd-java-agent には、次のデータベースフレームワーク/ドライバーの自動トレースのサポートが含まれます。

データストアのトレーシングでは以下の確認が可能です

  • リクエストの応答タイミング
  • クエリ情報 (サニタイジングされたクエリ文字列など)
  • エラーとスタックトレースの取得
データベースバージョンサポートの種類インスツルメンテーション名 (コンフィギュレーションに使用)
Couchbase2.0+完全対応couchbase
Cassandra3.X完全対応cassandra
Elasticsearch Transport2.0-6.x完全対応elasticsearch、elasticsearch-transport、elasticsearch-transport-{2,5,6} (1 つ選択)
Elasticsearch Rest5.0-6.x完全対応elasticsearch、elasticsearch-rest、elasticsearch-rest-5、elasticsearch-rest-6
JDBCN/A完全対応jdbc、jdbc-datasource
Jedis1.4+完全対応jedis、redis
Lettuce4.0+完全対応lettuce、lettuce-4-async、lettuce-5-rx
MongoDB3.0+完全対応mongo
RediScala1.5+完全対応rediscala、redis
SpyMemcached2.12+完全対応spymemcached

dd-java-agent は、次を含む一般的な JDBC ドライバーとも互換性があります:

  • Apache Derby
  • Firebird SQL
  • H2 データベースエンジン
  • HSQLDB
  • IBM DB2
  • MariaDB
  • MSSQL (Microsoft SQL Server)
  • MySQL
  • Oracle
  • Postgres SQL
  • ScalikeJDBC

希望するデータストアが見つかりませんか？Datadog では継続的にサポートを追加しています。サポートが必要な場合は、Datadog サポートにお問い合わせください。

他のフレームワークの互換性

dd-java-agent には、次の他のフレームワークの自動トレースのサポートが含まれます。

フレームワークバージョンサポートの種類インスツルメンテーション名 (コンフィギュレーションに使用)
Dropwizard Views0.7+完全対応dropwizard、dropwizard-view
Hibernate3.5+完全対応hibernate、hibernate-core
Hystrix1.4+完全対応hystrix
JSP Rendering2.3+完全対応jsp、jsp-render、jsp-compile
Slf4J MDC1+完全対応mdc (dd.logs.injection コンフィギュレーションも参照してください)
プロジェクトリアクタ3.1+完全対応reactor-core
Spring Data1.8+完全対応spring-data
Spring Scheduling3.1+完全対応spring-scheduling
Twilio SDK0+完全対応twilio-sdk

希望するフレームワークが見つかりませんか？Datadog では継続的にサポートを追加しています。フレームワークのリクエストは、サポートチームまでお気軽にお問い合わせください。

サポートされていないフレームワークを使ったアプリケーションの可視性を向上させるには、次のことを検討してください:

インテグレーションの無効化

大半のインテグレーションはデフォルトで有効になっています。次の設定により、デフォルトを無効に変更できます。

  • システムプロパティ: -Ddd.integrations.enabled=false
  • 環境変数: DD_INTEGRATIONS_ENABLED=false

インテグレーション箱別に有効または無効にできます (上記のデフォルトをオーバーライド)。

  • システムプロパティ: -Ddd.integration.<インテグレーション名>.enabled=true
  • 環境変数: DD_INTEGRATION_<インテグレーション名>_ENABLED=true

(各インテグレーションの名前については上記を参照してください。)

その他の参考資料

お役に立つドキュメント、リンクや記事:

アプリケーションのインスツルメンテーションDOCUMENTATION more more