Javaエージェントの互換性と要件

Javaエージェントは、Java、Scala、Kotlin、ClojureなどのJVMベースの言語と互換性があります。個々の言語の機能のインストゥルメンテーションのサポートについては、以下の自動インストゥルメンテーションされたフレームワークとライブラリのセクションをご覧ください。

イノベーションを継続し、お客様に新しい機能を効率的に提供するために、旧バージョンのJVMのエンジニアリングサポートとテクニカルサポートを終了する必要がある場合があります。以下の表では、New Relicサポートなしというカラムは、この状態にあるエージェントのバージョンを指しています。サポートされていないバージョンの場合、旧バージョンのJVMと互換性のあるバージョンのエージェントを引き続き使用できますが、新しい機能と修正は旧バージョンのエージェントには含まれません。最新のエージェントリリースを利用するには、現在サポートされているJVMバージョンにアップグレードすることをお勧めします。

互換：

• Linux用IBM JVMバージョン8

• Linux、Windows、macOS 用 Eclipse OpenJ9 バージョン 8～19

• Linux、Windows、macOS用OpenJDKバージョン8～20

• Linux、Windows、macOS用AdoptOpenJDKバージョン8～16

• Linux、Windows、macOS用Temurinバージョン17～20

• Linux、Solaris、Windows、およびmacOS用Oracle Hotspot JVMバージョン8～20

• Linux、Windows、macOS 用の Azul Zulu JVM バージョン8と11

• Linux、Windows、macOS用のAzul Zulu JVMバージョン8～20

• Linux、Windows、macOS用のAmazon Corretto JVMバージョン8、11、17～20

• Linux、Windows、macOS 用の Alibaba Dragonwell JVMバージョン8と11

  （Java 1.7）Javaエージェント6.5.x [ZIP | 16.8 MB] レガシーエージェントでのみ互換性あり：

• OpenJDKおよびAdoptOpenJDK JVMバージョン7

• IBM JVMバージョン7

• Linux、Solaris、Windows、macOS用Oracle Hotspot JVMバージョン7

  （Java 1.6）Javaエージェント4.3.xとのみ互換性あり [ZIP | 9.9 MB] レガシーエージェント：

• macOS 用 Apple Hotspot JVMバージョン6

• IBM JVMバージョン 6

• Linux、Solaris、Windows、macOS 用 Oracle Hotspot JVMバージョン6.0

  （Java 1.5）Javaエージェント2.21.x [ZIP | 2.8 MB] レガシーエージェントでのみ互換性あり：

• Linux、Solaris、Windows、macOS 用 Oracle Hotspot JVMバージョン5.0（Java SE 5.0）

• Oracle JRockit（1.6.0_50まで）

標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。

アプリケーションが当社のモニターソフトウェアのほかに他社のアプリケーションモニターソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他のモニターソフトウェアを使用中のエラーを参照してください。

エージェントは、以下のアプリケーション/Webサーバーを自動的にインストゥルメントします。サポートされているアプリケーション/WebサーバーにJavaエージェントをインストールするには、Javaエージェントのインストールを参照してください。

• ColdFusion 10
• Glassfish 3.0以降
• JBoss 7.0以降
• JBoss EAP 6.0以降
• Jetty 9.3.0.M1以降
• Mule ESB 3.4～3.8.x
• Netty 3.3.0.Alpha1～5.0.0.Alpha1
• Resin 3.1.9 4.0.xまで
• Spray-can 1.3.1以降
• Tomcat 7.0.0以降
• TomEE 1.5以降
• WebLogic 12.1.2.1～12.2.x
• WebSphere 8.5.x～9.x
• WebSphere Liberty Profile 8.5以降
• WildFly 8.0.0.Final以降

エージェントは、以下のフレームワークを自動的にインストゥルメントします。サポートされているフレームワークにJavaエージェントをインストールするには、Javaエージェントのインストールを参照してください。

• Akka 2.2.0-RC1以降

• AmazonS3クライアント1.2.13以降

• AmazonSNSおよびAmazonSNSAsyncクライアント1.11.12以降

• AmazonSQSおよびAmazonSQSAsyncクライアント1.3.22以降

• Cats Effect v2

  • Scala 2.12: 2.1以降
  • Scala 2.13: 2.1以降

• Cats Effect v3

  • Scala 2.12: 3.2.x
  • Scala 2.13: 3.2.x

• CXF 2.1.3以降

• Grails 1.3.7～2.3.x

• GraphQL 16.0〜16.2

• GraphQL 17.0～20.x

• Hibernate 3.3.0.CR1～6.0.0.Alpha2

• Hystrix 1.3.15以降

• Jakarta RESTful WS API 2.1.x〜3.1.xまで

• JAX-RS 1.0～2.0

• JBoss Logging 1.3.0.Final以降（当社のLogs in Context機能用）

• JCache API 1.0.0以降

• Jersey 1.0.1以降

• JSF （Java Server Faces）

• JUL（Javaユーティリティロギング）（当社のLogs in Context機能用）

• Log4j1 1.2.17以降（当社のLogs in Context機能用）

• Log4j 2 2.6以降（当社のLogs in Context機能用）

• 1.1から最新のログバック（当社のLogs in Context機能用）

• Monix Task

  • Scala 2.11: 3.0.0〜3.2.x
  • Scala 2.12: 3.0.0以降
  • Scala 2.13: 3.0.0以降
  • Scala 3: 3.0.0以降

• Play Server 2.3.0以降

• Quartz Job Scheduler 1.8.3～2.2.x

• RESTEasy 2.2-RC-1以降

• S3Client 2.1.0以降

• SnsClient 2.1.0以降

• Spray 1.3.1以降

• Spring 3.0.0.RELEASE以降

• Spring Web Services 1.5.7以降

• Spring Webflux 5.0.0.RELEASE以降

• SqsClient 2.1.0以降

• Struts 2.0以降

• Thrift 0.8.0以降

• Vert.x 3.2.0～3.8.3

• ZIO

  • Scala 2.13: 1.0.9〜2.0.0-M2

エージェントは、以下のHTTPクライアントおよびメッセージングサービスを自動的にインストゥルメントします。詳しい手順については、Javaエージェントのインストールをご覧ください。

• Akka HTTP 2.4.5以降

• Akka Http Core 0.4以降

• AsyncHttpClient 2.0.0-RC1以降

• gRPC 1.4.0以降

• HTTP4s Blazeクライアント

  • Scala 2.12: 0.21～0.23.0-M1
  • Scala 2.13: 0.21～0.23.0-M1

• HTTP4s Blazeサーバー

  • Scala 2.12: 0.21～0.22.0-M8
  • Scala 2.13: 0.21～0.22.0-M8

• HttpAsyncClient 4.1以降

• Apache Httpclient 3.1〜4.5.x

• java.net.HttpURLConnection

• JMS 1.1以降

• Kafka Clients 0.10.0.0以降（メトリックおよびイベントデータ向け）

• Kafka Clients 0.11.0.0以降（ディストリビューティッド（分散）トレーシングおよびイベントデータ向け）

• Kafka Connect 1.0.0以降（メトリクス用）

• Kafka Connect 2.0.0以降（ディストリビューティッド（分散）トレーシングおよびトランザクションデータ用）

• Kafka Streams 1.0.0以降（メトリクス用）

• Kafka Streams 2.0.0以降（ディストリビューティッド（分散）トレーシングおよびトランザクションデータ用）

• OkHttp 3.6.0以降

• Ning AsyncHttpClient 1.x

• Play WS

  • Scala 2.11: 2.6.0以降
  • Scala 2.12: 2.6.0以降
  • Scala 2.13: 2.7.3以降

• RabbitMQ 1.7.2以降 (AMQP および JMS)

• Spray-client 1.3.1以降

• Spring JMS 1.1以降

• Spring webclient 5.0.0.リリース～最新版まで

• STTP v2

  • Scala 2.12: 2.2.3〜最新2.x
  • Scala 2.13: 2.2.3〜最新2.x、3.0.0〜最新3.x

現在、New RelicはMySQLとPostgreSQLをサポートしており、データベースのクエリが遅い場合にExplain Planを取得します。

• Amazon v1 DynamoDB 1.11.106以降

• Amazon v2 DynamoDB 2.1.0以降

• Anorm 2.0 ～2.5

• DataStax Cassandra 3.0.0以降（高セキュリティを使用している場合、許可リストに関する設定ドキュメンテーションを参照してください。）

• DB2 9.1以降

• Derby 10.11.1.1以降

• 汎用JDBC（任意のJDBC準拠ドライバ）

• H2 1.0.57以降

• HSQL 1.7.2.2以降

• INet Oracle Driver （Oranxo） 3.06、3.14

• INet MERLIA 7.0.3、8.04.03、8.06

• Jedis Redisドライバ1.4.0～2.10.x、3.0.0～4.x

• jTDS 1.2以降

• Lettuce Redis driver 4.3以降

• MariaDB 1.1.7以上

• Microsoft SQL Server 1.2以降

• MongoDB

  • 同期クライアント：3.1.0-rc0以降
  • 非同期クライアント：3.4.0～4.1.x
  • Reactive streamsクライアント：4.2.0以降

• MySQL mysql-connector-java 3.0.8以降

• Oracle ojdbc5、ojdbc6、ojdbc7、ojdbc8、ojdbc10、ojdbc14

• Postgres 8.0-312.jdbc3以降

• R2DBC H2 0.8.x ～ 0.9.x

• R2DBC MariaDB 1.0.2～1.1.1

• R2DBC MySQL 0.8.x以降

• R2DBC MSSQL 0.8.0以降

• R2DBC Oracle 0.x以降

• R2DBC Postgres 0.9.x

• Slick 3.0.0～3.3.x

• Solr 4.0以降

• Spymemcached 2.11以降

• Sybase (jConnect) JDBC 3 driver 6.0以降

New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。APMで特定のインスタンスおよびデータベース情報のタイプを表示する能力は、New Relicエージェントのバージョンによって異なります。

New RelicのJavaエージェントバージョン3.33.0以降 では、以下の機能をサポートしています：

• 任意の 互換性のあるJDBCドライバ

• Amazon DynamoDB 1.11.106以上

• Amazon v2 DynamoDB 2.1.0以降

• DataStax Cassandra driver 3.0.0以降

• Jedis Redisドライバ1.4～2.10.x、3.0.0～4.x

• MongoDB

  • 同期クライアント：3.1.0-rc0以降
  • 非同期/Reactive Streamsクライアント：3.4.0〜4.1.2

• Spymemcached 2.11.0以降

  例外：インスタンスレベルの情報は、getBulk()APIメソッドの呼び出しでは報告されません。

  Javaエージェントは、低速クエリのトレースおよびこれらのデータベースドライバのトランザクショントレースに関して、データベース名とデータベースサーバー/識別子属性をレポートします。追加のデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comでサポートを受けてください。

Javaエージェントは、以下に記載されていないものも含め、多数のホスティングサービス上にインストールできます。以下は、特定のホスティングサービスに関するインストレーションガイドになります：

• Google App Engine（GAE）フレキシブル環境
• Heroku

サポートされているフレームワークの場合、Javaエージェントは通常、非同期インストゥルメンテーションを自動的に行います。ただし、JavaエージェントAPIを使用してこのインストゥルメンテーションを拡張できます。

• EJB Session Beans 3.0以上
• JMX
• JSP （Java Server Pages） 2.0～3.0
• Scala 2.9.3～2.13.x