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

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

この表の一部のJavaエージェントバージョンはサポートされなくなりましたが、参照のために引き続きリストされています。サポート対象のJavaエージェントのバージョンのリストは、JavaエージェントのEOLポリシーにあります。

標準的な データ収集のセキュリティ対策として、アプリサーバーは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.9.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以降

• Amazon Kinesis v1およびv2 SDK

• Amazon Lambda SDK 1.11.280以降

• 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以降

• Glassfish JUL（Javaユーティリティロギング）拡張ライブラリ

• Grails 1.3.7～2.3.x

• GraphQL 16.0以降

• 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～3.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以降

• Pekko 1.0.0以降

• Pekko-Http 1.0.0以降

  • Scala 2.13

• Play Server 2.3.0以降/* Pekko-Httpをサポートすると、Playサポートが最新のものまで拡張されます */

• 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 Batch 4.0.0以降

• Spring Boot Actuator v3以降（トランザクション命名）

• 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～4.5.x

• ZIO

  • Scala 2.13: 1.0.9以降

エージェントは、以下の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〜5.x

• java.net.HttpURLConnection

• JMS 1.1以降

• Kafkaクライアントノードメトリクス（/docs/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues）3.7.0以降（メトリクス用）

• Kafkaクライアントメトリクス0.10.0.0以降（メトリクス用）

• Kafkaクライアントスパン0.11.0.0～3.6.x（ディストリビューティッド（分散）トレーシング用）

• Kafka Connect 1.0.0～3.6.x（メトリクス用）

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

• Kafka Streams 1.0.0～3.6.x（メトリクス用）

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

• 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以降

• Flywayマイグレーションイベント（Flyway v8.0.0以降）

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

• H2 1.0.57以降

• HikariCP 2.4.0以降

  • エージェントバージョン8.13.0以降で利用可能
  • HikariCPインキュベーターモジュールを置き換えます。HikariCPインキュベーターJar（hikaricp-2.4.0.jar）を使用している場合は、エージェントの拡張フォルダから削除してください。

• 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、5.x以降

• jTDS 1.2以降

• Lettuce Redis driver 4.3以降

• MariaDB 1.1.7以上

• Microsoft SQL Server 1.2〜12.6.x

• 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以降

• Vert.x SQLクライアント4.4.2以降

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、5.x以降

• MongoDB

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

• Spymemcached 2.11.0以降

  Exception: 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 以降
• Scala 2.9.3以降