Agent V1 (Legacy)

StackState Self-hosted v5.0.x

This page describes StackState version 5.0.

Go to the documentation for the latest StackState release.


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.


Install StackState Agent V1 by using the following sequence of steps:

  1. Download the StackState Agent V1 Debian package or run this command on the machine where you wish to install the Agent:

  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

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:

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

Status and information

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


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.

Last updated