Migrate the Node.js Library from AppOptics to SolarWinds Observability SaaS
Before you start
Verify the following to ensure the library can collect and transmit data:
-
The platform where your APM library will be installed is supported.
-
Your application components are supported by the library.
-
Your firewall configuration permits TCP/HTTPS/TLS outbound connections to
otel.collector.xx-yy.cloud.solarwinds.com
(orapm.collector.xx-yy.cloud.solarwinds.com
when using legacy mode) port443
, wherexx-yy
is determined by the URL you use to access SolarWinds Observability SaaS, described in Data centers and endpoint URIs. See Firewall or access control requirements.If your firewall or access control requirements do not allow such connections, configure the library to send data through a proxy.
Migrate from AppOptics
AppOptics users can use the following information to migrate to SolarWinds Observability SaaS.
-
Remove any references to the AppOptics custom instrumentation API in your application code.
Save a list detailing your application's usage so it can be updated for the SolarWinds Observability Node.js Library's instrumentation API.
-
Uninstall the AppOptics agent.
-
Undo the steps taken to load the library into your application. See Loading instructions in the AppOptics APM repo.
For example, depending on the methods used to load the library into your application, you may need to remove the
-r appoptics-apm
command at node startup or remove therequire('appoptics-apm')
line in the application code. -
Uninstall the
appoptics-apm
package and remove it from your application dependencies.
-
-
Install the SolarWinds library for SolarWinds Observability SaaS.
-
Update your application to use the new instrumentation API, if needed.
See Node.js Library instrumentation SDK for more information about the SolarWinds Observability Node.js Library's instrumentation API.