Documentation forSolarWinds Observability

Migrate the Python Library from AppOptics 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 Python installation before using the Python Library.

Migrate from AppOptics

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

  1. Remove any references to the AppOptics custom instrumentation API in your application code.

    Save a list detailing your application's usage so that it can be updated for the SolarWinds Observability Python Library's API.

  2. Uninstall the AppOptics agent.

    1. Undo the steps taken to load the agent into your application. See Enabling the Agent instructions in the AppOptics Administrator Guide.

      For example, if you used an import statement to add the appoptics_apm module to the application code, remove the added statement from your code.

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

  3. Install the SolarWinds Observability Python Library. See Install the Python Library.

  4. Set the collector configuration option to the AppOptics endpoint collector.appoptics.com:443. Use a config option or an environment variableconfigure.htm to override the default APM collector endpoint.

  5. Update the instrumentation API, if needed. See SDK for more information.

    The SolarWinds Observability Python Library is an OpenTelemetry custom distro and supports the standard OTel tracing API.

    Most of the AppOptics instrumentation SDK have a corresponding OTel API available for use. The current gaps listed below will be addressed in upcoming releases:

    • Custom Metrics
    • Custom Transaction Name