Agent V1 (Legacy)

Search…
StackState version 4.4
Agent V1 (Legacy)
This page describes StackState version 4.4.
Go to the documentation for the latest StackState release.
Overview
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.
StackState Agent V1 is open source: View the source code on GitHub.
Installation
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:
1
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'
Copied!
2.Use dpkg to install the downloaded package:
1
dpkg -i stackstate-agent_1.3.0-1_amd64.deb
Copied!
3.Set the following keys in the stackstate.conf.example file:
1
 api_key: {{config.apiKey}}
2
 dd_url: {{config.baseUrl}}/stsAgent/
Copied!
4.After this the example configuration can be used as configuration.
1
 cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf
Copied!
1.Download the StackState Agent V1 RPM package or run this command on the machine where you wish to install the Agent:
1
wget 'https://s3-eu-west-1.amazonaws.com/agent.stackstate.com/stackstate-agent-yum-repo/stackstate-agent_1.3.0-1.x86_64.rpm'
Copied!
2.Use rpm to install the downloaded package:
1
rpm -i stackstate-agent_1.3.0-1.x86_64.rpm
Copied!
3.Set the following keys in the stackstate.conf.example file:
1
 api_key: {{config.apiKey}}
2
 dd_url: {{config.baseUrl}}/stsAgent
Copied!
4.After this the example configuration can be used as configuration.
1
 cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf
Copied!
If you need further assistance, our support team will be glad to help.
Start / stop / restart the Agent
Commands require elevated privileges.
Restarting the StackState Agent will reload the configuration files.
To manually start, stop or restart the StackState Agent:
Linux
Windows
1
sudo /etc/init.d/stackstate-agent start
2
sudo /etc/init.d/stackstate-agent stop
3
sudo /etc/init.d/stackstate-agent restart
Copied!
CMD
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!
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!
Status and information
Linux
Windows
To check if StackState Agent V1 is running:
1
sudo /etc/init.d/stackstate-agent status
Copied!
To receive information about the StackState Agent V1 state:
1
sudo /etc/init.d/stackstate-agent info
Copied!
Tracebacks for errors can be retrieved by setting the -v flag:
1
sudo /etc/init.d/stackstate-agent info -v
Copied!
To check if the StackState Agent is running and receive information about the Agent's state:
1
"./agent.exe status"
Copied!
Troubleshooting
Try running the info command to see the state of StackState Agent V1.
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
If you are still having trouble, contact our support team on the StackState support site.
Advanced Agent configuration
Next - Setup
Data management
Last modified 4mo ago
Copy link
Contents
Overview
Installation
Start / stop / restart the Agent
Status and information
Troubleshooting