The Stackstate Agent is piece of software that runs on your hosts. Its job is to faithfully collect events and metrics and bring them to Stackstate on your behalf so that you can do something useful with your monitoring and performance data.
The source code for the Stackstate Agent can be found here.
The Agent has three main parts: the collector, stsstatsd, and the forwarder.
This is all controlled by one supervisor process. We keep this separate so you don’t have to have the overhead of each application if you don’t want to run all parts (though we generally recommend you do).
If you just installed the Agent, it might take a few moments before you start seeing metrics appear. The first place you can check for metrics is the Metrics Explorer.
If you think you might be experiencing issues, the first thing to do is run the info command and check the Agent logs. The info command and the log locations are dependent on your OS, which you can select from the navigation to the left for further information.
If you encountered an issue during the Agent installation that prevented any installation whatsoever from occurring, please reach out to firstname.lastname@example.org. Please let us know your OS and version, as well as how you are installing the Agent (and which agent version). Also, please include the errors you encountered along the way.
If you get the Agent installed but are not seeing any data in Stackstate, you can troubleshoot in the following manner. First, run the info command. Select your OS in the nav column on the left of this page to see how to run this. Does running the info command show any errors?
If not, you should also check the logs (location of the logs again depends on OS). Errors in the logs may also reveal the cause of any issues.
If not, please send both the full output of the info command and the logs as attachments to email@example.com.
We have also seen a few cases where machines have their clock set further in the future or the past, which can sometimes cause problems with metric submission. To check for this, run:
date -u && curl -s -v https://app.stackstate.com 2>&1 | grep Date
This will output the current system’s date, and then make a request to our endpoint and grab the date on our end. If these are more than a few minutes apart, you may want to look at the time settings on your server.
Here is a quick guide for troubleshooting getting integrations installed:
Run the info command (find this based on your OS in the left column above).
Is the integration showing up in the info command?