Android agent configuration and feature flags

Enable or disable collection of event data. These events are reported to Insights 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.

Enable or disable crash reporting.

Enable or disable recording handled exceptions events, which appear on the Handled exception 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 in Insights.

Available for Android agent version 5.14.0 or higher.

Enable or disable reporting network and Http request errors to MobileRequestError event type in Insights.

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());