This repository contains the Agent Integrations (also known as checks) that StackState officially develops and supports. The StackState Agent packages are equipped with all the Integrations from this repository.
For information on how to develop your own integrations, see the developer guide on the StackState docs site.
Prerequisites:
- python 3
- bash
To setup the environment:
$ source .setup-scripts/setup_env.sh
From this point on the checksdev script is in scope and commands can be ran.
If you make any change to checksdev, you will need to reload it:
$ source .setup-scripts/load_deps.sh
Add a check:
$ checksdev create <check_name>
After defining the dependencies which the check needs in <check_name>/requirements.in make sure to run:
$ checksdev dep freeze
this will update the agent_requirements.in file to be used by the stackstate-agent build.
Use the checksdev env command to do manual testing. Testing always happens in an environment, to list all environments run:
$ checksdev env ls mysql
To start testing the check under local development run:
$ checksdev env start mysql 5.7
Run tests:
$ checksdev test --cov <check_name>
You can also select specific comma-separated environments to test like so:
$ checksdev test <check_name>:<env1>,<env2>
First create an agent environment:
$ checksdev env start <check_name> <env1>
then you can run just once the check as you would do with a real agent:
$ checksdev env check <check_name> <env1> [-l DEBUG]
You can optionally pass a log level parameter, if not passed logging is disabled.
The CI image is built from .setup-scripts/image.
If you find anything missing in this README please amend it! :)