Go to file

Adam Goldsmith b2524c8799 Make `count` and `append_const` actions use `set_if` in icinga conf		2022-12-26 17:45:38 -05:00
check_home_assistant_state.py	Make `count` and `append_const` actions use `set_if` in icinga conf	2022-12-26 17:45:38 -05:00
README.md	Add a basic README.md	2022-11-29 18:18:13 -05:00

Check Home Assistant State

A check plugin for Nagios/Icinga/etc. that queries Home Assistant for the current state of entities.

Requirements

You will need a token for Home Assistant's REST API. Instructions to aquire one can be found here.

At a minimum, you need to specify the token, home assistant url, a device class to filter by, and warning/critical ranges. Example:

./check_home_assistant_state.py --token $HASS_TOKEN --url $HASS_URL --device-class battery --warning 20:100 --critical 10:100

See --help for more features/arguments.

A CheckCommand config for Icinga2 can be generated with --make-icinga-conf.