• /
  • EnglishEspañol日本語한국어Português
  • Log inStart now

Android agent release notesRSS

December 14, 2017
Android agent v5.16.0

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.

November 8, 2017
Android agent v5.15.2

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.

October 18, 2017
Android agent v5.15.1

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)

October 2, 2017
Android agent v5.15.0

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)

June 14, 2017
Android agent v5.14.0

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.

May 10, 2017
Android agent v5.13.0

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.

April 21, 2017
Android agent v5.12.3

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.

March 29, 2017
Android agent v5.12.2

Fixed in this release

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

March 23, 2017
Android agent v5.12.1

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.

March 8, 2017
Android agent v5.12.0

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.

Copyright © 2025 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.