Documentation forAppOptics
AppOptics will reach its End of Service Life on September 30, 2025. Migrate to the next generation APM solution before September 30. See FAQ for details. Documentation is no longer being updated, and some features or links may not work as described.

Upgrading the PHP Agent

AppOptics agents are no longer receiving updates. The new SolarWinds Observability libraries are regularly updated with new features and improvements. If you are still relying on the AppOptics agents and your components are supported by the new libraries, consider migrating to SolarWinds Observability.

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.

Upgrading to the SolarWinds Observability PHP Library

The PHP 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.

Complete migration

SolarWinds recommends that you migrate completely from AppOptics to SolarWinds Observability. For more information about a complete migrations, see Migrate from AppOptics to SolarWinds Observability SaaS. To upgrade to the SolarWinds Observability PHP Library as part of a complete migration, see Migrate the PHP Library from AppOptics to SolarWinds Observability.

Partial migration

Alternatively, you can upgrade to the SolarWinds Observability PHP Library but send data to AppOptics.

  1. Uninstall AppOptics with the appoptics-php.sh script.

    $ appoptics-php.sh --mode=uninstall

    See Uninstalling the AppOptics PHP Agent for more information.

  2. Update references to any custom instrumentation function names in your application code.

    Include the updated api.php stub file in your application. See PHP Library instrumentation SDK for more information.

  3. Add a PHP service in SolarWinds Observability.

  4. After your PHP service is installed, click APM in SolarWinds Observability, and then click All services. Search for your service name to verify that it was installed correctly.

  5. Set a valid AppOptics service key. See the SolarWinds Observability configuration options for the new configuration file and environment variable names.

  6. Set the collector configuration option to the AppOptics endpoint collector.appoptics.com:443. Use a configuration in an INI file to override the default APM collector endpoint.

Upgrade to a newer version of the legacy AppOptics Agent

The steps and commands for upgrading the instrumentation are exactly the same as for installation. If you are using the wrapper script, then a new version is only pulled down if necessary (in case the installed instrumentation is older than the latest available).