An icinga check_command wrapper to icinga api for submitting passive check results. Call any nagios/icinga compatible check executable to submit results as a passive result.
usage: passify.py [-h] [--config CONFIG] [--timeout TIMEOUT] -s SERVICE NAME [--ttl TTL] ...
Deploy passify.py on your server, this can be done locally or in your path. Call it with
python3 passify.py -s "Example Service" check_example <check_arguments>
or give it execution rights and call it like this:
./passify.py -s "Example Service" check_example <check_arguments>
Or in path like this:
passify -s "Example Service" check_example <check_arguments>
pip install icinga-passify
OR
- copy passify.py to your server.
- Install to path for full convenience if you like, call as seen above:
ln -s /usr/local/bin/passify /location/to/passify.py
-
Upon first run, you will be asked several configuration questions:
- the icinga master url submissions are only possible through the currently active master
- verify the fingerprint (hint:
openssl x509 -in /var/lib/icinga2/certs/<hostname>.crt -noout -fingerprint -sha256) - username and password for api submission (only basic-auth is currently supported)
-
alternatively you can deploy a config file (default: config.ini) with the script:
[DEFAULT]
url = https://localhost:5665/v1/actions/process-check-result
check_source = example.com
user = <api_user>
password = <api_password>
[TLS]
fingerprint = d163f22c2021a498926ff8c30da0288ac20d1b9edaa80d1dbb14c0aebf85245b