Basic Agent Usage for Red Hat


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

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

Open the configuration file:

 nano /etc/sts-agent/stackstate.conf

Change dd_url to the http://<stackstate_hostname>:7070/stsAgent/ where <stackstate_hostname> is the hostname of the StackState server. Uncomment (by removing #) use_curl_http_client and change its value to yes.


After starting the agent, open StackState via the browser on http://<stackstate-hostname>:7070 and click on the Discovered view. By default, the Discovered view shows the components discovered by the installed agents. More information about StackState’s concepts can be found here.

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/stackstate/supervisord.log
  • /var/log/stackstate/collector.log
  • /var/log/stackstate/stsstatsd.log
  • /var/log/stackstate/forwarder.log


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


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.