The StackState Agent collects events and metrics and brings them to your StackState instance for further analysis.
It includes telemetry information from various sources, as well as topology information based on connbeat.
All checks have been moved to the Integration SDK. Please look there to submit related issues, PRs, or review the latest changes.
Setup your environment
- python 2.7
- bundler (to get it:
gem install bundler)
# Clone the repository git clone email@example.com:StackVista/sts-agent.git # Create a virtual environment and install the dependencies: cd sts-agent bundle install rake setup_env # NOTE: on mac osx python2 might be missing as an exectuable, failing the setup_env. Add this as a symlink # Activate the virtual environment source venv/bin/activate # Lint bundle exec rake lint # Run a flavored test bundle exec rake ci:run[apache] # Start agent locally # Assumes integrations in ../integrations and configurations in ./conf.d rake run
More about how to write tests and run them here
How to configure the Agent
If you are using packages on linux, the main configuration file lives
/etc/sts-agent/stackstate.conf. Per-check configuration files are in
/etc/sts-agent/conf.d. We provide an example in the same directory
that you can use as a template.
How to write your own checks
Writing your own checks is easy using our checks.d interface. Read more about how to use it on our Guide to Agent Checks.