Java Release Notes

Recent Java agent release notes are listed below. If you would like a release that has been used extensively with a list of known issues, see Established releases (Java) for download link and version information.

2017, July 25 - 11:06 Download

Improvements

  • Vert.x

    The Java agent now provides visibility into your applications built using the Vert.x toolkit (supported versions 3.3.0 through 3.4.2). The agent instruments Vert.x Web, Vert.x Core, and Vert.x HTTP client. With this instrumentation, the agent will identify and name your transactions based on Vert.x web routing paths. The agent will also time web handlers, track async handlers, and external calls made with Vert.x HTTP client.

  • Slick

    With this release, the Java agent now supports Slick 3.2

  • API

    Added ExtendedRequest API class to report content-length for HTTP responses. See Transaction.setWebResponse API for more details.

Bug fixes

  • Fixed bug in Netty instrumentation that cause erroneous reporting of NettyDispatcher transactions. This affected transactions responding large incoming requests.

  • Fixed bug that caused agent to not report error rate metrics. The UI would show application errors, but error rate would show up as 0%. This was introduced in 3.38.0.

2017, June 26 - 10:58 Download

Improvements

  • DynamoDB

    The Java agent now provides visibility into your applications’ usage of DynamoDB when using the client versions 1.11.106 and greater. You will see the calls in the application breakdown, in trace details, on the Databases page, in Transaction maps, and in Service maps.

  • Solr

    With this release, the java agent now supports Solr versions 6.5.0+.

Bug Fixes:

  • Fixed an instrumentation gap that prevented agent from capturing instance-level information about database queries for non-blocking IO driver configurations.
  • Fixes an issue where usage onCompleted handler(s) with the ning async http client could cause a transaction to end too early, resulting in missed instrumentation.
2017, May 30 - 14:23 Download

Fixes:

  • Fixed an issue in which the agent could in rare cases send a raw SQL query as a transaction attribute when an error was thrown
2017, May 23 - 10:13 Download

Bug fixes

  • Fixed an issue in which setting "agent_enabled" to false in newrelic.yml caused an IncompatibleClassChangeError in the application on startup. The agent can now be disabled without side-effect.
  • Fixed an issue where the agent throws an exception if null keys or values are passed to the recordCustomEvent() API. The agent now ignores these null values.
  • Fixed a rare issue where the agent throws a NullPointerException in the application during JDBC calls. The agent now reports these calls but may report an “Unknown” database.
  • Fixed an issue where a VerifyError is thrown in the application code when using Spring or JAX-RS annotations on a Kotlin method with a default parameter.
  • Fixed an issue where external HTTP metrics could be reported outside of a transaction when using HttpURLConnection. The agent now ignores these calls.
2017, April 24 - 09:30 Download

Improvements

  • Expected Errors

    This release provides you with several flexible error configuration options to control how your errors are reported. With this addition, you can now configure certain exceptions that you expect your application logic will throw. These “expected errors” will not be counted towards your application error rate and Apdex; you will only be alerted on errors that truly affect the health of your application.

    Expected errors can be configured by exception class or HTTP response code. When specifying an exception class, you can provide an error message to match. See the documentation for details.

  • Custom CA Bundle

    A path to a custom SSL certificate bundle can now be specified in the agent configuration by using the following top level configuration:

      ca_bundle_path: /path/to/ca/cert/bundle.pem
    

Fixes

  • Fixed a bug where applications running on Tomcat could see duplicated or misnamed transactions for async endpoints.
  • Fixed a bug that caused transactions to report with an inflated apdex. The affected transactions had to meet the following conditions:
    • A status code >= 400
    • No error set on the transaction
    • markResponseSent() or addOutboundHeaders() was not called from the API

      In this case, the agent will now consider that transaction call to be frustrating for the purposes of calculating apdex.
  • Fixed a bug where the loaded class count on the JVM tab is reported as a much larger value than the actual number of loaded classes. In certain circumstances this bug can cause memory and CPU over-utilization.
  • Fixed a bug where response times in ServletRequestListener.requestInitialized() would incorrectly appear much larger than the actual values when using JBoss.
2017, March 29 - 11:25 Download

Improvements

  • Async APIs
    This release adds new APIs for instrumenting asynchronous work. If your transactions have asynchronous work (such as database queries or external calls) that is not automatically monitored by the Java Agent, you can use the APIs to link that work to your transactions. For more information, see the documentation.
  • OkHttp 3.6
    This release adds support for OkHttp 3.6.x. You will now see OkHttp 3.6 calls as external calls in New Relic.

Fixes

  • Fixes an issue where applications running on Tomcat 8.5 could see duplicated or misnamed Transactions for async endpoints.
  • Fixes an edge case issue where users of Spring AOP can get an UndeclaredThrowableException when using the Java Agent.
  • Fixes root and current working directory jars not showing up in the UI.
  • Fixes an issue which prevented the Solr updates and Solr caches tabs from displaying in the New Relic UI for applications that are reporting Solr data for the first time.
2017, February 15 - 09:55 Download

Improvements

  • APIs

    This release adds a number of APIs that will allow you to instrument and get expanded visibility into frameworks, libraries, and any custom code that New Relic does not automatically instrument. In addition to instrumenting your web frameworks, you can also instrument calls to and from messaging systems, database calls, and external calls! By passing context about your code to the APIs, you will get the same reporting, including cross application tracing, that you get with New Relic’s built-in instrumentation.

  • Solr

    This release adds support for Solr versions 5 and 6 (up to and including version 6.3.0).

Fixes

  • Fixes a bug that prevents an application from starting up when a JAX-RS annotated method contains more than 8 parameters.

  • Fixes an issue that affected Spring and JAX-RS applications compiled with the Java 8 flag javac -parameters. The issue would cause the application to throw a java.lang.reflect.MalformedParametersException exception.

  • Fixes bug that affected applications implementing JAX-RS endpoints using static methods.

  • The agent now reports WildFly dispatcher name and version.

  • Fixes a bug in which Queue Time could be misreported on the Overview page for customers injecting the X-Queue-Start or X-Request-Start HTTP headers. This fix brings the Java Agent into compliance with the behavior of other New Relic Agents.

  • Fixes an issue in which custom Hystrix Commands that are subclassed multiple times in Groovy cause an application to throw an exception on startup.

2017, January 17 - 07:00 Download

Note

If you are using Spring AOP, Jersey, or any JAX-RS framework, use this 3.35.2 release rather than 3.35.0 or 3.35.1.

Fixes

  • Fixes an issue where an application can fail to start with a:

    java.lang.VerifyError: Bad local variable type error

    when using Spring AOP, Jersey, or any JAX-RS framework with Java Agent 3.35.0 or 3.35.1.
2017, January 12 - 16:15 Download

Known Issue

This release contains a bug that could cause the app to fail with a VerifyError. Please use version 3.34.0 instead.

We will release a fix for the issue when we have thoroughly tested the fix for edge cases.

Fixes

  • Fixes an issue where an application can fail to start with a ClassFormatError when using Spring, Jersey, or any JAX-RS framework with Java Agent v3.35.0.
2017, January 11 - 11:35

Improvements

Known Issue

Several customers have reported an issue with this release in which the app fails with a ClassFormatError. For this reason, this release is not recommended and has been removed from New Relic's download site. Please use release 3.34.0 instead.

We keep the note here because the 3.35.0 is still available on the Maven Central Repository.

We will release a fix for the issue as soon as possible.

Changes

  • JAX-RS/Jersey 2

    This agent release officially adds support for JAX-RS 1.1-2.0.

    The release instruments the @Suspend annotation when using the Jersey 2 implementation of JAX-RS.

  • OkHttp 3.5

    This release updates our instrumentation to cover OkHttp 3.5.

Fixes

  • Fixes an edge case in Spray Client instrumentation where a NullPointerException was being thrown into customer logs

  • Fixes a potential StackOverflowException from Netty instrumentation when calling ServerBootstrap.bind() many times

  • Fixes a bug that prevented display of JMX metrics for Oracle WebLogic Server 12.2

  • Fixes issue where SQL parsing would throw a StackOverflowError and prevent large database statements from being sent up to New Relic

  • Improve performance of complex SQL statement parsing in the agent, reducing overhead for apps that make many SQL calls

2016, December 14 - 13:06 Download

Improvements

  • Solr

    The agent now reports database instance information for Solr. With the additional database instance information, transaction traces and slow query traces will provide the database server and database name for the queries displayed.

  • IBM JDK 8 Support

    The newest versions of WebSphere Application Server and WebSphere Liberty Profile ship with the IBM JDK 8. This release is compatible with IBM JDK 8.

Fixes

  • Fixed an issue in which asynchronous instrumentation could interact with instrumentation for JDBC ResultSet or a limited set of other frameworks, leading to loss of transaction reporting.

  • Fixed an issue in which transactions that executed the Spring Framework error handler could be given a generic name. These transactions will now retain their previously-assigned name.

  • Fixed a bug introduced in 3.33.0 where use of the X-Ray sessions feature could cause the Agent to stop reporting transactions.

  • Fixed a bug in the agent that prevented Error Events from linking to corresponding Traced Errors when created outside of a transaction

  • Fixes a Tomcat-specific issue where Transactions would incorrectly report extremely long response times in the ServletRequestListener.requestInitialized() method.

  • Improved metric grouping issues in several frameworks including Akka tell calls.

  • Fixed bug in noticeError API. The agent now includes custom attributes in errors when the API is called outside a Transaction.

  • Fixed an issue where custom XML instrumentation could cause a null pointer exception in application code when custom attributes are set for a method that passes a null parameter.

  • Fixed an issue in the Agent API method recordCustomEvent() that could cause loss of custom events created using this API. Customer who do not use the recordCustomEvent() API are not affected. Previously, unexpected argument types could result in the loss of both the event and additional custom events recorded in the same 1-minute period. As a result of this fix, users of the recordCustomEvent API may discover that events that have never been visible in the Insights API become visible.

Known issues

  • Fixed in 3.35.2

    • Applications that use the Spray Client instrumentation may throw a NullPointerException into customer logs
    • Applications that use the Netty instrumentation may get a StackOverflowException when calling ServerBootstrap.bind() many times
    • Oracle WebLogic Server 12.2 applications will not display WebLogic specific JMX metrics
    • SQL parsing may throw a StackOverflowError and prevent large database statements from being sent up to New Relic
  • Fixed in 3.36.0

    • Queue Time may be misreported on the Overview page for applications injecting the X-Queue-Start or X-Request-Start HTTP headers
    • Applications that have custom Hystrix Commands that are subclassed multiple times in Groovy can cause an application to throw an exception on startup
  • Fixed in 3.37.0

    • Solr: Applications that use Solr and have reported to New Relic APM previously with an agent version prior to 3.34.0 will not display the Solr page
2016, November 2 - 14:06 Download

Improvements

  • Database instance reporting

    The agent now reports database instance information for most supported databases. With the additional database instance information, transaction traces and slow query traces will provide the database server and database name for the queries displayed. You will see instance-level information when connecting by using the following drivers:

    • Any JDBC driver, including those in our compatibility doc.

    • DataStax Cassandra driver (2.1.2, 3.0 to 3.1).

    • Jedis Redis driver (1.4 to 2.9).
    • Mongo (2.12.0 to 2.13.3, 3.1 to 3.3).
    • Spymemcached (2.11 to 2.12). Note that instance-level information is not reported for calls to the getBulk API method..

Bug fixes

  • Fixed a bug in Play 2.5 instrumentation that could cause the agent to report shorter response times when using Action.async.

  • SQL stored procedure names are now reported in more edge cases such as “exec @param = stored_procedure”

  • Fixed an issue where explain plans were not being executed for versions 9.0-9.3 of PostgreSQL.

  • Fixed an issue where the agent could cause a Mule application request to fail with a NotSerializableException reported in the application log.

  • Fixed an issue where JVM versions that do not support ThreadCpuTime() would throw an UnsupportedOperationException, preventing the JVM from starting.

  • Fixed a potential memory leak in versions of Jetty 7 and 8 when using CometD.

  • Fixed an issue where the Hystrix toObservable method was double counting metrics on newer versions of Java 7 and all versions of Java 8.

2016, September 19 - 14:31 Download

Improvements

  • WebLogic

    This release adds official support for WebLogic versions 12.2.x

  • Performance Improvements

    Improvements in Java agent startup time, particularly on modular ClassLoader architectures (such as JBoss)

Fixes:

  • Fixed bug in spymemcached instrumentation that would incorrectly name segments in transaction traces that contained “get-and-touch” operations.

  • Improved Play 2.5 instrumentation

    • Fixed memory leak for large POST requests.
    • Fixed incorrect response times. Previously, large uploads could cause inflated response times.
    • The agent now tracks PlayRequestHandler and no longer shows the short-lived NettyDispatcher transactions.
  • Fixed a bug that could cause cross application tracing to display URLs as “Unknown” in transaction traces when the URL did not include the port number.

  • Fixed a bug in Jetty 9.3 instrumentation where transactions were not reported and memory was leaked if an incoming async request was wrapped by a framework or Jetty itself.

2016, August 10 - 15:07 Download

Fixes

  • Fixed a bug that caused a StackOverflow exception for drivers that execute a query on Connection.getMetaData().

Note: This issue was introduced in Java agent version 3.30.0.

2016, August 3 - 12:17 Download

Improvements

  • Mule ESB 3.6-3.8 including the new HTTP Connector

    This release adds instrumentation for Mulesoft Mule ESB Server versions 3.6-3.8, including the new HTTP Connector made available in Mule 3.6. This release continues to support the old HTTP Transport. Mule ESB Server instances will appear as "dispatchers" on the overview page and the JVM metrics page. Requests to an HTTP (operation-based) Connector will show in New Relic as web transactions. All of the usual features of New Relic APM are supported including alerting, error reporting, JMS puts and takes, cross application tracing, transaction traces, key transactions, external services, and database call reporting.

  • OkHttp client 3.0-3.4

    This release adds instrumentation for OkHttp client for versions 3.0-3.4. Both synchronous and asynchronous calls are supported, as well as the usual features for HTTP clients in New Relic APM such as cross application tracing and the external services page.

  • Akka HTTP 2.4.5

    The Java agent now reports and names transactions received through Akka HTTP 2.4.5, in addition to previously available Akka HTTP support.

  • Spring transaction naming

    The java agent now supports naming transactions based on the path element of Spring RequestMapping annotation.

Fixes

  • Fixed an issue that was preventing Jetty JMX threads metrics from being pulled in later versions of Jetty 9.X.
  • Fixed bug in the recordMetric API that in rare cases could start an unwanted long running transaction.
  • Fixed a memory leak in the Async Servlet instrumentation.
  • Fixed a bug in the setRequestAndResponse API that could throw a java.lang.NumberFormatException in the customer’s application when the circuit breaker trips.
2016, July 20 - 15:24 Download

Fixes

Fixed a security issue that could send external HTTP request parameters to New Relic via transaction traces for applications that do all of the following:

*For Java agent versions 3.6.0-3.25.0, this issue only affects cross-application traces.

Recommended for applications that may include sensitive information in external service call request parameters.

If you can’t upgrade the agent immediately, there are a few workarounds:

You can also delete existing transaction traces.

2016, June 28 - 09:55 Download

Improvements

  • Mule ESB 3.4 - 3.6

    This release adds instrumentation for Mulesoft Mule ESB Server versions 3.4 through 3.6. Requests to an HTTP Transport will show in New Relic as web transactions. Mule ESB Server instances will appear as "dispatchers" on the overview page and the JVM metrics page. All of the usual features of New Relic APM are supported including alerting, error reporting, JMS puts and takes, cross application tracing, transaction traces, key transactions, external services, and database call reporting.

    NOTE: The newer HTTP operation-based Connector is not yet supported.

  • Play 2.5

    This release adds instrumentation for the Play 2.5 framework. The previous Java Agent release supports versions of Play up to 2.4.

  • Cassandra async 2.1.2+ and 3.x

    This release adds instrumentation for asynchronous queries in versions 2.1.2+ and 3.x of the Datastax Cassandra driver, including slow query support. You’ll see relevant breakdowns in the overview chart, entries on the Databases page, and segments in transaction traces.

  • Async Http Client 2.x

    This release adds instrumentation for external service calls made using Async Http Client versions 2.x. If the called external service is also running New Relic, you will see cross application tracing details as well. This instrumentation will also capture external calls made from Play WSAPI (which uses Async Http Client).

  • Transaction traces for key transactions

    If you set an Apdex value for a key transaction, the agent will now capture transaction traces based on that key transaction's Apdex value if it's smaller than the application’s Apdex value.

  • JDBC performance and overhead improved

    This release offers better performance and lower overhead of JDBC instrumentation, especially in situations with large numbers of connections.

Fixes:

  • Fixed multiple issues related to Java Agent logging including:

    • ClassCastExceptions thrown into customer application logs
    • Agent logging being diverted into customer application logs
  • Fixed a bug where transactions could timeout during agent harvest, resulting in missing metrics and logging: "Traced activity timed out after 600 seconds. The traced_activity_timeout configuration parameter can be used to adjust this timeout.”

  • Resolved Metric grouping issue in Spray/Akka tell instrumentation. The agent now names temporary actors "temp".

  • In rare cases a ClassCircularityError could be induced by the agent when running with a custom security manager.

  • Fixed issue where a database connection can get labeled as "JDBC" instead of the more specific, supported database type such as "MySQL" or "PostgreSQL". This issue specifically affects customers running with a proxying or delegating JDBC connection.

2016, May 24 - 11:39 Download

Improvements

  • JDBC instrumentation

    • JDBC ResultSet instrumentation performance has been improved.
    • Instrumentation has been added for:
    • i-Net Merlia 7.0.3 database driver
    • Generic JDBC drivers
  • Cassandra

    This release adds instrumentation for the Cassandra Datastax 3.0 Driver including slow query support. You’ll see relevant breakdowns in the overview chart, entries in the Databases tab, and segments in transaction traces.

    Note: Uses of the client's async API are not currently supported.

Fixes:

  • Fixed a bug which caused some applications that use Play and Ning AsyncHttpClient to miss transactions.
  • Fixed an issue which would cause the thread profiler to not report data while profiling some Scala classes.
  • Fixed a rare bug where a RuntimeException is thrown during class transformation which can prevent some instrumentation from being applied.
  • Fixes a rare case where Tomcat ClassLoaders could leak memory when using a JDBC driver bundled in your application after reloading a web application.
2016, April 20 - 09:13 Download

Improvements

  • Cassandra

    This release adds slow query tracking to Cassandra queries made via the Datastax driver. You’ll now see slow CQL queries on the Databases page and within Transaction Traces. You must add the following to your newrelic.yml configuration to enable this feature in High security mode:

      transaction_tracer:
          slow_query_whitelist: 
           'com.newrelic.instrumentation.cassandra-datastax-2.1.2'
    
  • MongoDB

    The Java agent now reports synchronous calls made via MongoDB Java driver 2.14. You will see MongoDB represented on the Overview page, on the Databases page, and in Transaction traces. Note: The asynchronous driver is not yet supported.

  • Apache Tomcat

    This release adds support for Tomcat 8.5

  • Akka

    • This release adds support for Akka forwarding and Akka broadcasting. The agent will now trace messages broadcast or forwarded to actors.
    • When the system sends a message to an Actor, the agent now reports the name of the actor system that sent the message. Previously, the agent reported “deadletters” under these circumstances.
  • Async performance

    This release adds performance enhancements for asynchronous frameworks, especially Hystrix. Performance in Hystrix will noticeably improve for most applications, and will be up to 3x faster when tracing low-latency requests (response time <3ms). Performance for low-latency Play applications will be up to 30% faster.

  • JDBC

    This release adds support for the following JDBC drivers:

    • MySQL 6.0.2 and higher
    • i-Net Oranxo 3.06
    • i-Net MERLIA 8.04.03 and 8.06

Fixes

  • Fixed a bug that could cause Akka Http instrumentation to throw a NullPointerException into customer code.

  • Fixed a bug in the Spymemcached instrumentation that would report operations with the name “None” instead of the correct operation name.

  • Fixed a bug that could cause highly asynchronous applications to experience a memory leak in the NewRelic TransactionService.

2016, March 30 - 13:24 Download

Improvements

  • Spymemcached

    The Java agent now provides visibility into your applications’ usage of Memcached when using the Spymemcached client versions 2.11 to 2.12. You will see the calls in the application breakdown, in trace details, on the Databases page, in Transaction maps, and in Service maps.

  • JDBC Drivers

    This release adds support for the following JDBC drivers:

    • INet Oracle Driver (Oranxo) 3.14
    • Sybase (jConnect) JDBC 3 driver

Fixes

  • Fixed an issue where the agent treated HTTP headers as being case sensitive, causing CAT to miss under certain conditions.

  • Fixed an issue where error data could be dropped, causing 413 status code errors to be reported in the agent log.

  • Fixed a bug in spray-http and akka-http routing libraries where response times and/or route names could be reported incorrectly when using Futures within the route.

  • Fixed various issues related to the proper handling of multibyte character encoding.

  • Fixed a bug in Java agent version 3.26.x that could cause the Thread Profiler to time out.

  • Fixed a bug where an error could get printed to the agent log when making SQL queries from an asynchronous framework.

Notes

In support of an upcoming feature, the Java agent is now capable of reporting class metadata including class method signatures, method annotations, class annotations, field annotations, field types, and field names.

This reporting is off by default and can be explicitly disabled in the agent by setting the following property in your newrelic.yml configuration file:

  command_parser:
    blacklist: send_module_metadata

Pages