Android agent configuration and feature flags

Enable or disable collection of event data. These events can be queried with NRQL and used in the Crash analysis page.

Enable or disable the reporting of event data. Event collection will still occur; the events will just not be sent to our collector. You might decide to use this instead of withAnalyticsEvents if you wanted to disable collection but still be able to see what the agent was collecting.

Set custom application version strings.

Set custom application build strings.

Enables or disables deferred crash reporting.

Refer to Deferred Crash Reporting for more information on deferred crash reporting.

Enable or disable crash reporting.

Enable or disable recording handled exceptions events, which appear on the Handled exception page.

Enable or disable recording of native runtime crashes, exceptions and Application Not Responding (ANR) conditions, which appear on the Crash Analysis page.

Enable or disable the adding of distributed tracing headers to network requests.

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

Enable or disable interaction tracing. Trace instrumentation still occurs, but no traces are harvested. This will disable default and custom interactions.

Available for Android agent version 5.4.0 or higher.

Enable or disable default interactions. Trace instrumentation still occurs, but no traces are harvested. This will enable or disable default interactions only while custom interactions remain enabled.

Enable or disable reporting successful HTTP requests to the MobileRequest event type.

Available for Android agent version 5.14.0 or higher.

Enable or disable reporting network and HTTP request errors to the MobileRequestError event type.

Available for Android agent version 5.11.0 or higher.

Enable or disable capture of HTTP response bodies for HTTP error traces, and MobileRequestError events.

Enable or disable agent logging.

Specifies the log level. Options include:

• ERROR (least verbose)

• WARNING

• INFO (default)

• VERBOSE

• DEBUG

• AUDIT (most verbose)

  Type	String
  Default	AgentLog.INFO

  To increase your logging level in the app, add .withLogLevel to your NewRelic.withApplicationToken() method call. For example:

  NewRelic.withApplicationToken("YOUR_APP_TOKEN")
                      .withLogLevel(AgentLog.DEBUG)
                      .start(this.getApplication());

  Copy

Specifies the URI authority component of the harvest data upload endpoint.

To replace data endpoint the agent will use when reporting data harvests, add .usingCollectorAddress() to your NewRelic.withApplicationToken() method call. For example:

NewRelic.withApplicationToken("YOUR_APP_TOKEN")
.usingCollectorAddress("harvest-upload-delegate.domain.com")
.start(this.getApplication());

This endpoint is also used for handled exception uploads.

Specifies the authority component of the crash data upload URI.

To replace data endpoint the agent will use when reporting crashes, add .usingCrashCollectorAddress() to your NewRelic.withApplicationToken() method call. For example:

NewRelic.withApplicationToken("YOUR_APP_TOKEN")
.usingCrashCollectorAddress("crash-upload-delegate.domain.com")
.start(this.getApplication());

Enable or disable reporting app launch time (cold and hot time) to the metrics

• 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.

  Available for Android agent version 6.9.0 or higher.

  Type	Boolean
  Default	true Enabled by default as of agent version 6.9.0

Enable or disable reporting data using different endpoints for US government clients.

Available for Android agent version 6.11.0 or higher.