Agent V1 (Legacy)
StackState Self-hosted v4.6.x
This page describes StackState version 4.6.
StackState Agent V1 allows you to run checks that connect to Splunk to retrieve metrics and events data. All other Agent checks run on StackState Agent V2.
Install StackState Agent V1 by using the following sequence of steps:
Debian, Ubuntu
Amazon linux, CentOS, Fedora, Red Hat
- 1.Download the StackState Agent V1 Debian package or run this command on the machine where you wish to install the Agent:wget https://s3-eu-west-1.amazonaws.com/agent.stackstate.com/stackstate-agent-deb-repo/pool/s/stackstate-agent/stackstate-agent_1.3.0-1_amd64.deb'
- 2.Use
dpkg
to install the downloaded package:dpkg -i stackstate-agent_1.3.0-1_amd64.deb - 3.Set the following keys in the
stackstate.conf.example
file:api_key: {{config.apiKey}}dd_url: {{config.baseUrl}}/stsAgent/ - 4.After this the example configuration can be used as configuration.cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf
- 1.Download the StackState Agent V1 RPM package or run this command on the machine where you wish to install the Agent:wget 'https://s3-eu-west-1.amazonaws.com/agent.stackstate.com/stackstate-agent-yum-repo/stackstate-agent_1.3.0-1.x86_64.rpm'
- 2.Use
rpm
to install the downloaded package:rpm -i stackstate-agent_1.3.0-1.x86_64.rpm - 3.Set the following keys in the
stackstate.conf.example
file:api_key: {{config.apiKey}}dd_url: {{config.baseUrl}}/stsAgent - 4.After this the example configuration can be used as configuration.cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf
- Commands require elevated privileges.
- Restarting the StackState Agent will reload the configuration files.
To manually start, stop or restart the StackState Agent:
Linux
Windows
sudo /etc/init.d/stackstate-agent start
sudo /etc/init.d/stackstate-agent stop
sudo /etc/init.d/stackstate-agent restart
CMD
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" start-service
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" stopservice
"C:\Program Files\StackState\StackState Agent\embedded\agent.exe" restart-service
PowerShell
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" start-service
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" stopservice
& "C:\Program Files\StackState\StackState Agent\embedded\agent.exe" restart-service
Linux
Windows
To check if StackState Agent V1 is running:
sudo /etc/init.d/stackstate-agent status
To receive information about the StackState Agent V1 state:
sudo /etc/init.d/stackstate-agent info
Tracebacks for errors can be retrieved by setting the
-v
flag:sudo /etc/init.d/stackstate-agent info -v
To check if the StackState Agent is running and receive information about the Agent's state:
"./agent.exe status"
Logs for the subsystems are in the following files:
/var/log/stackstate/supervisord.log
/var/log/stackstate/collector.log
/var/log/stackstate/stsstatsd.log
/var/log/stackstate/forwarder.log
Last modified 11mo ago