No description
Find a file
2022-10-18 21:41:39 +02:00
collector collect option 2020-12-29 14:10:47 +01:00
grafana grafana update 2022-05-26 07:39:47 +02:00
hue metric file rename 2020-12-29 14:24:09 +01:00
metric collect option 2020-12-29 14:10:47 +01:00
.env.template update 2022-10-18 21:41:39 +02:00
.gitignore more generic metric 2020-12-28 17:29:44 +01:00
docker-compose.yml docker files 2022-10-18 21:29:35 +02:00
Dockerfile.multistage docker files 2022-10-18 21:29:35 +02:00
go.mod go update 2021-11-23 22:24:35 +01:00
go.sum go update 2021-11-23 22:24:35 +01:00
hue_metrics.json typo fix 2020-12-29 15:14:36 +01:00
LICENSE Initial commit 2020-12-18 20:45:51 +01:00
main.go typo fix 2020-12-29 15:14:36 +01:00
README.md metric output 2020-12-30 17:30:12 +01:00

Philips Hue exporter for prometheus

This exporter exports some variables from Philips Hue Bridge (https://www.philips-hue.com) to prometheus.

Building

go get github.com/aexel90/hue_exporter/
cd $GOPATH/src/github.com/aexel90/hue_exporter
go install

Running

How to create a user for your bridge is described here: https://developers.meethue.com/develop/get-started-2/

Usage:

$GOPATH/bin/hue_exporter -h

Usage of ./hue_exporter:
    -collect
            Collect all available metrics
    -collect-file string
            The JSON file where to store collect results
    -hue-url string
            The URL of the bridge
    -listen-address string
            The address to listen on for HTTP requests. (default "127.0.0.1:9773")
    -metrics-file string
            The JSON file with the metric definitions. (default "hue_metrics.json")
    -test
            Test configured metrics
    -username string
            The username token having bridge access

Example execution

Running within prometheus:

$GOPATH/bin/hue_exporter -hue_url 192.168.xxx.xxx -username ZlEH24zabK2jTpJ...  -metrics-file hue_metrics.json 

# HELP hue_bridge_info Non-numeric data, value is always 1
# TYPE hue_bridge_info gauge
hue_bridge_info{api_version="...",bridge_id="...",internetservice_internet="...",internetservice_remoteaccess="...",internetservice_swupdate="...",internetservice_time="...",ip_address="...",local_time="...",model_id="...",name="...",sw_update_last_change="...",sw_version="...",zigbee_channel="..."} 1
...
# HELP hue_light_info Non-numeric data, value is always 1
# TYPE hue_light_info gauge
hue_light_info{id="...",manufacturer_name="...",model_id="...",name="...",state_alert="...",state_bri="...",state_color_mode="...",state_ct="...",state_on="...",tate_reachable="...",state_saturation="...",sw_config_id="...",sw_version="...",type="...",unique_id="..."} 1
...
# HELP hue_light_state light status (1=ON, 0=OFF)
# TYPE hue_light_state gauge
hue_light_state{name="..."} 1
...
# HELP hue_sensor_info Non-numeric data, value is always 1
# TYPE hue_sensor_info gauge
hue_sensor_info{config_battery="...",config_on="...",config_reachable="...",id="...",manufacturer_name="...",model_id="...",name="...",state_buttonevent="...",tate_daylight="...",state_lastupdated="...",state_lightlevel="...",state_temperature="...",sw_version="...",type="...",unique_id="..."} 1
...
# HELP hue_sensor_lightlevel light level
# TYPE hue_sensor_lightlevel gauge
hue_sensor_lightlevel{name="..."} 0
...
# HELP hue_sensor_temperature temperature level celsius degree
# TYPE hue_sensor_temperature gauge
hue_sensor_temperature{name="..."} 2016

Test exporter:

$GOPATH/bin/hue_exporter -hue_url 192.168.xxx.xxx -username ZlEH24zabK2jTpJ... -test -metrics-file hue_metrics.json

Collect:

$GOPATH/bin/hue_exporter -hue_url 192.168.xxx.xxx -username ZlEH24zabK2jTpJ... -collect -metrics-file hue_metrics.json -collect-file result.json

Grafana Dashboard

Dashboard ID is 13645.

Grafana