setApplicationVersion

Syntax

newrelic.setApplicationVersion(value: string|null)

Adds a user-defined application version string to subsequent events on the page.

Requirements

• Browser Lite, Pro, or Pro+SPA agent (v1.238.0 or higher)

• If you're using npm to install the browser agent, you must enable at least one feature when instantiating the BrowserAgent class. For example, add the following in thefeatures array:

  import { Metrics } from '@newrelic/browser-agent/features/metrics'
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      Metrics
    ]
  }

  Copy

  For more information, see the npm browser installation documentation.

Description

Upon executing this function with a valid value, the browser agent appends an application.version attribute to all subsequent events until the attribute is manually unset or the page is unloaded. If the function is called more than once, only the most recent value provided will be sent on subsequent events. If this function is called with a value of null, any existing application version will cease to send on subsequent events.

Setting the application.version attribute will help you identify which versions of your software are producing the errors. An upcoming release of errors inbox will automatically track which versions of your software are producing errors. If you are using SPA monitoring with a compatible agent version, application version will also be included in newrelic.interaction events.

Parameters

Examples

Decorating events with an application version

newrelic.setApplicationVersion('1.2.3') // decorates events with the property 'application.version':'1.2.3'

Stopping events from decorating application version

newrelic.setApplicationVersion(null) // events will no longer have an 'application.version' property set