Upgrading the Python 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 Python Library

The Python 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 Python Library, uninstall the AppOptics Python Agent and follow the rest of the steps described in Migrate the Python Library from AppOptics to SolarWinds Observability. Before restarting the application, make the following additional configuration changes to have the SolarWinds Observability Python 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

The agent is distributed as a standard module on pypi; you can upgrade the way you would another Python package, eg.:

pip install --upgrade appoptics-apm

Upgrading from AppOptics agent 2.x

The agent was named appoptics in versions prior to 3.x. This documents the upgrade from version 2.x to 3.x.

1. Install the new appoptics-apm package
2. Reconfigure instrumented applications following the steps documented to enable the agent
3. Once all applications are migrated to use the new package, remove the old appoptics package
4. Update requirements or other dependency management files as needed to refer to the appoptics-apm package

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.