Documentation forAppOptics

SolarWinds Snap Agent (Windows)

The SolarWinds Snap Agent is based on Intel's Snap Telemetry Framework an open framework designed to simplify the collection, processing and publishing of system data through a single API.

Here are some key features of Snap:

  • Plugin Architecture: Easily add collectors, streaming collectors, processors and publishers.
  • Collectors - Collectors gather telemetry data at determined intervals.
  • Streaming Collectors - Streaming collectors gather telemetry data when they are available.
  • Processors - Process data before sending it on.
  • Publishers - Defines where to send the data - this is how we send the data to AppOptics.

Easy installation

To find the easy installation guide, go to AppOptics home page and click on the "Add Host" button. It will show you these steps to install the agent via our msi package:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi
  2. Run the installer as Administrator and provide your API key when requested. The installer also supports command line installation.

If agent installation fails, you can check the C:\ProgramData\SolarWinds\Snap\log directory for the installation log file.

Advanced Installation

Follow these steps to manually and install the agent:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi

  2. Copy solarwinds-snap-agent.msi file to a temporary location like C:\temp.

  3. Open a command prompt as Administrator and run following command with your API token:

    Copy
    set SOLARWINDS_TOKEN=<your api token>
    msiexec /q /lv* swisnap.log /i c:\temp\solarwinds-snap-agent.msi EULA=accept TOKEN=%SOLARWINDS_TOKEN%

Read more about msiexec Command-Line Options.

If agent installation fails, you can check c:\temp\swisnap.log for any installation errors.

Upgrade

To find the easy installation guide, go to the AppOptics home page and click on the "Add Host" button. It will show you the steps to install the agent via our msi package:

  1. Download agent msi installer from https://files.solarwinds.cloud/windows-solarwinds-snap-agent/solarwinds-snap-agent.msi
  2. Run the installer as Administrator.

If you've made local changes to C:\ProgramData\SolarWinds\Snap\config.yaml or default task files under C:\ProgramData\SolarWinds\Snap\tasks.d, the package manager should preserve those changes either by default or with an optional setting, please refer to your package manager manual for details.

Troubleshooting

To learn more about how to restart the SolarWinds Snap Agent, where its log file is located, and other common troubleshooting techniques, please check the Troubleshooting page.

Lean more about:

Uninstall

You can uninstall the SolarWinds Snap Agent software from the Programs and Features Control Panel.

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.