Basic Agent Usage for Red Hat

Installation

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

wget 'https://dl.bintray.com/stackstate-agent/stackstate-agent-yum-repo/stackstate-agent-1.0.0.git.369.2e575e4-1.el5.x86_64.rpm'

rpm -i stackstate-agent-1.0.0.git.369.2e575e4-1.el5.x86_64.rpm

After this set the dd_url in stackstate.conf.example to the location where stackstate is installed e.g. ‘http://stackstate.mycompany.com:7070/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

Configuration

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/

Troubleshooting

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 info@stackstate.com.