Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
New Relic supports WildFly 8.0
The Java Agent now provides instrumentation for WildFly 8.0. You will see the same great visibility into your web transactions, app server stats, and frameworks that you have with previous versions of JBoss.
Fix: PostgreSQL explain plan bug
Fixes PostgreSQL bug that allowed parameters to be sent in explain plans under some circumstances. Parameters are now masked prior to sending when explain plans are enabled (explain_enabled: true) and record_sql is set to 'obfuscated'.
Fix: SQL parameter obfuscation didn't work if the parameter value contained a newline
The record_sql: obfuscated config setting did not properly mask parameters when it included a newline character. This bug has been fixed.
Agent no longer supports obfuscation of individual fields
Previous versions of the agent allowed an obfuscatedsql_fields option to select specific field names to obfuscate when record_sql: raw. We have discovered rare cases in which this feature would not mask SQL parameters correctly, so we have removed the configuration option. Now, if obfuscated_sql_fields is set, the setting of record_sql: raw is ignored and _all fields are masked.
Fix: In some cases, an agent could fail to reconnect to New Relic
Fixed several issues that in rare cases could cause the agent to cease reporting data until JVM restart.
Fix: Transaction name specified in XML configuration was being ignored
In some cases transaction names set in XML files in the extensions folder were being ignored. This bug has been fixed in this release.
Fix: Jetty 9.1 transactions were not showing up in 3.3.x or higher agents
Starting with the 3.3.1 agent, customers were not seeing transactions from Jetty 9.1. This bug has been fixed.
Fix: Websphere 7.0 was not being instrumented
Starting in agent version 3.3.0, WebSphere 7.0 was not being instrumented. This bug has been fixed.
Fix: Solr tabs in UI not always appearing
If you are running a Solr application and not seeing any tabs, please update to this version.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End of life policy.
Notes
Fix: Solr caches and Solr updates data not appearing
Starting with version 3.4.1, Solr caches and updates were not appearing in the UI. This bug has been fixed.
Fix: JVM tab thread pool, session, and transaction data not appearing
Starting with version 3.4.1, some data was not appearing under the JVM tab. This bug has been fixed.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: In some cases, Play 2.2 didn't report transactions
When a chain of promises resolved, specifically using Future.flatMap(), lingering promises prevented the transaction from completing, in which case the transaction wouldn't be reported for the app. This is now tracked correctly.
Fix: Improved performance when instrumented code is not running in a transaction
Avoids unnecessary work when code instrumented by the Java agent is not running in the scope of a transaction.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: Java agent should honor enable_auto_app_naming
Starting with Java agent 3.3.1, the enable_auto_app_naming flag was being ignored. This bug has been fixed.
Fix: Setting configuration properties in newrelic.yml configuration file.
Starting with version 3.0, some properties such as max_stack_trace_lines could not be set in the newrelic.yml configuration property. This bug has been fixed.
Fix: Java agent should honor JAX-RS annotations with New Relic annotations
New Relic's Java agent should handle methods that contain a New Relic annotation along with a JAX-RS annotation correctly. Previously the New Relic annotation was being ignored.
Fix: Play transaction does not complete until timeout expires
New Relic's Java agent now handles firstCompletedOf to Futures correctly.
Additional functionality to API call addCustomParameter
New Relic's API call addCustomParameter will now add the custom parameters to New Relic. For more information, see http://newrelic.com/software-analytics
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: Duplicate annotation exception
In some rare cases involving generated a proxy class, the application may encounter an exception
AnnotationFormatError: Duplicate annotation for class
That bug has been fixed in this version.
Fix: VerifyError
In certain cases such as the Wildfly app server, the application may encounter a VerifyError. That bug has been fixed in this version.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
JMS Messaging
New Relic now gives you insight into the performance of your JMS message processing, both incoming and outgoing messages.
New Relic now shows transactions initiated via JMS 1.1 message receipt. These transactions show up in the New Relic UI as background tasks of type "Message". In addition, JMS 1.1 message creation is shown in transaction traces.
Grails 1.3.7 to 2.3.x
New Relic now provides first-class visibility into your Grails applications. Grails web transactions are now named based on the Grails controller. The transactions track the details of your calls to JDBC, Hibernate, and other important frameworks, and provides full access to the New Relic Java agent API from Groovy. Grails installation instructions can be found here
Updated instrumentation for supported app servers
New Relic has updated the instrumentation of the application servers we support. In the process, we have updated the list of app servers that we instrument. For a current list of supported app server versions, see https://docs.newrelic.com/docs/java/new-relic-for-java
Fix: New Relic did not instrument Apache HttpClient 4.3
Previous versions of the agent did not instrument HttpClient 4.3.x. That version is now properly supported.
Fix: Java Agent failed on Weblogic with a certicate exception
In some cases running Weblogic, the Java Agent would fail certificate validation when connecting to New Relic. That bug has been fixed.
Fix: Java Agent suppressed application logging
In version 3.2.3, the Java agent sometimes suppressed application logging. That bug has been fixed in this version.
Fix: Java Agent was logging error messages regarding "weaved classes"
In version 3.2, the Java agent wrote innocuous error messages to its log similar to the following:
ERROR: javax/servlet/ServletOutputStream is marked as a weaved class, but no methods are matched to be weaved.
That bug has been fixed in this version.
Fix: Text instructions in the sample newrelic.yml file were improved
If you are upgrading from a previous version of the agent, consider applying your configuration to this new version of the yml file.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: JBoss 7 fails to start with Java 1.6
Starting with version 3.2.0 of the Java agent, JBoss 7 application servers fail to start when running Java 1.6. An IllegalStateException is printed to System.out. This bug has been fixed.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: Play 2.2 instrumentation in action methods
In version 3.2.0 and 3.2.1, the Java agent failed to instrument calls present in a controller's action method. This means database calls, external calls, and custom instrumented calls within the action method were not being reported to New Relic. This bug has been fixed.
Fix: Invalid exclusive time errors with Play 2.2
In version 3.2.0 and 3.2.1, the Java agent sometimes reported error messages to the newrelic log indicating an "Invalid exclusive time". This error has been fixed.
Fix: Inaccurate async wait time with Play 2.x
In version 3.2.0 and 3.2.1, the Java agent reported an async wait time for Play 2.x transactions that was too large. This bug has been fixed.
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Fix: Exceptions thrown from conflicting JAXB versions
The New Relic Java agent now supports customers using any JAXB or Xerces version. This bug was introduced in version 3.1.0.
Fix: Usage of the newrelic.bootstrap_classpath system property
In version 3.2.0, the newrelic.bootstrap_classpath system property caused an IllegalAccessError. That bug has been fixed. Note also that this system property has been deprecated and should not be used.
Fix: Data collection for customers using the IBM JVM without WebSphere
New Relic now supports customers using an IBM JVM without running WebSphere. In this scenario, you must set the sync_startup flag set to true in the common section of their newrelic.yml.
sync_startup: true
Important
The end-of-life date for this agent version is July 29, 2019. To update to the latest agent version, see Update the agent. For more information, see End-of-life policy.
Notes
Glassfish 4 metrics for JVM Memory, Thread Pool, and Transactions
New Relic now displays JVM memory, thread pool, and transaction metrics for Glassfish 4. To expose these metrics, please set http-service, transaction- service, and web-container monitoring within Glassfish to high. To see the metrics in New Relic, go to Monitoring > JVMs.
Decreased agent overhead for Play 2
This version of the agent reduces the overhead that it incurs on Play 2. Play 2 users should upgrade for improved performance.
In addition to general overhead improvements, New Relic has introduced a new setting to reduce overhead even more for particularly low-latency applications. Note that this setting will make the call info in Trace Details more generic.
transaction_tracer:stack_based_naming: falseManually disable auto RUM instrumentation for specific pages
For supported JSP engines, New Relic automatically adds RUM (Real User Monitoring) elements to the response HTML. If you like auto-RUM, but do not want to apply it to all pages, you can now disable it for select pages. The configuration property disabled_auto_pages in the browser_monitoring section can now be used to disable auto RUM instrumentation for a comma delimited list of pages. For example,
browser_monitoring:disabled_auto_pages: page1.jsp, page2.jspakka.actor.ActorKilledException is now ignored by default
The ActorKilledException is commonly thrown in Play applications as a control mechanism in normally functioning applications. In previous versions, this exception inflated the reported error rate. These exceptions are now ingored by default. You can override the default ignore_errors list to provide your own exceptions or to omit the ActorKilledException.
error_collector:ignore_errors: some.other.MyExceptionNew Relic reports host capacity information
New Relic now reports physical CPU cores, logical CPU cores (hyperthreads), and physical memory. On non-Linux platforms, the agent runs a subprocess to retrieve this information. To see the info in New Relic, go to Settings > Environment > Environment Snapshot.
Report JVM name and revision to New Relic as part of JVM description
Recording the JVM name in addition to the vendor allows differentiation between different JVMs from the same vendor. To see these values in New Relic, go to Settings > Environment > Environment Snapshot and look for the "Java VM" and "Java VM Version" settings.
Fix: Support for Play 2.2
Web transactions were not being correctly captured under some circumstances for Play 2.2 applications. Web transactions are now correctly reported. Also note the change in command line syntax as of Play 2.2: https://docs.newrelic.com/docs/java/play-installation-for-java
Fix: Background tasks created by an @Trace annotation with a 'metricName' element did not show up in the New Relic UI.