Manage monitor runtimes

Simple browser, scripted browser, and API monitors execute in the New Relic runtime environment that existed when the monitors were created, even when new runtimes are released.

Since your monitors could be running on older runtimes, it's important for you to understand runtime features and upgrade monitors to use the latest runtime version.

Read on to learn how to:

• Review runtime dependencies
• Use environment variables in runtimes
• Upgrade a synthetic monitor
• View a synthetic monitor upgrade history

Review runtime dependencies

The monitor version always matches its runtime version, and the monitor version determines what features the monitor can execute. See the section below that applies to your monitor version.

Here are monitor version details for all monitor types except ping:

Version 0.6.x (Latest)

Synthetic monitor version 0.6.x details:

The synthetic monitoring runtime does not support the async/await syntax supported in Node 10.

• Browser: Chrome 72
• Node: 10.15.0
• Selenium WebDriver: 3.6.0 (exposed via $browser and $driver)
• Proxy settings: Yes
• Supported third-party modules:
  • atob 2.1.0
  • aws-sdk 2.465.0
  • btoa 1.1.2
  • chai 4.2.0
  • chai-webdriver 1.2.0
  • colors 1.3.3
  • consoleplusplus 1.4.1
  • crypto-js 3.1.9-1
  • faker 4.1.0
  • joi 14.3.1
  • lodash 4.17.11
  • moment 2.24.0
  • net-ping 1.2.3
  • net-snmp 1.2.4
  • nodejs-traceroute 1.1.1
  • uuid 3.1.0
  • protocol-buffers 4.1.0
  • q 1.5.1
  • request 2.88.0
  • should 13.2.3
  • text-encoding 0.7.0
  • thrift 0.11.0
  • tough-cookie 3.0.0
  • underscore 1.9.0
  • url-parse 1.4.4
  • urllib 2.33.0
  • urllib-sync 1.1.4
  • validator 10.11.0
  • ws 6.1.3
  • xml2js 0.4.19

Version 0.5.x

Synthetic monitor version 0.5.x details:

• Browser: Chrome 60
• Node: 6.11.2
• Selenium WebDriver: 3.5.0 (exposed via $browser> and $driver)
• Proxy settings: Yes
• Supported third-party modules:
  • atob 2.0.3
  • btoa 1.1.2
  • chai 4.1.1
  • chai-webdriver 0.9.3
  • colors 1.1.2
  • consoleplusplus 1.4.1
  • crypto-js 3.1.9-1
  • faker 4.1.0
  • joi 10.6.0
  • lodash 4.17.4
  • moment 2.18.1
  • net-ping 1.2.1
  • net-snmp 1.2.0
  • nodejs-traceroute 1.1.1
  • uuid 3.1.0
  • protocol-buffers 3.2.1
  • q 1.5.0
  • request 2.81.0
  • should 11.2.1
  • text-encoding 0.6.4
  • thrift 0.10.0
  • tough-cookie 2.3.2
  • underscore 1.8.3
  • url-parse 1.1.9
  • urllib 2.24.0
  • urllib-sync 1.1.4
  • validator 8.0.0
  • xml2js 0.4.17

Version 0.4.x

Synthetic monitor version 0.4.x details:

• Browser: Chrome 44
• Node: 0.1.2
• Selenium WebDriver: 2.47.0 (exposed via $browser> and $driver)
• Proxy settings: Yes
• Supported third-party modules:
  • atob 2.0.3
  • btoa 1.1.2
  • chai 2.3.0
  • chai-webdriver 1.1.1
  • colors 1.1.2
  • consoleplusplus 1.4.1
  • crypto-js 3.1.5
  • faker 3.0.1
  • joi 6.6.1
  • lodash 2.4.2
  • moment 2.10.6
  • net-ping 1.1.12
  • net-snmp 1.1.14
  • node-uuid 1.4.3
  • protocol-buffers 3.1.6
  • q 1.4.1
  • request 2.60.0
  • should 7.0.3
  • text-encoding 0.6.4
  • thrift 0.9.2
  • tough-cookie 2.0.0
  • underscore 1.8.3
  • urllib 2.3.11
  • urllib-sync 1.1.4
  • url-parse 1.1.9
  • validator 4.0.2
  • xml2js 0.4.17

Version 0.2.x

The only difference between monitor version 0.2.x and 0.4.x is that 0.4.x has network proxy settings enabled.

Synthetic monitor version 0.2.x details:

• Browser: Chrome 44
• Node: 0.1.2
• Selenium WebDriver: 2.47.0 (exposed via $browser> and $driver)
• Proxy settings: No
• Supported third-party modules:
  • atob 2.0.3
  • btoa 1.1.2
  • chai 2.3.0
  • chai-webdriver 1.1.1
  • colors 1.1.2
  • consoleplusplus 1.4.1
  • crypto-js 3.1.5
  • faker 3.0.1
  • joi 6.6.1
  • lodash 2.4.2
  • moment 2.10.6
  • net-ping 1.1.12
  • net-snmp 1.1.14
  • node-uuid 1.4.3
  • protocol-buffers 3.1.6
  • q 1.4.1
  • request 2.60.0
  • should 7.0.3
  • text-encoding 0.6.4
  • thrift 0.9.2
  • tough-cookie 2.0.0
  • underscore 1.8.3
  • urllib 2.3.11
  • urllib-sync 1.1.4
  • url-parse 1.1.9
  • validator 4.0.2
  • xml2js 0.4.17

Version 0.1.0

Synthetic monitor version 0.1.0 details:

• Browser: Phantomjs 1.9.8
• Node: 0.1.0
• Selenium WebDriver: 2.44.0 (exposed via $browser> and $driver)
• Proxy settings: No
• Supported third-party modules:
  • chai 1.9.1
  • chai-webdriver 0.9.3
  • colors 1.1.2
  • consoleplusplus 1.4.1
  • crypto-js 3.1.2-5
  • faker 2.0.1
  • lodash 2.4.2
  • moment 2.8.3
  • node-uuid 1.4.3
  • q 1.1.1
  • should 4.0.4
  • tough-cookie 0.12.1
  • underscore 1.7.0
  • validator 3.18.1
  • xml2js 0.4.17

Use environment variables in runtimes

Make your synthetic scripted monitors more contextually aware by using the $env variable properties. These represent important information about the runtime environment when the script executes.

You do not need to import $env because it is readily available, similar to the $browser and $http variables. For example:

console.log('running in ' + $env.LOCATION);
$browser.get('https://example.com');

Upgrade a synthetic monitor

To ensure that you maintain monitor performance and get access to new features, upgrade your monitors whenever you see the Upgrade monitors button in the synthetic monitoring user interface. You can also check the status of your monitors by going to one.newrelic.com > Synthetics > Upgrade monitors.

The upgrade provides a validation process to identify scripted monitors that are not compatible with the latest runtime. Validation allows you to correct any errors that the latest runtime might cause with existing monitors before your monitors are upgraded.

When you select Upgrade monitors, here are the options:

View synthetic monitoring upgrade history

To see a history of monitor version upgrades, query the NrAuditEvent.

For more help