Upgrading the .NET 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.
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 .NET Library
The .NET 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 .NET Library, uninstall the AppOptics .NET Agent and follow the rest of the steps described in Migrate the .NET Library from AppOptics to SolarWinds Observability. Before restarting the application, make the following additional configuration changes to have the SolarWinds Observability .NET 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
Upgrading IIS Only instrumentation
- Run
iisreset /STOP
to stop IIS - Run the uninstaller:
C:\Program Files\AppOptics\APM\dotnet\unins000.exe
The uninstaller filename has the formatunins<nnn>.exe
wherennn
will increment on reinstalls. - Download the latest .NET Agent from https://files.appoptics.com/dotnet/DotNetAgent_Setup.exe
- Run the new installer
- Run
iisreset /START
to start IIS
Upgrading IIS and non-IIS instrumentation
These steps document how to upgrade the .NET agent when both IIS and non-IIS services are being instrumented.
- Run
iisreset /STOP
to stop IIS - Stop services configured in the applications section of the agent.config file
- Run the uninstaller:
C:\Program Files\AppOptics\APM\dotnet\unins000.exe
- Download the latest .NET Agent from https://files.appoptics.com/dotnet/DotNetAgent_Setup.exe
- Run the new .NET agent installer
- Run
iisreset /START
to start IIS - Restart any services stopped in Step 2
AppOptics.Instrumentation NuGet Package
The AppOptics.Instrumentation NuGet package has been deprecated and is no longer supported. The package has been replaced with the AppOptics.Agent NuGet package. In addition to providing the same functionality as the AppOptics.Instrumentation NuGet package, the AppOptics.Agent package also provides automatic instrumentation support. See AppOptics.Agent NuGet package (legacy agent).