Documentation forSolarWinds Observability

Migrate the Java Library from AppOptics to SolarWinds Observability

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

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 apm.collector.xx-yy.cloud.solarwinds.com (where xx-yy is determined by the URL you use to access SolarWinds Observability, described in Data centers and endpoint URIs) using port 443. 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 Java application before using the SolarWinds Observability Java Library.

Uninstall the agent for AppOptics

Follow the instructions in the Uninstall the Java Agent topic in AppOptics documentation to disable, remove any SDK that is used, and uninstall the agent.

For migration, it is required to remove references to the AppOptics SDK from your application. The AppOptics configuration file should not be reused for SolarWinds Observability.

Install the library for SolarWinds Observability

  1. Follow the instructions in Add a Java service to set up your Java application as a monitored service in SolarWinds Observability.

  2. Set the collector configuration option to the AppOptics endpoint collector.appoptics.com:443. Use a config option, an environment variable, or a system property to override the default APM collector endpoint.

The Java Library for SolarWinds Observability is a custom distro based on the OpenTelemetry Java agent. The supported components, configuration, and instrumentation SDK are different from AppOptics.