Android agent release notes

Android agent v1.338

Wed, 13 Mar 2013 00:00:00 +0000

Notes

Happy Pi Day!
Welcome to New Relic for Mobile Apps, we're glad to have you aboard.

Android agent v1.347

Fri, 29 Mar 2013 00:00:00 +0000

Improvements

Improved setup and configuration support, especially on Windows

Fixes

Fixes an issue where HttpURLConnection responses could raise an unhandled exception
Fixes an issue where reported response time is much shorter than actual response time under certain conditions
Fixes an issue where certain HTTP requests could raise an unhandled exception

Android agent v1.363

Wed, 08 May 2013 00:00:00 +0000

Notes

New Relic for Android is now compatible with Android 2.2 (API Level 8)

Fixes a scenario where the New Relic SDK could cause Android apps to crash when running on Android 2.2
Fully supports network activity instrumentation and reporting on Android 2.2

Android agent v2.397.0

Fri, 07 Jun 2013 00:00:00 +0000

Gradle and Android Studio support

Now you can add New Relic to your Gradle builds
Android Studio support via Gradle/Maven

Android agent v2.365

Fri, 31 May 2013 00:00:00 +0000

New Install Process

Eclipse plugin support
Maven Sonatype repository
Simplified Ant installation

Eclipse

Install via Eclipse plugin or Eclipse Marketplace
Debug in Eclipse with New Relic

Maven

Reference New Relic in pom.xml

Updated Agent API

Control when New Relic starts
Be sure to read our upgrade notes

Android agent v2.426.1

Wed, 11 Sep 2013 00:00:00 +0000

Improvements

Added support for ProGuard with Ant builds. *Note: Version 2.426.0 of the Android agent already works with ProGuard and other build systems (Gradle, Maven, and Eclipse).

Android agent v2.426.0

Thu, 27 Jun 2013 00:00:00 +0000

Improvements

The agent now detects if the app was instrumented properly and displays an error message if otherwise.
The Eclipse plugin now refreshes your project after installing/updating New Relic.
Improved post installation messaging in Eclipse.

Fixes

Fixes an issue in Eclipse on Windows where Eclipse is installed in a location with a space in the path.
Repackaged the agent with JarJar to prevent class space collisions.
Fixes an issue where a re-used HttpRequest object would have multiple X-NewRelic-ID headers added.

Android agent v2.433.0

Wed, 25 Sep 2013 00:00:00 +0000

Improvements

Added support for ProGuard with Ant builds.
Clarified naming of unknown carriers on Android

Android agent v3.214.0

Sun, 01 Dec 2013 00:00:00 +0000

Improvements

End to end instrumentation for your mobile applications.
Automatic instrumentation of important system objects and methods.
Customizability to allow for instrumentation of your most important objects and methods.

Android agent v3.239.0

Tue, 17 Dec 2013 00:00:00 +0000

Fixes

Call checkcast before invoking NR instrumentation.

This fixes an issue where the Dalvik VM refuses to load a class with our instrumentation in cases where the inbound object is not the expected type as determined by static code analysis.
Don't attempt to instrument constructors in subclasses of classes we normally instrument.

While we support instrumenting constructors by replacing the call to , we don't support doing this in subclasses. For now, we ignore these cases but may return to adding inline instrumentation to constructors in the future.
Java 7u60 (pre-release) refactored the class in which we were storing our invocation dispatcher.

We've future proofed the agent by storing the dispatcher in another core class.

Android agent v2.444.0

Thu, 21 Nov 2013 00:00:00 +0000

Fixes

Fixed rare bug in Eclipse where all projects are built with New Relic regardless of agent jar presence.

Android agent v3.308.0

Wed, 26 Feb 2014 00:00:00 +0000

Improvements

New API methods for adding cross application tracing headers to noticeHttpTransaction().

In case the New Relic agent doesn't support the HTTP API you're using, you can manually submit a transaction via the noticeHttpTransaction() method. With this release, this method now allows you to set the NR cross application tracing header for tracking purposes.

Fixes

Fixed a rare build crash where newly constructed objects go unused and are later optimized down by ProGuard.

Android agent v3.264.0

Thu, 16 Jan 2014 00:00:00 +0000

Improvements

New API method for configuring logging verbosity.

You can now choose how verbose the agent will be at boot by chaining withLogLevel() before your NewRelic start() call. The default level is INFO.
New API method for renaming inflight interactions.

Call NewRelic.setInteractionName() at the beginning of your onCreate() method to set a custom name for your interaction. This usually defaults to the name of the Activity subclass.
Method tracing optimizations.

We’ve carefully reviewed the code involved in tracing instrumented methods and reduced its CPU and memory overhead substantially.

Android agent v3.330.0

Tue, 11 Mar 2014 00:00:00 +0000

Fixes

Ensure interactions complete when an app leaves the foreground.

Previously, it was possible for an interaction to persist across application foreground/background lifecycles if a trace segment was still in flight. This resulted in interaction traces extending past the default 60-second limit. Now, interactions are stopped when the app leaves the foreground regardless of segment states.
Machine metrics continue generation upon app restore.

Machine metrics now continue to generate after an app has been in the background and enters the foreground. Previously, they were only generated from launch until the app entered the background.
Improve BitmapFactory instrumentation scoping.

BitmapFactory’s static method instrumentation is now scoped to more tightly to its package and class to prevent instrumentation of similar but unrelated method signatures.
Added more instrumentation to summary metrics.

Now all instrumented methods are included in summarized category metrics including those only present in background threads.
Added missing methods to HttpsUrlConnection instrumentation.

Several missing proxy methods have been added to our HttpsUrlConnection shim. This restores the ability to override default HTTPS behavior.

Android agent v3.361.0

Mon, 07 Apr 2014 00:00:00 +0000

Improvements

Better auto-naming support for Fragments.

Previously, separating fragments from the calling Activity required renaming the running interaction. Now, Fragments have first class treatment and will show up alongside Activities.
OkHttp instrumentation.

If you're using Square’s OkHttp library, you'll now see your HTTP transactions automatically appear on RPM. There’s no longer any need to use the agent API to track these transactions.

Fixes

Clear all metric caches after a failed harvest cycle.

In rare cases where the agent is unable to connect to New Relic's servers, some metric caches persisted and caused unusually large metric numbers. Now, all these caches are cleared at the end of the cycle to prevent compounding aggregation.
Improved inflight interaction naming.

There are some cases in which renaming a running interaction did not fully rename the metric scope. This fix ensures all aspects of the interaction bear the new name.
Fixed an issue in Proguard bytecode handling.

While compiling Android apps with Proguard's optimizations turned on is discouraged, the agent does its best to support such optimizations. However, we mishandled one such case and have fixed it in this release.

Android agent v3.378.0

Thu, 15 May 2014 00:00:00 +0000

Improvements

CPU vitals in Interaction traces.

We've added CPU vitals in interaction traces. You'll now be able to see your application's usage of the device's CPU(s) as a percentage of the total CPU time.

Fixes

Restore compatibility for building with Java 7u55 and support Java 8.

Java 7u55 introduced a slight change that broke our build process. We've corrected this issue and added support for Java 8.
Applications without version numbers crashed the agent.

Strangely, it's possible to build an Android application without a version number defined in the manifest. We now detect this case and shut down the agent cleanly with an error message indicating we require a version number.
Encode custom Http(s) error response bodies.

Http(s) error response bodies are normally encoded to ease escaping. However, errors reported via the API were not encoded. We've fixed this so all errors should appear properly in the UI.

Android agent v3.407.0

Thu, 12 Jun 2014 00:00:00 +0000

Notes

Improvements

API methods now check for bad values and throw IllegalArgumentException

Previously, our API methods would silently discard bad data without recording errors or metrics. We've changed this behavior to be more informative by throwing an exception when bad arguments are passed.

Fixes

Android Gradle plugin 0.10 compatibility

Version 0.10.0 of the plugin introduced a subtle change that caused errors during build time that would produce ClassCastException errors at runtime. We’ve fixed this issue and verified we're also compatible with 0.11.
- Improved thread safety in the API
Some API methods exhibited race conditions under heavy utilization. These race conditions are now solved.
- Summary metrics occasionally exhibited bad values
You may have noticed strange numbers in your application overview chart. We've isolated the cause of these numbers and fixed the underlying issue in the agent.

Android agent v3.419.0

Thu, 24 Jul 2014 00:00:00 +0000

Improvements

Naming changes to Interaction Traces

We've changed the naming scheme for Interaction Traces to be more clear. Instead of "ActivityClass#onCreate", you'll see "Display ActivityClass". If you want to change the name of a running Interaction, just call setInteractionName().
New API methods for starting and stopping Interaction Traces

We've added two new methods to the NewRelic class API to give you greater control over starting and stopping Interaction Traces. The startInteraction() method now just takes a string, no context needed. Use endInteraction() to stop a running interaction.
New @SkipTrace annotation to exclude methods from default instrumentation

While automatic instrumentation is one of the more convenient features of the agent, there are a few cases where it can get in the way. Should you encounter one of these cases, simply add this annotation to the method in question, and the agent will skip it during compile time instrumentation.

Android agent v3.429.0

Fri, 22 Aug 2014 00:00:00 +0000

Improvements

New Gradle Plugin

We've rewritten the New Relic Gradle plugin from the ground up to impose a smaller footprint on your build and improve compatibility with the new Gradle Daemon.

Android agent v4.120.0

Fri, 21 Nov 2014 00:00:00 +0000

Improvements

You can now disable the capture of the HTTP response body for requests by calling NewRelic.disableFeature(FeatureFlag.HttpResponseBodyCapture).
You can now disable crash reporting by calling NewRelic.disableFeature(FeatureFlag.CrashReporting).
The SDK was updated to accept the HTTP method in NewRelic.noticeHttpTransaction() and NewRelic.noticeNetworkFailure() allowing more detailed information to be collected.

Fixes

Resolves an issue related to recording a URL that could have potentially resulted in a Null Pointer Exception.

Android agent v4.178.0

Thu, 08 Jan 2015 00:00:00 +0000

Fixes

Addresses an issue that may have caused an upgraded application to continue reporting the older version of the application to New Relic.
Corrects a potential RuntimeException when the HEAD method was used in an HTTP request.
Resolves an IllegalArgumentException that could have occurred in the edge case where the start or end time of an HTTP transaction was invalid.

Android agent v4.190.0

Thu, 05 Feb 2015 00:00:00 +0000

Improvements

Improved instrumentation of the OkHttp library v1.6 to include support for OkURLFactory

Notes

This will be the last release of the Android SDK to support Android 2.2. Future versions will require 2.3+.

Android agent v4.265.0

Wed, 04 Mar 2015 00:00:00 +0000

Improvements

This release adds instrumentation for versions 2.1+ of Square's OkHttp library. 1.x versions continue to be supported.
This release also adds support for the Retrofit (1.8+) and Picasso (2.4+) libraries from Square.

Notes

With this release, the Android SDK will require a minimum version of Android 2.3. Apps requiring Android 2.2 can still use the legacy version of the New Relic Mobile Android SDK, 4.244.0 (instructions here). The legacy version will only receive critical updates if necessary.
Please note that versions 2.x of the OkHttp library require Android 2.3+ and Java 7. (see https://github.com/square/okhttp/blob/master/CHANGELOG.md#version-200)

Android agent v4.244.0

Thu, 19 Feb 2015 00:00:00 +0000

Improvements

A custom application version can now be set using the new method NewRelic.withApplicationVersion(String appVersion)
Added the method NewRelic.recordMetric(String name, String category) to allow recording a custom metric with just a name and category, the value defaulted to 1.

Notes

This release supports Android 2.2+. Future releases will require 2.3+.

Android agent v4.273.4

Wed, 08 Apr 2015 00:00:00 +0000

Fixes

Addresses an issue that could cause a null pointer exception when an empty response body was received using older versions of the Retrofit library
Corrects a potential ConcurrentModificationException during instrumentation when a large number of HTTP requests was made

Android agent v4.98.0

Wed, 29 Oct 2014 00:00:00 +0000

Fixes

Resolves a crash in InputStream instrumentation when chunked transfer encoding is used.
Custom interaction names, when specified, are now used in Crash interaction history trails.

Android agent v4.87.0

Wed, 08 Oct 2014 00:00:00 +0000

Improvements

Crash Reporting
- This release introduces crash reporting for mobile apps. Crash reporting supports capture and reporting of unhandled Java runtime exceptions.
- Crashes include interaction trails: a history of automatically instrumented actions that occurred during the app session leading up to the crashing event. No breadcrumbs needed.
- The SDK includes a NewRelic.crashNow() method to trigger a test crash quickly and easily.
- You can also disable crash reporting via the runtime API.
- When building an app with Proguard enabled, the Proguard mapping file is sent to New Relic to automatically provide human readable crash reports in the UI.
Session improvements
- The SDK now more consistently records MobileSession events in Insights when users use various app switchers on Android 4.x.

Fixes

Improve reported traffic accuracy
- Corrects an issue where the SDK could continue to report an app as active when it had entered the background. This fix will reduce the traffic reported for an app to more accurately reflect actual usage.
Improve thread naming accuracy
- Corrects an issue where the SDK reported some metrics with an incorrect display name. This fix will more accurately reflect thread breakdown data in interactions.

Android agent v5.0.0

Fri, 01 May 2015 00:00:00 +0000

Improvements

Insights for Mobile

This release introduces Insights for New Relic Mobile.

The Android SDK now automatically records Session, Interaction, and Crash events in New Relic Insights. After upgrading to this release, you will be able to build queries and dashboards in Insights with the new Mobile event type. All events include attributes reflecting session and unique install identifiers, device, OS, geography, duration and other data. See the Insights documentation for a description of Mobile attributes and Insights usage details.

Custom events

In addition to the standard events available in Insights, you can now record custom events. Custom events have a name and set of key:value attributes, perfect for capturing usage, monetization, and custom performance data. Custom events are also available in Insights. See the Mobile Custom Event documentation for details.

Custom attributes

In addition to event-specific attributes, this release provides support for install-scoped attributes. An attribute recorded in the app will be attached to every Session, Interaction, Crash, and Custom event reported from that instance of the app. Custom attributes are perfect for tracking durable information like account id, campaign origin, subscription level, etc. See the Mobile Custom Attribute documentation for details.

The Android API documentation includes details on sending custom events and attributes to Insights.

Android agent v5.0.1

Fri, 01 May 2015 00:00:00 +0000

Fixes

Corrects an issue where the timeSinceLoad attribute may not have been sent for Insights Events.

Android agent v5.0.3

Tue, 19 May 2015 00:00:00 +0000

Fixes

Fixes a crash resulting from empty body responses when using version 1.9 of the Retrofit library.
Corrects an internal issue with reserved attribute names. 'interactionDuration' is now a reserved attribute name.

Android agent v5.10.0

Thu, 12 Jan 2017 00:00:00 +0000

New in this release

Fixed instrumentation failures that occurred when building apps that used both Dexguard and the Android Retrolambda plugin.
Updated agent logging to remove noise and conform to Gradle logging conventions.
Adding --info or --debug to the Gradle build will result in more detailed logging messages.
Replaced Gradle agent plugin POM file missing from Jfrog Bintray artifact repository.
Agent and agent plugin are now built using JDK 1.8.

Android agent v5.1.0

Wed, 03 Jun 2015 00:00:00 +0000

Improvements

The Android SDK will now collect an app build identifier when an app crashes, which will be displayed in parentheses beside the version number in the Crash Details page in RPM. This value defaults to the string versionCode that is specified in the app's AndroidManifest.xml. If versionCode is not specified the build identifier not be displayed.
A new API method withBuildIdentifier(String) was added to allow specifying a custom app build identifier, overriding the default value pulled from versionCode.
Updates to unique ID management to improve accuracy of unique device counts.

Android agent v5.1.1

Fri, 05 Jun 2015 00:00:00 +0000

Notes

Resolves a compatibility issue that may occur when running apps on Android M preview.

Android agent v5.11.0

Tue, 28 Feb 2017 00:00:00 +0000

New in this release

Adds recording of network request error events

The agent now generates MobileRequestError events describing failures in network requests. This new event tracks networking and HTTP errors, and includes attributes for common request properties. More details can be found at Mobile Request Error Events.

Adds additional session attributes

lastInteraction allows you to see in Insights, what the most common exit screen was for customers across all sessions or a filtered selection of sessions.
appBuild allow developers to view the adoption of a new build, particularly if rolled out under an existing app version number. Originally, this was only available on crash events.
architecture and runTime allow you to see the hardware type and Java runtime version the of the device on which the app is running. Both values are taken form the device's system properties, and are useful for debugging device-specific issues.

Fixed in this release

Fix the minimum utilization instrumentation filter

Slow interaction trace capture relied on an incorrectly interpreted minimum utilization value. In some cases you may see more slow interaction traces than previous agent versions. Please reach out to support if you are not seeing slow interaction traces.
Fix crash when using OkHttp 3.2.0 web sockets

Although the Android agent does not officially support OkHttp versions prior to 3.4, this fix avoids crashes that may occur when including 3rd-party libraries that may depend on those versions of OkHttp.
Warn when agent and class rewriter versions do not match

Instead of halting a build of the application, the agent will warn of this benign scenario. Agent JAR version mismatch sometimes occurs when upgrading to a new agent version.
Fix ConcurrentModificationException crash

This change addresses a rarely seen crash that occurs during agent start-up.
Move remaining sampler shutdown to background thread

This change addresses a lag seen during interaction trace completion.

Android agent v5.1.2

Fri, 19 Jun 2015 00:00:00 +0000

Fixes

Resolves an issue where the connection type used by the app may have been incorrectly reported.

Android agent v5.12.0

Wed, 08 Mar 2017 00:00:00 +0000

New in this release

Updates to recording custom events

With this agent release, Mobile custom events are now recorded as their own event type in New Relic Insights. Until this release, custom events for New Relic Mobile were bundled under the "Mobile" event type (category='Custom'). This release includes a new method to be used for adding custom events: recordCustomEvent. The previously used method for this, recordEvent, is now deprecated. This update is to satisfy customer requests for:

Improved Insights query performance
Defining your own custom event names
Finding custom events in Insights more easily
Flexibility to define data retention per custom event type (1 day default; more with Insights Pro)

For this and the next several releases, we will continue to support the previous method for custom events (recordEvent) to avoid impact on your queries and existing dashboards.

Fixed in this release

Ignore BaseFragmentActivityGingerbread base class when auto-instrumenting activities.

Android agent v5.12.1

Thu, 23 Mar 2017 00:00:00 +0000

Fixed in this release

Fix a null pointer exception crash that occurred during completion of activity traces.
Optimize updates to the analytics attribute store.
OkHttp3 responses are no longer pre-buffered. Streamed responses without a content length header will report -1 for content length.

Android agent v5.12.2

Wed, 29 Mar 2017 00:00:00 +0000

Fixed in this release

Fix instrumentation failure when using Dexguard, Retrolambda and build product flavors.

Android agent v5.12.3

Fri, 21 Apr 2017 00:00:00 +0000

Fixed in this release

Validate custom event type names with the same rules as the backend service, reporting invalid event types to the user immediately. Previous agent versions would allow custom event type names that would be rejected by Insights during ingest. The name may be comprised of alphanumeric, space, ., : or _ characters.

Android agent v5.13.0

Wed, 10 May 2017 00:00:00 +0000

New in this release

Added a new MobileBreadcrumb event type that allows you to annotate the execution of your app, to help troubleshoot crashes and provide greater detail in Insights. See the recordBreadcrumb() API docs for more information.
Added an additional recordCustomEvent method that takes the event name as an optional parameter. This avoids the need to add a name attribute in the passed attribute set. See the recordCustomEvent() API docs for more information.

Android agent v5.14.0

Wed, 14 Jun 2017 00:00:00 +0000

New in this release

The agent now reports network request events to Insights! This feature must be enabled when starting the agent using the NetworkRequests FeatureFlag. When enabled all network calls will be tracked, in addition to network errors.

We've also added a new document that describes how to query network events from Insights. Mobile Request Query Examples provides useful queries for examining network request event data.

Fixed in this release

Ensure there is no shared activity history state between launched sessions.

Android agent v5.15.0

Mon, 02 Oct 2017 00:00:00 +0000

This release has been removed due to deployment issues with Jcenter. Please use release version 5.15.1 instead.

### New in this release

The agent has added API methods to report handled exception events to Insights! Details and examples of how to use the new APIs can be found in the Android SDK API document recordHandledException. We've also updated the document that describes how to query handled exception events from Insights: Insights query examples for New Relic Mobile provides useful queries for examining handled exception event data. Apps that use Proguard or Dexguard may have to make adjustments to their Proguard configuration to preserve all exception information. Please review Configure ProGuard or DexGuard for Android Apps for more details.
Added support for automatic instrumentation when using Android Gradle plugin version 3 (used by Android Studio 3).

### Fixed in this release

HttpURLConnection requests now return the correct status codes in MobileRequest events
Report carrier type as 'Unknown' if a valid carrier type can not be determined
Restore instrumentation of Android support classes (missing since version 5.13.0)

Android agent v5.15.1

Wed, 18 Oct 2017 00:00:00 +0000

New in this release

The agent has added API methods to report handled exception events to Insights! Details and examples of how to use the new APIs can be found in the Android SDK API document recordHandledException. We've also updated the document that describes how to query handled exception events from Insights: Insights query examples for New Relic Mobile provides useful queries for examining handled exception event data. Apps that use Proguard or Dexguard may have to make adjustments to their Proguard configuration to preserve all exception information. Please review Configure ProGuard or DexGuard for Android Apps for more details.
Added support for automatic instrumentation when using Android Gradle plugin version 3 (used by Android Studio 3).

Fixed in this release

HttpURLConnection requests now return the correct status codes in MobileRequest events
Report carrier type as 'Unknown' if a valid carrier type can not be determined
Restore instrumentation of Android support classes (missing since version 5.13.0)

Android agent v5.15.2

Wed, 08 Nov 2017 00:00:00 +0000

New in this release

The NetworkRequests feature flag is now enabled by default. The feature can still be disabled (and re-enabled) at any time if the additional MobileRequest events are not needed.
Added a feature flag for MobileHandledException events (FeatureFlag.HandledExceptions). Handled exception reporting is enabled by default; use this flag to globally disable the feature.

Fixed in this release

Crash reports are again uploaded immediately, rather than during the next scheduled harvest.
Correctly detects Proguard/Dexguard-enabled apps, and uploads their mapping.txt files to the symbol upload collector.
Restored missing instrumentation of Square Retrofit2 classes.
Added missing response codes from HttpURLConnection POST requests.
The MobileRequest event byteSent attribute has been renamed to bytesSent. Any Insights queries using byteSent must be updated to maintain accuracy.

Android agent v5.16.0

Thu, 14 Dec 2017 00:00:00 +0000

New in this release

MobileRequestError events now contain the response body returned in the network request response, if one exists. Response bodies will only be reported if the withHttpResponseBodyCaptureEnabled feature flag is enabled. HttpResponseBodyCapture is enabled by default. Response body data will be limited to the first 4096 bytes (the Insights attribute limit). A content type attribute will also be added to the event if a "content_type" header is found in the response.
MobileRequestError events now also contain any cross-application tracing (CAT) data returned in the response headers. See Introduction to cross-application traces for more information.

Fixed in this release

Stream file handle usage during class instrumentation has been tightened up to prevent potential resource leaks.
Proguard map detection of release variants when using AndroidStudio 3 has been restored.
Add content type parameter missing from HTTP error traces when instrumenting OkHttp2, OkHttp3 and Retrofit requests.

Android agent v5.17.0

Wed, 07 Feb 2018 00:00:00 +0000

New in this release

Added instrumentation support for Android Instant Apps The agent now detects and instruments all feature modules for an instant app. Because instant apps are typically side-loaded, users must add NewRelic.start() calls to each entry point activity in the module. We've also created a document to help integrate the agent into your Instant App. See Install the New Relic plugin for Android Instant Apps for more information.

Fixed in this release

Correctly restore any pre-existing unhandled exception handler when the agent shuts downs. Maintain the state of existing unhandled exception handlers when the agent returns to foreground.
Fixed instrumentation of abstract classes derived from Android SDK classes.
Fixed instrumentation failure when using certain Java 8 features, such as lambdas.
Updated instrumentation support for Dexguard 8 on Android Studio 3.0.
Enforce @SkipTrace with Android SDK-derived classes. Previously, onCreate() and onCreateView() could not be skipped from Activity, Fragment and other SDK classes.

Android agent v5.17.2

Wed, 14 Feb 2018 00:00:00 +0000

Fixed in this release

Fixed instrumentation failures introduced in the 5.17.0 release.
Corrected a hang during instant app shutdown that could occur during a crash.

Android agent v5.18.0

Wed, 07 Mar 2018 00:00:00 +0000

Fixed in this release

Addressed potential ANR at launch when an app has the Firebase performance monitoring SDK also running.

Android agent v5.17.1

Thu, 08 Feb 2018 00:00:00 +0000

Fixed in this release

Fixed trace instrumentation crash introduced in 5.17.0 release.

Android agent v5.18.1

Tue, 03 Apr 2018 00:00:00 +0000

Fixed in this release

Fixed problem reading from the error stream of instrumented Http/HttpsUrlConnection requests.
Fixed problems uploading Proguard/Dexguard mapping.txt files.
Eliminated a delay in shutting down the app when reporting a crash.

Android agent v5.19.0

Fri, 08 Jun 2018 00:00:00 +0000

Improvements

The agent will now recognize region-specific application tokens.

Android agent v5.19.1

Mon, 10 Sep 2018 00:00:00 +0000

Fixes

Fixes NoClassDefFoundError crash due to missing Apache classes for apps targeting Android 9 (SDK versions P or 28 ). This release is only needed by apps that target SDK 28 or higher.

Android agent v5.2.0

Wed, 29 Jul 2015 00:00:00 +0000

Improvements

The SDK now tracks the number and duration of network requests per interaction, which will be used in upcoming features.
Deprecates the NewRelic.shutdown() method, which will be removed from the API in a future release.

Fixes

Resolves a potential UI performance issue when experiencing low/no network connectivity.
Addresses a crashing java.lang.RuntimeException thrown while determining the root cause of an app crash.
Fixes a potential crash during trace collection resulting from a java.lang.ClassCastException.

Android agent v5.20.0

Mon, 15 Oct 2018 00:00:00 +0000

New in this release

Support for the Maven plugin is now deprecated, and will be removed in version 5.21.0.
The minimum supported SDK level (minSdkVersion) is now 14 (Android 4.0)

Fixed in this release

Removed dependency on legacy Android Apache library, which resulted in NoClassDefFoundError exceptions when targeting Android SDK 28.
Removed cast exception with OkHTTP2 CacheResponseBody when using Retrofit 1.9.0 with OkHttp 2.7.5 .
Corrected mismatched UUID added to Proguard/Dexguard mapping file (the map UUID didn't match the UUID of reported crashes).
Restored missing Dexguard lambda instrumentation.
Corrected representation of LONG numeric attributes to prevent loss of precision (agent could not record precise timestamp attributes).
Crashes that occur prior to successfully connecting to collector will be queued until a valid connection data token is received.
Restored agent shutdown and final harvest when foreground services present.

Android agent v5.21.0

Mon, 05 Nov 2018 00:00:00 +0000

New in this release

Add support for the upcoming Android D8/R8 toolset
Discontinue the New Relic Maven plugin
Disable CPU sampling for apps running on Android 8 and higher

Fixed in this release

Correct the mismatched build ID shared between the stamped and uploaded Proguard/Dexguard map file and submitted crashes
Fix an issue that caused a Facebook login API failure
Update agent plugin to address Gradle 5 warnings

Notes

Dexguard users must upgrade to version 8.2.22 to be compatible with this release.

Android agent v5.2.1

Wed, 05 Aug 2015 00:00:00 +0000

Fixes

Fixes a crash that occurred when attempting to cast the result of OkHttpFactory.open() to a javax.net.ssl.HttpsURLConnection, resulting in a java.lang.ClassCastException
Resolves a crashing java.lang.NullPointerException when the app is brought from background to foreground in a specific scenario

Android agent v5.21.2

Mon, 03 Dec 2018 00:00:00 +0000

Fixed in this release

Corrects a condition where a Gradle task would block when uploading Proguard/Dexguard map files

Android agent v5.21.3

Thu, 03 Jan 2019 00:00:00 +0000

Fixed in this release

Fixes build failure when Kotlin extensions are used
Eliminates a race condition that could result in ANR in apps that make many concurrent network requests

Android agent v5.22.0

Mon, 04 Feb 2019 00:00:00 +0000

New in this release

Updated instrumentation support for OkHttp to version 3.12.0
- Minimum supported versions are now OkHttp 3.5.0, and OkIO 1.11.0
Dependency JARs using signature validation are detected during instrumentation. The agent cannot instrument JARs that use signature validation when signed. JARs whose manifest contains SHA1-Digest or SHA-256-Digest manifest attributes will not be modified
Increase the number of available user attributes from 64 to 128

Fixed in this release

Fixes null pointer exception during map upload when the generated map file is empty, such as when Proguard is enabled, but obfuscation is disabled using the -dontobfuscate Proguard configuration setting.

Android agent v5.21.1

Mon, 26 Nov 2018 00:00:00 +0000

Fixed in this release

Corrects a problem detecting R8-generated map files
Removes unnecessary Proguard map file processing task

Android agent v5.22.1

Fri, 08 Mar 2019 00:00:00 +0000

Fixed in this release

Fixes an issue that caused lock contention on the main thread when an Activity or Fragment started during harvest.

Android agent v5.23.0

Mon, 06 May 2019 00:00:00 +0000

New in this release

Refactored New Relic Agent plugin to conform to Gradle 5

Fixed in this release

Fixed build crash that occurred during debug logging when using Dexguard versions 8.2 - 8.4
Eliminated erroneous exception logging for CountingInputStream implementations
Clarified documentation of analytic enablement options (FeatureFlag.AnalyticsEvents and NewRelic.withAnalyticsEvents)

Android agent v5.24.0

Tue, 24 Sep 2019 00:00:00 +0000

New in this release

Updated instrumentation to include Fragment and Activity classes derived from androidx support packages.
Updated 3rd party licenses information.

Fixed in this release

Fixed crash that occurred when the agent tried to instrument Kotlin module_info.class files.
Updated JSON instrumentation to address crash that could occur when using R8 tools.

Android agent v5.24.1

Mon, 28 Oct 2019 00:00:00 +0000

Fixed in this release

Clear up duplicate reporting of device data
Address a build failure when instrumenting apps using Gson 2.8.6
Exclude additional 3rd party packages from instrumentation (to address a D8 crash)

Android agent v5.24.2

Tue, 03 Dec 2019 00:00:00 +0000

Fixed in this release

Fixed a harvest error that occurred when the sum of all activity traces exceeded the default limit (64k characters), and filtering removed all traces.
Fixed a set of DEX failures that emerged when JSONObject(String) and JSONArray(String) invocations were instrumented. Unfortunately, the time spent in instance construction can no longer be reported as a result of the change.

Android agent v5.24.3

Tue, 18 Feb 2020 00:00:00 +0000

Fixed in this release

The agent now uploads mapping.txt files to New Relic when bundle tasks are used with Dexguard.

Android agent v5.25.1

Wed, 06 May 2020 00:00:00 +0000

Fixed in this release

Fixed detection of DexGuard-generated mapping.txt files ("mappingFile is null")
Update OkHttp request transaction state when interceptors are used
Improved visibility into obfuscation map uploads. Users can invoke the Gradle task newRelicMapUpload{Variant} (newRelicDexguardMapUpload{Variant} for DexGuard) to resend tagged obfuscation maps. {Variant} is dependent on configuration.
Toned-down plugin debugging messages inadvertently emitted as errors

Android agent v5.25.2

Mon, 18 May 2020 00:00:00 +0000

Fixed in this release

Fixed additional incompatibilities with DexGuard and AGP 3.6
Fixed automatic map uploads for some variants types, broken in the previous hotfix (our apologies)

Android agent v5.27.0

Thu, 03 Sep 2020 00:00:00 +0000

New in this release

Enhanced the New Relic Gradle plugin's build-time reporting of ProGuard/DexGuard maps

Maps will only be reported during select variant builds (i.e., Release)
Build variants are assigned unique build IDs
Maps can be compressed prior to upload

Please refer to Android agent crash reporting for more detail regarding these features. These features are configurable through the New Relic Gradle Plugin extension and existing newrelic.properties.

Fixed in this release

Fixed build errors that occur when older (pre-3.0) versions of the Android Gradle Plugin is used
Fixed 'IllegalStateException' crash that resulted when header queries were made to failed HttpsUrlConnection requests

Android agent v5.26.0

Mon, 13 Jul 2020 00:00:00 +0000

New in this release

Updated for Android Gradle Plugin 4.0
See the Android compatibility matrix here

Fixed in this release

Missing O/S versions for Android 9 and above are now reported as undefined
O/S major versions that were reported as empty string are no longer recorded if the agent is unable to determine a value
OkHttp2 and OkHttp3 requests are now reporting bytesSent in HttpRequests, when available
Interaction counts reported as zero are now recorded with the correct value

Android agent v5.27.1

Thu, 10 Sep 2020 00:00:00 +0000

Fixed in this release

Fixed MissingPropertyException thrown by newRelicInstrumentTask when building with Android Gradle Plugin 2.x

Android agent v5.25.0

Mon, 06 Apr 2020 00:00:00 +0000

New in this release

Adds support for Android Gradle Plugin (AGP) version 3.6. AGP 3.6 requires version 5.25.0 of the New Relic agent. Previous agent versions are not supported with 3.6.
Apache HttpClient instrumentation is deprecated

Fixed in this release

Fix unhandled exception when closing a Cronet HttpUrlConnection on error conditions
Fixed OkHttp2/Retrofit crash when reading error response bodies
Better content length/bytes received reporting for OkHttp2 and OkHttp3

Known issues

The New Relic agent may not correctly detect the 'mapping.txt' file using Dexguard and AGP 3.6. We are looking into the issue.

Android agent v5.28.0

Thu, 15 Oct 2020 00:00:00 +0000

New in this release

Improved attribute validation

The agent will no longer reject events containing invalid attributes. Attributes that fail basic event validation are pruned from the map of provided event attributes. We've also corrected an event creation error where attribute maps containing null keys would result in events with a subset of passed attributes.

This applies to attributes passed torecordCustomEvent(), recordEvent() and recordBreadCrumb() API methods.

Map uploads are now compressed by default

To disable compressed uploads, add the following to the newrelic.properties:

com.newrelic.compressed_uploads=false

Fixed in this release

Fixes the java.lang.LinkageError runtime crash when instrumenting OkHttp 4.9
Fixed IllegalArgumentException thrown during builds when the agent inspects classes compiled with JDK 9 and higher. Classes compiled with JDK 9 through JDK 11 are now inspected for instrumentation

Android agent v5.28.1

Tue, 15 Dec 2020 00:00:00 +0000

Fixed in this release

Crash reports uploads are sent immediately for wired connections (i.e., AndroidTV). Previously, crashes were deferred until the first harvest of the next app launch.

Android Gradle Plugin Support

This will be the last version of the Android agent to support versions 2.+ of the Android Gradle Plugin.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.21.3.

Android agent v5.3.0

Thu, 03 Sep 2015 00:00:00 +0000

Improvements

This release adds a new API method withApplicationBuild(String build) which replaces the now deprecated method, withBuildIdentifier(String build). The functionality remains the same, allowing the application build to be set rather than relying on the versionCode. See Android API documentation for details.
Log messages from the Android SDK have been updated to reflect updated New Relic support team contact information.

Fixes

This release improves UI performance when an app has crashed and that crash is being sent to New Relic.
The logic for sampling memory and CPU resources during an interaction trace was improved to limit the use of system resources.
A crash was addressed in a rare instance when the Apache BasicHttpRequest library was used for networking purposes.

Android agent v5.3.1

Mon, 12 Oct 2015 00:00:00 +0000

Improvements

Retrofit compatibility - this release of the Android SDK adds support for the current beta version of the Retrofit library (2.0.0-beta2) and addresses a crash that may have occurred previously when making an HTTP request with this beta version.

Android agent v5.3.3

Tue, 24 Nov 2015 00:00:00 +0000

Improvements

This release adds two new Insights attributes for the upcoming Mobile Version Trends Report: install, and upgradeFrom. This allows tracking when a session includes a new install or a new upgrade. The install attribute records true if the app was a new installation. The upgradeFrom attribute tracks the last version of the application when an upgrade is detected.

Fixes

Patched a GSON vulnerability that could result in null pointer exception in Json serialization during harvest.

Android agent v5.4.0

Thu, 07 Jan 2016 00:00:00 +0000

Improvements

Interaction tracing can now be globally disabled with the new API method, NewRelic.withInteractionTracing(boolean). This method should be called prior to starting the agent, but it can be changed any time thereafter. Interaction tracing will be disabled after the agent has started; interactions for any activity or methods executed prior to starting the agent may still appear in the Interactions page.

Fixes

A bug introduced in the previous release that resulted in missing analytics data in crash reports has been fixed.
The session ID is now correctly updated when the app returns to foreground. Unique session counts were not affected.
Additional safeguards were added to prevent agent from starting or harvesting when app is in the background.

Android agent v5.3.2

Thu, 29 Oct 2015 00:00:00 +0000

Improvements

Android Gradle plugin 1.4 compatibility (1.4.0-beta6)
- Google is working to improve the build system within Android Developer Toolkit (ADT) and as of version 1.4.0-beta2 a change was made that breaks compatibility with the New Relic Android agent. This update provides compatibility with the new beta and previous versions of the Android Gradle plugin.

Fixes

With Strict Mode enabled in Android Studio, there may have been a resource leak detected with the Android agent installed. This has been corrected for Strict Mode compatibility and to prevent potential resource leaks.
An edge case scenario was detected where an app left open past the scheduled timeout value would continue sending data on the standard harvest cycle rather than the timeout value. This was corrected to ensure the timeout count is reset and respected.
A small number of network error types in the Android agent were found to be reporting invalid codes that resulted in missing exceptions on the Errors page for the app. This behavior was corrected and each type of exception is now properly displayed in the Errors screen.
In version 1.3 of the Gradle plugin, Google made a change that requires the mapping.txt file to be in a specific format when creating multi-dexed apps. This release accounts for that and ensures building with the Android agent is supports multi-dex.

Android agent v5.4.1

Wed, 10 Feb 2016 00:00:00 +0000

Fixes

Prevent duplication of the New Relic HTTP header used for cross application tracing ('X-NewRelic-Id') if the request is replayed through OkHttp
The agent will now send the HTTP header 'X-NewRelic-Id' (used for cross application tracing) using exactly that casing (it was previously lowercased)
Failed OkHttp requests will now correctly report the full error response body

Changes

This release will be the last to support the New Relic Eclipse plugin for Eclipse IDE's. Eclipse users are encouraged to use the Eclipse Gradle plugin or migrate to Android Studio. Eclipse users may continue to use this (5.4.1) or any previous agent release.

Android agent v5.5.0

Tue, 08 Mar 2016 00:00:00 +0000

Improvements

This release adds a new feature flag, DefaultInteractions, that controls whether automatically instrumented (default) interactions are collected by the agent. With auto-instrumented interactions disabled, only custom interactions (interactions created through the public New Relic agent API) will be recorded. This flag is enabled by default, and is disabled by calling

NewRelic.disableFeature(FeatureFlag.DefaultInteractions);

Fixes

Fixes a problem reading a response body in asynchronous network requests via OkHttp, which was introduced by version 5.4.1.

Android agent v5.6.1

Tue, 31 May 2016 00:00:00 +0000

Fixes

Fixes crashes when initializing JsonObject instances with null values. The class constructor now throws a JSONException if the passed JSON string argument is null.
Fixes crashes that resulted from attempting to determine the root cause of an unhandled exception.
Fixes very rare crashes when OkHttp2 returns a null Response object following a network request.

Android agent v5.7.0

Thu, 04 Aug 2016 00:00:00 +0000

New in this release

We are pleased to announce support for Dexguard.
- Full build time compatibility with Dexguard version 7.2.04 or higher
- Full instrumentation support
- De-obfuscated crash report stack traces

Fixes

The New Relic Gradle plugin depends on the Android application or library plugin having been installed first. The New Relic plugin now throws a Gradle runtime exception, which includes instructions on how to fix the problem, if it is applied before Android.
Interaction trace completion was blocked on the sampling tasks running during the interaction. Any running sample tasks are stopped immediately when the interaction trace completes.

Changes

The Android agent now requires Proguard version 5.0 or higher for Proguard support

Android agent v5.6.0

Wed, 04 May 2016 00:00:00 +0000

Improvements

Improved OkHttp2 error reporting

A set of OkHttp2 request exceptions, previously listed as Unknown errors, have been adapted to reportable error types.
Reduce upload attempts for cached crash reports

Crash reports that are collected, but cannot be immediately uploaded, are saved locally. Saved crashes are uploaded to the crash collectors as part of agent initialization, and if the upload was successful, the local copy is removed. Otherwise, the upload is tried again the next time the app is launched, and this would go on until the upload was successful. To limit accumulation, and reduce old or duplicated crash reports, the agent now limits retries to three attempts.

Fixes

Fixes crash when initializing JsonArray instances with null values. Throws JSONException if the passed JSON string argument is null.
Fixes certain crashes resulting from NoClassDefFoundError exceptions thrown by multi-dexed apps compiled for Dalvik on platforms prior to Lollipop (Android 5.0, API level 21).

Android agent v5.8.3

Mon, 03 Oct 2016 00:00:00 +0000

Update for OkHttp3 instrumentation

This release updates OkHttp3 instrumentation. OkHttp3 instrumentation is the automatic instrumentation for apps using the OkHttp version 3 HTTP client library for synchronous and asynchronous network requests. OkUrlFactory is also now supported when used with OkHttp3 client.

Fixes

Fixed the class cast exception crash when using OkHttp3 web sockets.

Android agent v5.7.1

Fri, 02 Sep 2016 00:00:00 +0000

Fixed in this release

Fixed a hang due to a sampling race condition that occurred when an app's crash was uploaded to New Relic.

Android agent v5.8.0

Mon, 26 Sep 2016 00:00:00 +0000

New in this release

Add support for OkHttp3 instrumentation
This release adds automatic instrumentation for apps using the OkHttp version 3 HTTP client library for synchronous and asynchronous network requests. OkUrlFactory is also now supported when used with OkHttp3 client.

Fixes

Improved interaction reporting
The app's main activity, not Android SDK subclasses, is now reported as the default interaction.
Fixed NPE when reading from instrumented InputStream instances.
Fixed unhandled MeasurementException crash in when renaming interactions.
Added session attributes missing from crash reports.

Android agent v5.8.2

Thu, 29 Sep 2016 00:00:00 +0000

Fixes

Addressed a potential crash that could occur when using OkHttp3 with both interceptors and caching.

Android agent v5.8.4

Tue, 18 Oct 2016 00:00:00 +0000

Fixes

Fixed content length tracking and reporting failure for Retrofit ResponseBody contents.

Android agent v5.9.0

Tue, 06 Dec 2016 00:00:00 +0000

New In This Release

Starting with this version of the SDK, you can set a custom user identifier value that can be used to associate user sessions with analytics events and attributes. Check out the NewRelic.setUserId method for more information.

Android agent v6.0.0

Wed, 17 Mar 2021 00:00:00 +0000

Welcome to the New Relic Android agent version 6.0. This major release breaks compatibility with older 2.x and early 3.x versions of the Android Gradle Plugin (AGP).

New in this release

Adds Distributed Tracing support

The agent will now add Distributed Tracing headers to instrumented network requests. This feature is enabled by default, but can be disabled through the DistributedTracing feature flag.

Refer to How New Relic distributed tracing works for more information on Distributed Tracing in mobile apps.

Exclude variants from instrumentation

Variant builds can now be selectively excluded from instrumentation during builds. Build types or product flavors are excluded through the New Relic Gradle plugin extension:

newrelic {
    // do not instrument these build variants
    excludeVariantInstrumentation("debug", "chocolateRelease")
}

Updated requirements

The minimum supported SDK level (minSdkVersion) is now 24 (Android 7.0) The minimum supported Android Gradle plugin version is now 3.4 using Gradle 5.1.1 or higher.

Fixed in this release

Bluetooth and ethernet connections are now correctly identified.
Fix build crash involving manifestPlaceholder replacement when used with AGP 4.1.
Remove unused compile dependency on the support-v4 Android support library .

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.22.1.

Android agent v6.1.0

Tue, 29 Jun 2021 00:00:00 +0000

We have noticed that this version has issues running on devices with API levels below 24.

This will be fixed in the upcoming release. In the meantime we suggest you revert to version 6.0.0 (or upgrade compileSDK to 24).

New in this release

In consideration of customers still dependent on Android 5.0, we've reverted the minimum supported SDK level (minSdkVersion) from 24 to 21.

Fixed in this release

Agent version 6.0.0 introduced changes to the way the agent processes crashes at runtime. Deferred crash reporting is now the default crash reporting behavior, in which case crash reports are recorded when they occur, but not uploaded until the next application launch. This agent release:

fixes a race condition with deferred crash reporting that resulted in dropped crashes.
corrects the inadvertently deprectated NewRelic.withCrashReportingEnabled(boolean) API method.

Resolve D8 crash caused by incomplete instrumentation of AsyncTask implementations.

Correct misleading logging messages generated when Http/HttpsUrlConnections are are instrumented for Distributed Tracing.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.23.0.

Android agent v6.10.0

Thu, 09 Mar 2023 00:00:00 +0000

New

Add a new feature to provide the ability to disable agent at runtime

Fixed

Fix an issue of failing to report network failure
Tighten the exception handling of HarvestTimer.tickNow() to prevent NullPointerException

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.0.0.

Please note, the Android agent will be increasing the minimum Gradle versions in agent release 6.12.0. Customers will be required to upgrade to Android Gradle Plugin 7.2 or higher.

Android agent v6.11.0

Wed, 10 May 2023 00:00:00 +0000

New

Add FedRAMP support

Fixed

Fix an issue of NR_BUILD_ID not appending with default release variant
Tighten the exception handling of TraceMachine to prevent NullPointerException

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.1.0.

Please note, the Android agent will be increasing the minimum Gradle versions in agent release 6.12.0. Customers will be required to upgrade to Android Gradle Plugin 7.2 or higher.

Android agent v6.2.0

Sun, 01 Aug 2021 00:00:00 +0000

New in this release

Add suppport for Android Gradle plugin (AGP) version 7.0
Update instrumentation support level to JDK 11

Fixed in this release

Replace Map.putIfAsent() method reference that caused runtime crashes when using compileSDK < 24
Remove any remaining location listener when app goes to background
Fix OkHttp interceptor failure when updating the URL of Retrofit POST requests

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.23.0.

Android agent v6.11.1

Tue, 16 May 2023 00:00:00 +0000

Fixed

Fix an issue where the app crashes when it goes to background after agent shutdown

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.1.0.

Please note, the Android agent will be increasing the minimum Gradle versions in agent release 6.12.0. Customers will be required to upgrade to Android Gradle Plugin 7.0 or higher.

Android agent v6.2.1

Tue, 24 Aug 2021 00:00:00 +0000

Fixed in this release

Update ASM API level for all classes to fix a build error indicating: java.lang.UnsupportedOperationException: This feature requires ASM7 when running on JDK 11 and Gradle 7+
Emit log messages to warning while processing some unsupported classes due to an incompatibility with our bytecode injection library, further investigation needed
Add exception handling to address NoSuchMethodError runtime crash on certain Android devices

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.23.0.

Android agent v6.3.1

Mon, 18 Oct 2021 00:00:00 +0000

New in this release

Deprecated SDK location support, and removed geolocation listener from agent.

Fixed in this release

Resolved missing Retrofit2/OkHttp3 'bytesReceived' and error response body results
Fixed single/orphan Distributed Tracing spans resulting from malformed trace parent HTTP header
Resolved missing OkHttp3 response bodies that made the agent incompatible with Mapquest
Resolved Gradle 7 execution optimization warnings due to the agent plugin's failure to declare an explicit or implicit dependency.
Removed erroneous Kotlin UnknownTaskException log warning

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.23.0.

Android agent v6.3.0

Fri, 08 Oct 2021 00:00:00 +0000

This release is invalid and should not be used. Please use Android agent version 6.3.1.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.23.0.

Android agent v6.4.0

Wed, 12 Jan 2022 00:00:00 +0000

Fixed in this release

Resolved D8/R8 warning messages: Expected stack map table for method with non-linear control flow.
Fixed crash caused by NoSuchMethodError that occurred on Android 5 and 6.
Reverted the fix for missing Retrofit2/OkHttp3 bytesReceived and error response body results to prevent memory leaking.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.24.0.

Android agent v6.4.1

Tue, 25 Jan 2022 00:00:00 +0000

Fixed in this release

Resolved an error when transforming some libraries during build time. Detailed message: [ClassTransformer] transformArchive: java.util.zip.ZipException: duplicate entry: META-INF/MANIFEST.MF
Resolved a 'java.lang.NoClassDefFoundError' crash during runtime.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.24.0.

Please note, support for Android SDK 21-23 will be removed in a future release.

Android agent v6.5.0

Wed, 09 Mar 2022 00:00:00 +0000

New in this release

Add support for passing Throwable types to NewRelic.recordHandledException()

Fixed in this release

Resolved a sampler thread leak that occurred in long-lived apps.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.24.0.

Please note, support for Android SDK 21-23 will be removed in a future release.

Android agent v6.7.0

Wed, 06 Jul 2022 00:00:00 +0000

New in this release

Add support for native crash reporting in legacy agent crash reporting.
Add distributed tracing context support to New Relic SDK

Fixed in this release

Fixed issue that kept the app's supportability metrics from being reported to New Relic
Updated the agent to address Gradle deprecation warnings

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.26.0.

Android agent v6.6.0

Thu, 02 Jun 2022 00:00:00 +0000

New in this release

Add support for DexGuard 9
End of life for supporting android SDK 21 (Android 5) to 23 (Android 6)

Fixed in this release

Fix a bug to capture response body using noticeHttpTransaction method

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.26.0.

Please note, support for Android SDK 21-23 has been removed in this release.

Android agent v6.8.0

Wed, 27 Jul 2022 00:00:00 +0000

New in this release

Add support for handling JavaScript errors from React Native apps
Add a new session attribute RootedDevice when native reporting is enabled to signify whether the hosting device is rooted

Fixed in this release

Fixed an issue to address the format of distributed tracing header
Fixed an issue in plugin to address a corner-case exception thrown during map processing

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.26.0.

Android agent v6.9.0

Mon, 26 Sep 2022 00:00:00 +0000

New in this release

Add support for reporting app launch time, including cold time and hot time.
- Cold start time refers to an app’s starting from scratch. This means that the app’s process has not been created by the system until then.
- Hot start time refers to when your app’s process is already running in the background.

Fixed in this release

Fixed an instrumentation race condition when build is run with multiple Gradle workers (--max-workers > 2)
Fixed a crash when trying to report exceptions with missing stacktraces through supportability metrics.

Support statement:

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.27.0.

Android agent v6.9.1

Tue, 06 Dec 2022 00:00:00 +0000

Fixed

Fixed a distributed tracing issue for httpURLConnection in Cordova/Ionic apps.

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 5.28.1.

Android agent v6.9.2

Wed, 11 Jan 2023 00:00:00 +0000

Fixed

Fixed an issue of missing element in harvest payload, which has caused data loss during ingest in version 6.9.1
Tightened metric data validations to prevent data loss during ingest
Fixed a bug that allowed direct access to the agent plugin extension's configuration from Kotlin that could result in a failure to tag and upload obfuscation maps.

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.0.0.

Android agent v7.2.0

Wed, 15 Nov 2023 00:00:00 +0000

New

Adds configurable request header instrumentation to network events

The agent will now produce network event attributes for select header values if the headers are detected on the request. The header names to instrument are passed into the agent when started.

For more information, see Adding Tracked Headers in the Mobile Monitoring documentation.

Adds GraphQL attributes to network events

If the agent detects request headers from Apollo GraphQL servers, it will add additional attributes to the network request event.

For more information, see Adding Tracked Headers in the Mobile Monitoring documentation.

Exclude instrumentation by package name

The agent plugin can now be configured to exclude classes from a specific package space during instrumentation. These classes will be unmodified. This feature can be useful when encountering sensitive or problematic class data.

For more information, see Configure the New Relic Gradle plugin.

Fixed

Exclude signed jars from instrumentation

Support statement

We recommend you to upgrade the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.0.0

Mon, 10 Jul 2023 00:00:00 +0000

Welcome to the New Relic Android agent version 7.0. This major release breaks compatibility with versions of

Gradle 6.x
Android Gradle Plugin (AGP) 4.x

Android agent 7.x is increasing the minimum Gradle version to 7.2. Customers will be required to upgrade to Android Gradle Plugin (AGP) 7.0.0 and higher.

New

Adds support for Gradle 8.0 and higher
Adds support for the Android Gradle Plugin 8.0 and higher
Adds support for Gradle configuration caching
Adds support for JDK 17 when used with Gradle 8

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.1.0.

Android agent v7.2.1

Mon, 05 Feb 2024 00:00:00 +0000

Fix

Upgrade the support version of AGP to 8.4

Support statement

We recommend you to upgrade the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.3.0

Mon, 04 Mar 2024 00:00:00 +0000

New

Added the ability to persist events when application is force killed.
Added the ability to store harvest data that previously would be lost if the application doesn't have internet connection. These harvest are then sent after an internet connection is established and the next harvest successfully uploads. This feature is disabled by default, see more details here to enable it.
Added setMaxOfflineStorageSize API to set the maximum amount of data that can be stored locally.
Added support for Unreal platform.
Added support for Android dynamic features.

Fix

Fixed an issue that target activity is not captured when calculating app launch time from the start to a target activity rather than the default main activity.

Support statement

We recommend you to upgrade the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.4.0

Thu, 20 Jun 2024 00:00:00 +0000

New

Add ApplicationExitInfo as part of data reporting.
Add the ability to report data while an application goes into a background state. You can read our docs to learn how to enable this feature.
Includes code for upcoming log forwarding feature. See your Account Team for information about early adoption.

Fix

Enhance setUserId() function to add the ability to update userID attribute multiple times in a short period without losing the history of different end users. You can read our docs to learn about this fix.
Enhance the accuracy of device time calculation when it is changed by the mobile network.
Resolve an ANR issue when the application reports events.
Resolve an issue when exceptionMessage of a MobileHandledException doesn't display in query results.

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.1.0

Mon, 25 Sep 2023 00:00:00 +0000

New

Adds support for DexGuard 9+ with Gradle 8/AGP 8
Adds unity support with custom exceptions
Adds map parameters for both custom and auto HTTP instrumentation to ensure data accuracy
Decouple map tagging with uploads in plugin to improve the build pipeline by making the tagged map a cachable build artifact

Fixed

Fix NoClassDefFoundError when using agent v7.0.0 due to uninstrumented signed libraries
Fix an issue that excludeVariantInstrumention is not accepting camel case variant names

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

As of this release, the oldest supported version is 6.3.0.

Android agent v7.3.1

Thu, 25 Apr 2024 00:00:00 +0000

Fix

Resolve a SHA-signed error during build time by disabling JAR signing verification.
Resolve reported ANRs during event persistance serialization.
Enhance symbol upload process to improve request error rate and support a pending new upload endpoint.

Support statement

We recommend you to upgrade the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.4.1

Mon, 24 Jun 2024 00:00:00 +0000

New

Add ApplicationExitInfo as part of data reporting, and the feature is enabled by default. To disable go to your mobile applications entity application settings page.

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.5.0

Fri, 28 Jun 2024 00:00:00 +0000

New

Add mobile log reporting feature. You can read our docs to learn more and how to enable this feature.

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.5.1

Thu, 01 Aug 2024 00:00:00 +0000

Fix

Tighten the logic around metric clearance to prevent dropping metrics when harvest is unsuccessful
Add sessionId attribute as part of the log reporting

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.6.1

Thu, 17 Oct 2024 00:00:00 +0000

New

Adds support for the Android Gradle Plugin 8.7.

Fixed issues

Resolved an issue where ProGuard/DexGuard mapping files weren't being properly uploaded to New Relic, improving crash reporting accuracy.
Fixed a crash that occurred when Kotlin mutable maps were passed to breadcrumbs and custom events.
Corrected behavior where default interactions were being recorded even when the feature flag was disabled.

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.6.0

Tue, 10 Sep 2024 00:00:00 +0000

New features

Upgrade JDK support to JAVA22.
Upgrade AGP support to 8.6.
Add feature flag for event persistence. You can read our docs to learn how to enable this feature].

Fixed issues

Fixed a corner case to prevent a mismatch between appbuildid and appversion.
Fixed issue where crashes aren't ingested due to empty stacktraceElements.
Fixed a NullValuePointer exception when a shutdown is called.
Fixed a parameter mismatch in the gradle plugin which caused confusion in the logs.

Support statement

We recommend updating the agent at least every 3 months. The specific policies and dates for Android agent support of the can be found in the Mobile monitoring agents EOL policy.

Android agent v7.6.10

Fri, 10 Oct 2025 00:00:00 +0000

New

Added Gradle 9 Support

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.11

Thu, 30 Oct 2025 00:00:00 +0000

Fixes

Fixed a NullPointerException issue in memory sampling process.
Added safe casting during the initialization of app launch times to prevent ClassCastException compatibility in Microsoft Intune MAM SDK.
Improved okhttp callback protection to prevent agent crashes from user code exceptions.
Fixed duplicated crashes from native crash reports.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.12

Tue, 04 Nov 2025 00:00:00 +0000

New

Added session replay functionality for Jetpack Compose.
Official session replay public preview version.

Fixes

Fixed multiple session replay bugs.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.13

Fri, 14 Nov 2025 00:00:00 +0000

Fixes

Fix ANR cased by setUserId
Fix ANR caused by blocking SecureRandom initialization during agent configuration
Improve content length detection and limit reponsebody capture in okhttp3
Fix few bugs in webview instrumentation

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.15

Tue, 20 Jan 2026 00:00:00 +0000

Fixes

Changed the default interval for sending event data from 10 minutes to 1 minute.
Fixed an issue where mapping files aren't sent in DexGuard 9 with different flavor configurations.
Fixed multiple crashes related to mobile session replay.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.14

Thu, 04 Dec 2025 00:00:00 +0000

Fixes

Fix an issue that artifacts are missing for monoEnabled build

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.3

Fri, 24 Jan 2025 00:00:00 +0000

New Features

Introduced build-time feature flag for LogInstrumentation.
Enhanced logging by including Session Attributes as Log Attributes.

Bug Fixes

Resolved missed session events in the background reporting feature.
Fixed memory leak related to mobile handled exceptions during network unavailability.
Corrected application crash scenario during agent shutdown.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.2

Fri, 06 Dec 2024 00:00:00 +0000

New features

Implemented OpenTelemetry (Otel) Distributed Tracing.
Added support for Gzip compression for log data ingestion.
Included Application Not Responding (ANR) thread data in the reporting process.

Fixed issues

Fixed an issue with log instrumentation that caused build failures.
Fixed an issue where throwable errors generated repetitive entries in Logcat.
Fixed a crash caused by calling removeAttributes before starting an agent.
Fixed user-reported issues with log functionality.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.4

Fri, 21 Feb 2025 00:00:00 +0000

New

Upgrade agent to support AGP 8.8
Added processId as a session attribute for application exit info to ensure better troubleshooting ability

Bug Fixes

Resolved an issue that logs are not sent after first app launch
Resolved the issue where HttpHeaders were not being tracked when added through an interceptor.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.5

Wed, 26 Mar 2025 00:00:00 +0000

Bug Fixes

Addressed a problem where the agent failed to parse double values with non-zero digits after the decimal point.
Corrected an issue where the agent recorded app launch metrics as astronomical values.
Fixed build issues related to newer versions of Dexguard.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.6

Mon, 14 Apr 2025 00:00:00 +0000

Bug Fixes

Addressed an issue with custom interaction conflicts with default interaction

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.8

Tue, 29 Jul 2025 00:00:00 +0000

Bug Fixes

Fixed an issue where stack traces for Unity errors were not displayed correctly.
Fixed an issue that prevented summary metrics from being recorded when the app returned to the foreground after its initial launch.
Fixed an issue where invalid JSON in log entries could cause errors.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.7

Wed, 18 Jun 2025 00:00:00 +0000

Bug Fixes

Improved performance to resolve ANRs when reporting logs
Fixed an issue to continue reporting logs upon termination of the application
Resolved an issue with application state monitoring and data transmission
Improved few violations when turning on strictmode

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.6.9

Mon, 15 Sep 2025 00:00:00 +0000

Bug Fixes

Resolved a memory leak issue where trace listeners were not being removed properly after the app switched between foreground and background multiple times.
Fixed the issue with thread synchronization that occasionally resulted in data not being reported to New Relic.
Addressed issues related to log reporting during ANRs to improve stability and performance.
Corrected duplicate class issues related to the Curtains Library to ensure compatibility and prevent conflicts.
Resolved a null pointer exception issue in the setUserId method to enhance robustness.
Fixed issues with the Retrofit Interceptor where URLs were not reported correctly if the request failed due to network errors on the device.

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v7.7.0

Fri, 13 Feb 2026 00:00:00 +0000

New

Add support for AGP 9
Add error sampling for mobile session replay
Add pauseReplay and recordReplay APIs

Fixes

Multiple mobile session replay fixes for better performance

Support statement

We recommend updating the agent at least every three months. Find specific policies and dates for Android agent support in the Mobile Monitoring Agents EOL Policy.

Android agent v1.0.1

Mon, 10 Apr 2023 00:00:00 +0000

Fixed

Addressed a memory leak resulting from ANR detection

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.0.2

Thu, 04 May 2023 00:00:00 +0000

Fixed

Updated Kotlin library to a version that addressed a vulnerability.

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.0.3

Wed, 19 Jul 2023 00:00:00 +0000

Fixed

Fixed java.lang.NoSuchMethodError when using the NDK agent and Android agent version 6.11.0 and higher.

Support statement

The Android NDK agent version 1.0.3 requires Android agent 6.11.0 and higher. Versions 1.0.0 - 1.0.2 are compatible with Android agent 6.10.0 and lower.

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.0.4

Thu, 19 Oct 2023 00:00:00 +0000

Fixed

Fixed a memory leak when ANRMonitor is enabled.

Support statement

The Android NDK agent version 1.0.3 and above requires Android agent 6.11.0 and higher. Versions 1.0.0 - 1.0.2 are compatible with Android agent 6.10.0 and lower.

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.1.0

Thu, 27 Jun 2024 00:00:00 +0000

New

Reduce the overall size of the agent.
Extend AgentNDK.Builder.withANRMonitor(boolean) to disable native ANR detection as well.

Support statement

The Android NDK agent version 1.1.0 and above requires Android agent 7.5.0 and higher. The Android NDK agent version 1.0.3 and above requires Android agent 6.11.0 and higher. Versions 1.0.0 - 1.0.2 are compatible with Android agent 6.10.0 and lower.

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.1.1

Thu, 25 Jul 2024 00:00:00 +0000

Fix

Tighten implementation logic to better handle potential memory leakage, and add more logging for debugging visibilities.

Support statement

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.1.2

Wed, 21 Aug 2024 00:00:00 +0000

This release is invalid and should not be used.

Support statement

The Android NDK agent version 1.1.1 and above requires Android agent 7.5.1 and higher. The Android NDK agent version 1.1.0 and above requires Android agent 7.5.0 and higher. The Android NDK agent version 1.0.3 and above requires Android agent 6.11.0 and higher. Versions 1.0.0 - 1.0.2 are compatible with Android agent 6.10.0 and lower.

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v1.1.3

Thu, 10 Jul 2025 00:00:00 +0000

Fix

Added support for 16KB page size

Support statement

The Android NDK agent version 1.1.1 and above requires Android agent 7.5.1 and higher.
The Android NDK agent version 1.1.0 and above requires Android agent 7.5.0 and higher.
The Android NDK agent version 1.0.3 and above requires Android agent 6.11.0 and higher.
Versions 1.0.0 - 1.0.2 are compatible with Android agent 6.10.0 and lower.

We recommend you to upgrade the agent regularly, at least every 3 months.

Android agent v4.95.0

Wed, 22 Oct 2014 00:00:00 +0000

Fixes

Corrects an issue where the agent may crash under certain concurrent access of instrumented InputStream implementations.
Corrects an issue where a thread pool was not properly getting destroyed upon application background-to-foreground transitions.