Huemon

Zabbix monitoring with low-level discovery for Philips Hue networks.

Requirements

• Zabbix server 5.0+
• Zabbix agent 5.0+
• Python 3.8+ on Zabbix agent machine

Installation

pip3 install huemon

Configuration

1. Copy config.example.yml from src/huemon to /path/to/config.yml
2. Make necessary changes
3. 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

Usage

Shell

HUEMON_CONFIG_PATH=/usr/bin/python3 -m huemon discover lights

Docker

docker run -v /path/to/huemon/config:/etc/huemon huemon:0.1.0 discover lights

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

Screenshots

Dashboards

Discoveries

Template

License

MPL-2.0