Skip to content

compatibility-requirements-java-agent.mdx

Latest commit

 

History

History
538 lines (380 loc) · 19.8 KB

compatibility-requirements-java-agent.mdx

File metadata and controls

538 lines (380 loc) · 19.8 KB
title Javaエージェントの互換性と要件
tags
Agents
Java agent
Getting started
metaDescription The New Relic APM Java agent: compatibility and requirements.
freshnessValidatedDate never
translationType human

New RelicのJavaエージェントには、アプリケーションサーバー、フレームワーク、データベース、そしてメッセージキューシステムを含む、Javaエコシステムの中で最も人気ある部分のビルトインインストゥルメンテーションが含まれています。追加設定なしではインストゥルメントされていないフレームワークとライブラリに関しては、Javaカスタムインストゥルメンテーションでそのエージェントを拡張できます。

New RelicのJavaエージェントをお試しになりますか？New Relicアカウントの作成は無料です。クレジットカードは不要です。

エージェントのインストール要件 [#java-requirements]

Javaエージェントをインストールする前に、お使いのシステムが以下のシステム要件を満たしていることを確認してください：

Javaエージェントは、Java、Scala、Kotlin、ClojureなどのJVMベースの言語と互換性があります。個々の言語の機能のインストゥルメンテーションのサポートについては、以下の[自動インストゥルメンテーションされたフレームワークとライブラリ](#auto-instrumented)のセクションをご覧ください。 
<table>
  <thead>
    <tr>
      <th style={{ width: "200px" }}>
        Javaバージョン
      </th>

      <th style={{ width: "300px" }}>
        互換性のあるJavaエージェントバージョン
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Java 26
      </td>

      <td>
        v9.2.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 25
      </td>

      <td>
        v8.25.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 24
      </td>

      <td>
        v8.20.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 21
      </td>

      <td>
        v8.7.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 17
      </td>

      <td>
        v7.4.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 11
      </td>

      <td>
        v4.7.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 8
      </td>

      <td>
        v3.10.0以降
      </td>
    </tr>

    <tr>
      <td>
        Java 7
      </td>

      <td>
        v3.0.0〜v6.5.0、v6.5.2、v6.5.3、v6.5.4
      </td>
    </tr>
  </tbody>
</table>

この表の一部のJavaエージェントバージョンはサポートされなくなりましたが、参照のために引き続きリストされています。サポート対象のJavaエージェントのバージョンのリストは、[JavaエージェントのEOLポリシー](/docs/apm/agents/java-agent/getting-started/java-agent-eol-policy/)にあります。
標準的な [データ収集のセキュリティ対策](/docs/accounts-partnerships/accounts/security/data-security)として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。 アプリケーションが当社のモニターソフトウェアのほかに他社のアプリケーションモニターソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、[その他のモニターソフトウェアを使用中のエラー](/docs/apm/new-relic-apm/troubleshooting/errors-while-using-new-relic-apm-alongside-other-apm-software)を参照してください。

内蔵インストゥルメンテーション [#auto-instrumented]

Javaエージェントをインストールすると、多数の人気のフレームワークとライブラリが自動的にインストゥルメントされます。自動インストゥルメンテーションでは、エージェントが追加設定なしでリッチデータを収集し、データはインストールから数分でご利用のNew Relicダッシュボードに表示されます。ライブラリが自動インストゥルメンテーションされていない場合でも、カスタムインストゥルメンテーションおよびJavaエージェントAPIを通じてデータを収集できます。

エージェントは、以下のフレームワークとライブラリを自動的にインストゥルメントします：

エージェントは、以下のアプリケーション/Webサーバーを自動的にインストゥルメントします。サポートされているアプリケーション/WebサーバーにJavaエージェントをインストールするには、[Javaエージェントのインストール](/docs/agents/java-agent/installation/java-agent-manual-installation)を参照してください。 
* Glassfish 6.0以降

* JBoss 7.0以降

* Jetty 7.0.0以降

* Mule 3.4.0以降

* Netty 3.3.0.Alpha1以降、5.0.0.Alpha1未満

* Netty Reactor 0.7.0.RELEASE以降

* Netty Reactor HTTP 1.0.0以降

* Open Liberty 21.0.0.12以降

* Play 2.4.0-M3以降

* Resin 3.1.9 以降

* Spray 1.3.1以降

* Tomcat 7.0.0以降

  * Tomcat v7.0.0～v7.0.69は、v3.43.0より前のJavaエージェントでのみサポートされています。
  * Tomcat v7.0.70～v7.0.75およびv8.0.0～v8.0.41は、v3.43.0より前のJavaエージェントでのみサポートされています。
  * Tomcat v8.5.0～v8.5.11は、v3.43.0より前のJavaエージェントでのみサポートされています。

* Undertow 1.1.0.Final以降

* WebLogic 12.1.2.1～14.1.x

* WebSphere 8以降、9未満

* WebSphere Liberty 8.5以降

* WildFly 8.0.0.Final以降
エージェントは、以下のフレームワークを自動的にインストゥルメントします。サポートされているフレームワークにJavaエージェントをインストールするには、[Javaエージェントのインストール](/docs/agents/java-agent/installation/java-agent-manual-installation)を参照してください。 
* Akka 2.4.10以降

* Apache Camel 3.9.0以降

* AWS ファイアホース 2.1.0以降

* AWS Kinesis 1.11.106以降

* AWS Lambda 1.11.280以降

* AWS Lambda Core 1.1.0以降

* AWS S3 1.9.0以降

* AWS SNS 1.11.12以降

* AWS SQS 1.10.44以降

* Cats Effect 3.3.0以降、3.3.4未満

* Cats Effect v2 2.1以降、3.0未満

  * Scala 2.12：2.1以降、3.0未満
  * Scala 2.13：2.1以降、3.0未満

* Cats Effect v3 3.2以降、3.3未満

  * Scala 2.12：3.2～3.3.4
  * Scala 2.13：3.2～3.3.4

* CXF 2.1.3以降

* EJB 6.0以降

* Grails 2.0以降、3.0.0.RC1未満

* GraphQL 16.0以降、21.0未満

* GraphQL Java 21.0以降

* Hibernate 3.5以降、6.0.0.Alpha2未満

* Hystrix 1.3.15以降

* JAX-RS 1.0以降

* JCache API 1.0.0以降

* Jersey 1.0.1以降、3.1未満

* Jersey Client 0.9以降

* Micronaut 1.0.0以降

* Micronaut Core Reactive 2.4.0以降

* Micronaut Inject 1.0.0以降

* Micronaut Router 1.0.0以降

* Monixタスク2.0.0以降

  * Scala 2.12：2.0.6 以降
  * Scala 2.13: 3.0.0以降
  * Scala 3：3.4.0 以降

* OpenTelemetry 1.26.0-alpha以降

* Pekko 1.0.0以降

* Pekko Http 1.0.0以降

  * Scala 2.13：1.0.0以降
  * Scala 3：1.0.0以降

* Pekko Http Core 1.0.0以降

  * Scala 2.13：1.0.0以降
  * Scala 3：1.0.0以降

* Play 2.4.0-M3以降

* Quartz Scheduler 1.7.2 以降

* RESTEasy 2.2-RC-1以降

* サーブレット2.3以降

* Spray 1.3.1以降

* Spring 3.0.0.RELEASE以降

* Spring AOP 2.0.3以降

* Spring Batch 4.0.0.RELEASE以降、6.0.0未満

* Spring Boot Actuator 3.0.0以降、4.0.0-M1未満

* Spring Web Services 1.5.7以降、4.0.0未満

* Spring Webflux 5.0.0.RELEASE以降

* Struts 2.0以降

* Vertx 3.2.0以降、5.0.0.CR1未満

* ZIO 1.0.9以降
  * Scala 2.13: 1.0.9以降

* JSF （Java Server Faces）
エージェントは次のHTTPライブラリを自動的にインストゥルメントします。 
* Akka HTTP 2.4.5以降

* Akka Http Core 0.4以降

* Apache HttpAsyncClient 4.1以降

* Apache Httpclient 3.1-rc1以降

* AsyncHttpClient 2.0.0-RC1以降

* Blaze Client 0.21以降、0.24.0未満

  * Scala 2.12：0.21.0以降、0.24.0未満
  * Scala 2.13：0.21.0以降、0.24.0未満

* Blaze Server 0.21以降、0.24.0未満

  * Scala 2.12：0.21.0以降、0.24.0未満
  * Scala 2.13：0.21.0以降、0.24.0未満

* Ember Client 0.23.0以降、0.24.0未満

* Ember Server 0.23.0以降、0.24.0未満

* gRPC 1.4.0以降

* HttpUrlConnection 0以降

* Java HttpClient 11 以降

* Micronaut HTTP 1.3.0以降

* Micronaut HTTP Client 2.0.0以降、5.0.0未満

* Micronaut Http Netty 1.0.0以降、5.0.0未満

* Micronaut Http Server Netty 2.0.0以降

* Ning AsyncHttpClient 1.0以降、2.0.0未満

* OKHttp 3.6.0以降、4.4.0未満

* Play WS 2.6.0以降

  * Scala 2.13: 2.7.3以降
  * Scala 2.12: 2.6.0以降

* Spray 1.3.1以降

* Spring RestTemplate 6.0.0から7.0.0未満

* Spring webclient 5.0.0.RELEASE以降

* Spring Webflux 5.0.0.RELEASE以降

* STTP 2.2.3以降

  * Scala 2.12：2.2.3 以降
  * Scala 2.13：2.2.3以降
エージェントは次のログライブラリを自動的にインストゥルメントします。ログ転送やログインコンテキストなど、 Javaエージェントのロギングソリューションについては、[ロギング固有のドキュメント](/docs/logs/logs-context/java-configure-logs-context-all/)を参照してください。 
* Glassfish JUL拡張機能7.0.0以降
* Java Logging 8以降
* JBoss Logging 1.3.0以降
* Log4j Layout Template JSON 2.14.0以降
* Log4j-1 1.2.17以降
* Log4j2 2.6以降
* ログバック 1.1.0以降
エージェントは以下のメッセージングサービスを自動的にインストゥルメントします。手順については、 [「 Javaエージェントのインストール」](/docs/agents/java-agent/installation/java-agent-manual-installation)を参照してください。 
* ActiveMQClient 5.8.0以降
* AWS SNS 1.11.12以降
* AWS SQS 1.10.44以降
* Azure Service Bus 7.15.0以降
* JMS 1.1以降
* RabbitAMQP 2.7.0以降
* Spring JMS 0以降
* Spring Kafka 2.2.0.RELEASE以降

Javaエージェントは次のKafkaライブラリをインストゥルメントします。すべてのKafka計装がデフォルトで有効になっているわけではありません。詳細については、[Kafkaのドキュメント](docs/apm/agents/java-agent/instrumentation/java-agent-instrument-kafka-message-queues/)をご覧ください。

* Kafka Clients Config 1.1.0以降
* Kafka Clients Heartbeat 0.10.1.0以降、2.5.0未満
* Kafka Clients メトリクス 0.10.0.0以降
* Kafka Clients Node Metrics 1.0.0以降
* Kafka Clients Spans 0.11.0.0以降
* Kafka Clients Spans Consumer 2.0.0以降、4.0.0未満
* Kafka Connect Metrics 1.0.0以降
* Kafka Connect Spans 2.0.0以降
* Kafka Streams Metrics 1.0.0以降
* Kafka Streams Spans 2.0.0以降
現在、New RelicはMySQLとPostgreSQLをサポートしており、データベースのクエリが遅い場合にExplain Planを取得します。 
* 汎用JDBC（任意のJDBC準拠ドライバ）
* Anorm 2.3-M1以降、2.5未満
* AWS v1 DynamoDB 1.11.106以降
* AWS v2 DAX 2.0.0以降
* AWS v2 DynamoDB 2.1.0以降
* Cassandra 3.0.0以降
* Couchbase 2.4.0以降
* DB2 9.1以降
* Derby 10.11.1.1以降
* Flyway 8.0.0以降
* H2 1.0.57以降
* H2 R2DBC 0以降
* HikariCP 2.4.0以降
* HSQLDB 1.7.2.2以降
* Jedis 1.4.0以降
* jTDS 1.2以降
* Lettuce 4.2.1.Final以降
* MariaDB Java Client（3.0.2-rc）以降
* MariaDB R2DBC 1.0.2以降
* MongoDB 4.2.0以降、5.6.0未満
* MongoDB非同期クライアント 3.4.0以降、4.2.0未満
* MongoDB同期クライアント 3.1.0-rc0以降
* MSSQL R2DBC 0.8.0以降
* MySQL 3.0.8以降
* MySQL R2DBC 0.8.2以降
* Oracle JDBC 5以降
* Oracle R2DBC 0.0.0以降
* PostgreSQL 8.0-312.jdbc3以降
* PostgreSQL R2DBC 0.9.0以降
* Slick 3.0.0以降
* Solr 5.1.010.0.0未満
* Spymemcached 2.11以降
* SQLServer jdk6以降
* Vertx Sql Client 4.4.2以降、5.0.0未満
New Relicは[様々なデータベースとデータベースドライバのインスタンス詳細](/docs/apm/applications-menu/features/analyze-database-instance-level-performance-issues)を収集します。APMで特定のインスタンスおよびデータベース情報のタイプを表示する能力は、New Relicエージェントのバージョンによって異なります。 
New RelicのJavaエージェント[バージョン3.33.0以降](/docs/release-notes/agent-release-notes/java-release-notes/java-agent-3330) では、以下の機能をサポートしています：

* 任意の [互換性のあるJDBCドライバ](#JDBC)
* AWS v1 DynamoDB 1.11.106以降
* AWS v2 DAX 2.0.0以降
* AWS v2 DynamoDB 2.1.0以降
* Cassandra 3.0.0以降
* Jedis 1.4.0以降
* MongoDB非同期クライアント 3.4.0以降、4.2.0未満
* MongoDB同期クライアント 3.1.0-rc0以降
* Spymemcached 2.11以降
Javaエージェント8.12.0 以降を使用している場合は、特定のAIライブラリおよびフレームワークからAIデータを取得できます。詳細については、[AI監視のドキュメント](/docs/ai-monitoring/intro-to-ai-monitoring)を参照してください。 
* AWS Bedrock 2.20.157以降
* MCP Java SDK 1.0.0以降
* Spring AI Chat Completions 1.0.0-RC1以降
* Spring AI Embeddings 1.0.0-M7以降
Javaエージェントは、以下に記載されていないものも含め、多数のホスティングサービス上にインストールできます。以下は、特定のホスティングサービスに関するインストレーションガイドになります： 
* [Google App Engine（GAE）フレキシブル環境](/docs/agents/java-agent/additional-installation/google-app-engine-flexible-installation-java#tomcat-example)
* [Heroku](/docs/agents/java-agent/heroku/java-agent-heroku)
* Java Completable Futures 8以降 * Java Process 8以降 * Java XML RPC 8以降 * JSP 2.0以降 * OpenEJB 3.0以降 * OpenJPA 1.0以降 * Scala 2.1.5以降

エージェントを他のNew Relic製品に接続 [#digital-intelligence-platform]

Javaエージェントは、他のNew Relic製品と統合され、エンドツーエンドの可視性を提供します。

  <th>
    機能
  </th>
</tr>

  <td>
    Javaエージェントは[自動インストゥルメンテーションが有効にされると](/docs/browser/new-relic-browser/installation/install-new-relic-browser-agent#select-apm-app)、browser JavaScriptエージェントを自動的に挿入します。ブラウザインジェクションを有効化すると、[APMの概要ページ](/docs/apm/applications-menu/monitoring/apm-overview-page)でブラウザデータを表示でき、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、 [<InlinePopover type="browser" />とJavaエージェントを](/docs/agents/java-agent/instrumentation/page-load-timing-java)参照してください。
  </td>
</tr>

<tr>
  <td>
    [インフラストラクチャのモニタリング](/docs/infrastructure/new-relic-infrastructure/getting-started/introduction-new-relic-infrastructure)
  </td>

  <td>
    インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIでホストのリストを表示し、Infrastructure UIでAPMアプリ別にホストをフィルタリングできます。詳細については、[Infrastructure UIのAPMデータ](/docs/infrastructure/new-relic-infrastructure/data-instrumentation/new-relic-apm-data-infrastructure)を参照してください。
  </td>
</tr>

<tr>
  <td>
    [New Relicのダッシュボード](/docs/query-your-data/explore-query-data/dashboards/introduction-new-relic-one-dashboards)
  </td>

  <td>
    Javaエージェントはデフォルトのイベントと属性をダッシュボードに送信します。または、[クエリビルダーでNRQLクエリを実行](/docs/query-your-data/explore-query-data/query-builder/use-advanced-nrql-mode-specify-data)できます。高度な分析のために、[カスタムイベントを記録](/docs/insights/insights-data-sources/custom-data/insert-custom-events-new-relic-apm-agents)することもできます。
  </td>
</tr>

<tr>
  <td>
    [合成のモニタリング](/docs/synthetics/new-relic-synthetics/getting-started/introduction-new-relic-synthetics)
  </td>

  <td>
    [合成トランザクショントレース](/docs/synthetics/new-relic-synthetics/using-monitors/collect-synthetic-transaction-traces)は、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。
  </td>
</tr>
製品
[ブラウザのモニタリング](/docs/browser/new-relic-browser/getting-started/introduction-new-relic-browser)