Windows

Search…
StackState version 4.4
Windows
Overview
StackState Agent V2
StackState Agent V2 can be installed on Windows systems . The Agent collects data from the host where it is running and can be configured to integrate with external systems. Retrieved data is pushed to StackState, to work with this data the StackState Agent V2 StackPack must be installed in your StackState instance. For details of the data retrieved and available integrations, see the StackPack integration documentation.
Setup
Supported versions
StackState Agent V2 is supported to run on:
Windows 10 or higher
Windows Server 2012 or higher
Install
StackState Agent V2 is installed using a PowerShell (docs.microsoft.com) script.
​Online install - If you have access to the internet on the machine where the Agent will be installed. 
​Offline install - If you do not have access to the internet on the machine where the Agent will be installed.
The stsApiKey and stsUrl (baseUrl) specified when running the install script are set during StackState installation, for details see:
​StackState Kubernetes install - configuration parameters 
​StackState Linux install - configuration parameters 
Online install
If you have access to the internet on the machine where the Agent will be installed, the install.ps1 script can be run using iwr and the Agent installer package will be downloaded automatically.
1
. { iwr -useb https://stackstate-agent-2.s3.amazonaws.com/install.ps1 } | iex; `
2
install -stsApiKey "{{config.apiKey}}" `
3
-stsUrl "{{config.baseUrl}}/stsAgent"
Copied!
Offline install
If you do not have access to the internet on the machine where the Agent will be installed, you will need to download both the install script and the Agent installer package before you install.
1.Download the PowerShell install script and copy this to the host where it will be installed:
​https://stackstate-agent-2.s3.amazonaws.com/install.ps1​
2.Download the latest version of the Agent installer package and copy this to the host where it will be installed next to the PowerShell install script:
​https://stackstate-agent-2.s3.amazonaws.com/windows/stable/stackstate-agent-latest-1-x86_64.msi​
3.Assuming the installer script is saved as C:\stackstate-custom.msi and the PowerShell script is saved as C:\install_script.ps1, open PowerShell with elevated privileges and invoke the following set of commands:
1
Import-Module C:\install_script.ps1
2
install -stsApiKey {{config.apiKey}} `
3
-stsUrl {{config.baseUrl}}/stsAgent `
4
-f C:\\stackstate-custom.msi
Copied!
Upgrade
To upgrade StackState Agent V2 running on Windows,
1.Download the latest version of the Agent installer package and copy this to the host where it will be installed next to the PowerShell install script:
​https://stackstate-agent-2.s3.amazonaws.com/windows/stable/stackstate-agent-latest-1-x86_64.msi​
2.Double-click on the downloaded *.msi file.   
Configure
Agent configuration
The StackState Agent V2 configuration is located in the file C:\ProgramData\StackState\stackstate.yaml. The stsApiKey and stsUrl specified during installation will be added here by the install script. No further configuration should be required.
Advanced Agent configuration
A number of advanced configuration options are available for StackState Agent V2. These can be set in the Agent configuration file C:\ProgramData\StackState\stackstate.yaml and are described in detail on the page advanced Agent configuration.
Integration configuration
The Agent can be configured to run checks that integrate with external systems. Configuration files for integrations run through StackState Agent V2 can be found in the directory C:\ProgramData\StackState\conf.d. Each integration has its own configuration file that is used by the enabled Agent checks.
Documentation for the available StackState integrations, including configuration details can be found on the StackPacks > Integrations pages.
Commands
Commands require elevated privileges.
Start, stop or restart the Agent
To manually start, stop or restart StackState Agent V2:
CMD
PowerShell
1
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" start-service
2
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" stopservice
3
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" restart-service
Copied!
1
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" start-service
2
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" stopservice
3
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" restart-service
Copied!
Status
To check if StackState Agent V2 is running and receive information about the Agent's status:
1
"./agent.exe status"
Copied!
Manually run a check
Use the command below to manually run an Agent check once and output the results.
1
C:\Program Files\StackState\StackState Agent\embedded\agent.exe check <CHECK_NAME>
Copied!
Troubleshooting
To troubleshoot the Agent, try to check the Agent status or manually run a check.
Log files
Logs for the subsystems are in the following files:
C:\ProgramData\StackState\logs\agent.log
C:\ProgramData\StackState\logs\process-agent.log
Support knowledge base
Troubleshooting steps for any known issues can be found in the StackState support knowledge base.
Uninstall
To uninstall StackState Agent V2 running on Windows:
1.In the Windows task bar, search for control panel.
2.In the control panel, open Add/remove programs.
3.Follow the instructions to uninstall StackState Agent V2.
See also
​About the StackState Agent​
​Advanced Agent configuration  
​StackState Agent V2 StackPack​
​StackState Agent V2 (github.com)​