Host Agent (Windows)

The AppOptics host 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, processors, publishers and streaming collectors.
  • Collectors - Collectors gather telemetry data at determined intervals.
  • 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 host agent via our msi package:

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

Note

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

Advanced Installation

Follow these steps to manually and install the agent:

  1. Download host agent msi installer from https://files.appoptics.com/windows-host-agent/appoptics-snaptel.msi

  2. Copy appoptics-snaptel.msi file to a temporary location like C:\temp.

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

    set APPOPTICS_TOKEN=<your api token>
    
    msiexec /q /lv* appoptics.log /i c:\temp\appoptics-snaptel.msi EULA=accept TOKEN=%APPOPTICS_TOKEN%
    

Read more about msiexec Command-Line Options.

Note

If host agent installation fails, you can check c:\temp\appoptics.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 host agent via our msi package:

  1. Download host agent msi installer from https://files.appoptics.com/windows-host-agent/appoptics-snaptel.msi
  2. Run the installer as Administrator.

Note

If you’ve made local changes to C:\ProgramData\AppOptics\Snap\config.yaml or default task files under C:\ProgramData\AppOptics\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 Host 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 Agent software from the Programs and Features Control Panel

../../../_images/Windows_Uninstall.png