|Norwin Roosen 97db2d0b9e regression: only run checks for specified target||4 months ago|
|.scripts||5 months ago|
|cmd||5 months ago|
|core||4 months ago|
|docs||5 months ago|
|utils||5 months ago|
|.gitignore||5 months ago|
|.travis.yml||5 months ago|
|README.md||5 months ago|
|main.go||5 months ago|
Cross platform command line application to run health checks against sensor stations registered on openSenseMap.org.
This tool lets you automatically check if senseBoxes are still runnning correctly, and when that’s not the case, notifies you. Currently, email notifications are implemented, but other transports can be added easily. Implemented health checks are described below, and new ones can be added just as easily (given some knowledge of programming).
The tool has multiple modes of operation:
osem_notify check boxes: run one-off checks on boxes
osem_notify watch boxes: check boxes continuously.
osem_notify help or check the manual in the docs/ directory for more details.
Download a build from the releases page.
You can run the application by running
./osem_notify* in a terminal in your downloads directory.
On unix platforms you may need to make it executable, and can add it to your
$PATH for convenience, so it is always callable via
chmod +x osem_notify* sudo mv osem_notify* /usr/bin/osem_notify
The tool works out of the box for basic functionality, but must be configured to set up notifications.
Configuration can be done via a YAML file located at
~/.osem_notify.yml or through environment variables.
osem_notify help config for details and an example configuration.
||Alert when a sensor has not submitted measurements within a given duration.|
||Alert when a sensor’s last reading was a presumably faulty value (e.g. broken / disconnected sensor).|
||Alert when a sensor’s last measurement is lower than a given value.|
||Alert when a sensor’s last measurement is higher than a given value.|
Want more? add it!
Want to use
osem_notify on a platform where no builds are provided?
Assuming you have golang installed, run
go get -v -d ./ go build main.go
For cross-compilation, check this guide out.
Contributions are welcome! Check out the following locations for plugging in new functionality:
Before committing and submitting a pull request, please run
go fmt ./ cmd/ core/.
GPL-3.0 Norwin Roosen