Basic Agent Usage for CentOS


This guide will outline the basic functionality of the Stackstate Agent. To install the agent follow the following commands

wget ''

rpm -i stackstate-agent-1.2.0-1.x86_64.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 configution 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: (since 3.8.0)

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: (since 3.8.0)

sudo /etc/init.d/stackstate-agent info -v

More information about the metrics, events and service checks for an integration can be retrieved with the check command:

sudo /etc/init.d/stackstate-agent check [integration]

Add the check_rate argument to get the most recent values for rates:

sudo /etc/init.d/stackstate-agent check [integration] check_rate


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 (since 3.8.0)
  • /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:

By Email

You can contact our Support Team via email at