Documentation forSolarWinds Observability SaaS

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 (or apm.collector.xx-yy.cloud.solarwinds.com when using legacy mode) port 443, where xx-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.

Remove other APM libraries from your Node.js application before using the SolarWinds Observability Node.js Library.

Migrate from AppOptics

AppOptics users can use the following information to migrate to SolarWinds Observability SaaS.

  1. 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.

  2. Uninstall the AppOptics agent.

    1. 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 the require('appoptics-apm') line in the application code.

    2. Uninstall the appoptics-apm package and remove it from your application dependencies.

  3. Install the SolarWinds library for SolarWinds Observability SaaS.

  4. 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.