Compatibility and requirements for the Java agent

Use New Relic to monitor your Java applications and gain visibility on their performance. Before installing the Java agent, make sure you meet the following requirements.

App/Web servers

Frameworks

  • Spring 3.x to 4.x
  • Struts 2
  • CXF
  • Jersey 1.x to 2.x
  • JSF (Java Server Faces)
  • Grails 1.3.7 to 2.3.x
  • Play 1.2.4
  • Play 2.0.3 to 2.5.x
  • Hystrix 1.0.2 to 1.4
  • Thrift 0.8.0 or higher

JDBC drivers

Capture of explain plans for slow database queries is only supported for MySQL and PostgreSQL at this time.

  • Generic JDBC (any JDBC compliant driver)
  • DB2 9.1 - 10.x
  • Derby 10.6.1.0 - 10.x
  • H2 1.0.x - 1.4.x
  • HSQL 1.7.2.2 - 2.x
  • INet Oracle Driver (Oranxo) 3.06, 3.14
  • INet MERLIA 7.0.3, 8.04.03 and 8.06
  • jTDS 1.2 - 1.3.x
  • MySQL mysql-connector-java-5.1.4 or higher
  • MariaDB 1.1.7 - 1.3.x
  • Microsoft SQL Server 2.0 - 4.2
  • Oracle ojdbc14, ojdbc5, ojdbc6, ojdbc7
  • Postgres postgressql-8.x - 9.x
  • Sybase (jConnect) JDBC 3 driver

JVM

Fully supported:

  • Oracle Hotspot JVM versions 6 to 8 for Linux, Solaris, Windows, and OS X
  • IBM JVM version 6 to 7 for Linux
  • Apple Hotspot JVM version 6 for OS X

Supported only with Java agent 2.21.x [ZIP | 2.8 MB] legacy agent:

  • Oracle Hotspot JVM version 5.0 for Linux, Solaris, Windows, OS X (Java SE 5.0)
  • Oracle JRockit up to and including 1.6.0_50

Hosting services

Other instrumented features

Akka 2.0 to 2.4 async tracking JMX
Akka HTTP 1.x to 2.5.x JSP (Java Server Pages) 2.0 to 2.2
Amazon S3 (Simple Storage Service)

MongoDB 2.12.0 to 2.13.3, 3.1

(3.0 is not supported)

AsyncHttpClient 1.0.2 - 2.x OkHttp client 3.0-3.4
DataStax Cassandra 2.1.2, 3.0 (if you use high security, see slow_query_whitelist) Quartz Job Scheduler 1.8.3 to 2.2.x
EJB Session Beans 3.0 RabbitMQ 2.7 to 3.x (AMQP and JMS)
Hibernate 3.x to 4.x Scala 2.9 to 2.10 async tracking
HttpClient 3.0.1 to 4.x Slick 3.x
java.net (HttpURLConnection) Solr 1.4.0 to 6.3
JCache API Spray 1.3.x
Jedis 1.4 to 2.7.2 (Redis client) Spray-client 1.3.x
JMS 1.1 and Spring-JMS

Spymemcached 2.11 to 2.12

JAX-RS 1.0 to 2.0

Security requirements

As a standard security measure for data collection, your app server must support SHA-2 (256-bit). SHA-1 is not supported.

For more help

Additional documentation resources include:

Join the discussion about Java monitoring in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at support.newrelic.com.