New RelicのJavaエージェント には、アプリケーションサーバー、フレームワーク、データベース、そしてメッセージキューシステムを含む、Javaエコシステムの中で最も人気ある部分のビルトインインストゥルメンテーションが含まれています。追加設定なしではインストゥルメントされていないフレームワークとライブラリに関しては、Javaカスタムインストゥルメンテーション でそのエージェントを拡張できます。
New RelicのJavaエージェントをお試しになりますか?New Relicアカウントの作成 は無料です。クレジットカードは不要です。
エージェントのインストール要件 Javaエージェントをインストールする前に、お使いのシステムが以下のシステム要件を満たしていることを確認してください:
JVM Javaエージェントは、Java、Scala、Kotlin、ClojureなどのJVMベースの言語と互換性があります。個々の言語の機能のインストゥルメンテーションのサポートについては、以下の自動インストゥルメンテーションされたフレームワークとライブラリ のセクションをご覧ください。
イノベーションを継続し、お客様に新しい機能を効率的に提供するために、旧バージョンのJVMのエンジニアリングサポートとテクニカルサポートを終了する必要がある場合があります。以下の表では、New Relicサポートなし というカラムは、この状態にあるエージェントのバージョンを指しています。サポートされていないバージョンの場合、旧バージョンのJVMと互換性のあるバージョンのエージェントを引き続き使用できますが、新しい機能と修正は旧バージョンのエージェントには含まれません。最新のエージェントリリースを利用するには、現在サポートされているJVMバージョンにアップグレードすることをお勧めします。
Javaバージョン
互換性のあるJavaエージェントバージョン
New Relicサポートなし(上記参照)
Java 7
v3.0.0〜v6.5.0、v6.5.2、v6.5.3、v6.5.4
v5.14.0以前
Java 8
v3.10.0以降
v5.14.0以前
Java 9
v3.43.0以降
v5.14.0以前
Java 10
v4.4.0以降
v5.14.0以前
Java 11
v4.7.0以降
v5.14.0以前
Java 12
v4.12.0以降
v5.14.0以前
Java 13
v5.7.0以降
v5.14.0以前
Java 14
v5.11.0以降
v5.14.0以前
Java 15
v6.1.0以降
該当なし
Java 16
v7.3.0以降
該当なし
Java 17
v7.4.0以降
該当なし
Java 18
v7.7.0以降
該当なし
Java 19
v7.11.0以降
該当なし
Java 20
v8.2.0以降
該当なし
Java 21
v8.7.0以降
該当なし
互換:
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はサポートされていません。
その他のモニターソフトウェアの使用 アプリケーションが当社のモニターソフトウェアのほかに他社のアプリケーションモニターソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他のモニターソフトウェアを使用中のエラー を参照してください。
内蔵インストゥルメンテーション Javaエージェントをインストール すると、多数の人気のフレームワークとライブラリが自動的にインストゥルメントされます。自動インストゥルメンテーションでは、エージェントが追加設定なしでリッチデータを収集し、データはインストールから数分でご利用のNew Relicダッシュボードに表示されます。ライブラリが自動インストゥルメンテーションされていない場合でも、カスタムインストゥルメンテーション およびJavaエージェントAPI を通じてデータを収集できます。
エージェントは、以下のフレームワークとライブラリを自動的にインストゥルメントします:
アプリケーション/ウェブサーバー エージェントは、以下のアプリケーション/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とメッセージング エージェントは、以下の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エージェントは、以下に記載されていないものも含め、多数のホスティングサービス上にインストールできます。以下は、特定のホスティングサービスに関するインストレーションガイドになります:
その他のインストゥルメンテーション機能 EJB Session Beans 3.0以上 JMX JSP (Java Server Pages) 2.0~3.0 Scala 2.9.3~2.13.xJavaエージェントは、他のNew Relic製品と統合され、エンドツーエンドの可視性を提供します。