Basic Agent Usage for Amazon Linux


This guide will outline the basic functionality of the Stackstate Agent. Navigate to and select the required version. To install the agent follow the following commands

wget '<stackstate-agent>.rpm'

rpm -i <stackstate-agent>.rpm

After this set the dd_url in stackstate.conf.example to the location where stackstate is installed e.g. ‘/stsAgent/‘. After this the axample configuration can be used as configuration.

cp /etc/sts-agent/stackstate.conf.example /etc/sts-agent/stackstate.conf

The process to upgrade from the previous version of the agent is to simply re-run the installation.

Starting and Stopping the Agent

To manually start the Agent:

sudo /etc/init.d/stackstate-agent start

To stop the Agent:

sudo /etc/init.d/stackstate-agent stop

To restart the Agent and to reload the configuration files:

sudo /etc/init.d/stackstate-agent restart

Status and Information

To check if the Agent is running:

sudo /etc/init.d/stackstate-agent status

To receive information about the Agent’s 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


The configuration file for the Agent is located at /etc/sts-agent/stackstate.conf

Configuration files for integrations are located in /etc/sts-agent/conf.d/


Try running the info command to see the state of the Agent.

Logs for the subsystems are in the following files:

  • /var/log/supervisor/stackstate-supervisord.log
  • /var/log/stackstate/collector.log
  • /var/log/stackstate/stsstatsd.log
  • /var/log/stackstate/forwarder.log

If you’re still having trouble, our support team will be glad to provide further assistance. You can contact them in one of the following ways:

Support Site

Find our support team on our support site.