Monitor your Philips Hue network
Project description
Huemon
Zabbix monitoring with low-level discovery for Philips Hue networks.
Requirements
- Zabbix server 5.0+
- Zabbix agent 5.0+
- Python 3.7+ on Zabbix agent machine
Installation
pip3 install huemon
Configuration
- Copy
config.example.yml
fromsrc/huemon
to/path/to/config.yml
- Make necessary changes
- Provide the path through environment variable
HUEMON_CONFIG_PATH
Enabling commands and discoveries
Automatically
HUEMON_CONFIG_PATH=/path/to/config.yml python3 -m huemon install_available commands
HUEMON_CONFIG_PATH=/path/to/config.yml python3 -m huemon install_available discoveries
Manually
ln -s /path/to/commands_available/command_name.py /path/to/commands_enabled/command_name.py
ln -s /path/to/discoveries_available/command_name.py /path/to/discoveries_enabled/command_name.py
Zabbix agent configuration
# file:/path/to/zabbix/agent/conf.d/hue.conf
UserParameter=hue.discovery[*],HUEMON_CONFIG_PATH=/path/to/config.yml /usr/bin/python3 -m huemon discover $1
UserParameter=hue.value[*],HUEMON_CONFIG_PATH=/path/to/config.yml /usr/bin/python3 -m huemon $1 $2 $3
Or Docker
# file:/path/to/zabbix/agent/conf.d/hue.conf
UserParameter=hue.discovery[*],docker-compose run huemon discover $1
UserParameter=hue.value[*],docker-compose run huemon $1 $2 $3
Or agent mode
# file:/path/to/zabbix/agent/conf.d/hue.conf
UserParameter=hue.discovery[*],curl http://127.0.0.1:8000/discover?q=$1
UserParameter=hue.value[*],curl http://127.0.0.1:8000/$1?q=$2\&q=$3
Configure Systemd service
An installer that configures Huemon as a Systemd service is included in this repository. It uses /etc/huemon/config.yml
as the configuration path.
assets/service-installer.sh install
Usage
Shell
HUEMON_CONFIG_PATH=/usr/bin/python3 -m huemon discover lights
Or agent mode
HUEMON_CONFIG_PATH=/usr/bin/python3 -m huemon agent start
Docker
Provide a configuration path for the huemon-config
volume in docker-compose.yml
before running the commands below.
docker-compose run huemon discover lights
Or agent mode
docker-compose up -d
Screenshots
Dashboards
Discoveries
Template
License
MPL-2.0
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
huemon-0.7.3.tar.gz
(18.3 kB
view hashes)
Built Distribution
huemon-0.7.3-py3-none-any.whl
(33.6 kB
view hashes)