4 releases
0.1.4 | Sep 6, 2020 |
---|---|
0.1.3 | Sep 6, 2020 |
0.1.1 | Sep 6, 2020 |
0.1.0 | Sep 6, 2020 |
#216 in Email
24KB
441 lines
totmannschalter
A simple Rust-based service that monitors multiple http(s) endpoints with different intervals and notifies administrators if the service goes down. Another notification is sent once it is back up again. Totmannschalter is German for dead man's switch – a contraption which is meant to halt operations or send a notice in the absence of a certain signal. In trains it is a switch that needs to be tapped periodically to make sure person operating the train is still awake and conscious.
Features
- per-endpoint configuration for values like interval and contact email
- toml based configuration
- sends you the error message and if the service is back up, information on how long it has been down
Installation
Using Rust cargo
- Make sure you have Rust installed
- Run
cargo install totmannschalter
You should now be able to run totmannschalter
directly from the CLI. If you want to run it as a system service (e.g. on system startup) you have to either create something yourself (if you are not on a OS that uses systemd) or install the totmannschalter.service
file present in the repository like this:
# Run as root so the config will be created in the right place
sudo totmannschalter
# Setup the config (your path could be different!)
sudo vim /etc/totmannschalter/config.toml
# Download the service file
wget https://raw.githubusercontent.com/atoav/totmannschalter/master/totmannschalter.service
# Find out where your totmannschalter is installed
which totmannschalter
# Use the output from the which command above and replace the path
# right of ExecStar in the systemd unit file:
vim totmannschalter.service
# Copy the unit file to your services
sudo cp totmannschalter.services /etc/systemd/system/
# Enable the service (so it runs automatically after the next system startup)
sudo systemctl enable totmannschalter
# Start the service (so it starts right away)
sudo systemctl start totmannschalter
# Check what is going on
journalctl -fu totmannschalter
Using Debian package (.deb)
Build the package yourself
- Make sure you have
cargo
installed - Install
cargo-deb
usingcargo install cargo-deb
- Run
cargo deb
in the root of the repository - Go to
target/debian/
- Install the package using
sudo dpkg -i totmanschalter<TAB>
- Make sure to run
sudo totmannschalter
at least once before enabling the service, so a default config file can be created. Alternatively you could also run totmannschalter as a regular user service without root then you would have to create your own user service file and skip the rest of the steps - Enable the service:
sudo systemctl enable totmannschalter
- Start the service
sudo systemctl start totmannschalter
- Check the status of the service:
systemctl status totmannschalter
orjournalctl -fu totmannschalter
Use a release build
See the github releases page : )
Dependencies
~8–21MB
~339K SLoC