Upgrading the Node.js Agent

AppOptics agents are no longer receiving updates. The new SolarWinds Observability Libraries can send APM data to AppOptics and are regularly updated with new features and improvements. If your components are supported by the new libraries, consider transitioning to the SolarWinds Observability Libraries for your APM needs. Alternatively, you can also consider using SolarWinds Observability as your primary APM monitoring solution.

Upgrading to the SolarWinds Observability Node.js Library

The Node.js Instrumentation Library for SolarWinds Observability is compatible with the AppOptics collector. SolarWinds Observability libraries are not compatible with AppOptics agents. Do not use a mix of SolarWinds Observability libraries and AppOptics agents to instrument applications that are part of a distributed trace.

To upgrade to the SolarWinds Observability Node.js Library, uninstall the AppOptics Node.js Agent and follow the rest of the steps described in Migrate the Node.js Library from AppOptics to SolarWinds Observability. Before restarting the application, make the following additional configuration changes to have the SolarWinds Observability Node.js Library continue sending data to AppOptics:

• Set a valid AppOptics service key. See the SolarWinds Observability configuration options for the new configuration file and environment variable names.
• Set the collector configuration to the AppOptics endpoint collector.appoptics.com:443.

Upgrade to a newer version of the legacy AppOptics Agent

To upgrade to a next beta version, for example from 4.0.5-beta to 4.0.6-beta:

npm install --save appoptics-apm@4.0.6-beta

Upgrading from TraceView

There are two major changes:

1. The package is now called appoptics-apm, please make changes accordingly.
2. The service key is required and must be set as an environment variable APPOPTICS_SERVICE_KEY.

The scripts are not supported under any SolarWinds support program or service. The scripts are provided AS IS without warranty of any kind. SolarWinds further disclaims all warranties including, without limitation, any implied warranties of merchantability or of fitness for a particular purpose. The risk arising out of the use or performance of the scripts and documentation stays with you. In no event shall SolarWinds or anyone else involved in the creation, production, or delivery of the scripts be liable for any damages whatsoever (including, without limitation, damages for loss of business profits, business interruption, loss of business information, or other pecuniary loss) arising out of the use of or inability to use the scripts or documentation.