HueBridge 输入插件
此插件使用设备的 CLIP API 接口，从 Hue Bridge 设备收集状态。
引入于: Telegraf v1.34.0 标签: iot 操作系统支持: all
全局配置选项
插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。
配置
# Gather smart home status from Hue Bridge
[[inputs.huebridge]]
## URL of bridges to query in the form <scheme>://<bridge id>:<user name>@<address>/
## See documentation for available schemes.
bridges = [ "address://<bridge id>:<user name>@<bridge hostname or address>/" ]
## Manual device to room assignments to apply during status evaluation.
## E.g. for motion sensors which are reported without a room assignment.
# room_assignments = { "Motion sensor 1" = "Living room", "Motion sensor 2" = "Corridor" }
## Timeout for gathering information
# timeout = "10s"
## Optional TLS Config
# tls_ca = "/etc/telegraf/ca.pem"
# tls_cert = "/etc/telegraf/cert.pem"
# tls_key = "/etc/telegraf/key.pem"
# tls_key_pwd = "secret"
## Use TLS but skip chain & host verification
# insecure_skip_verify = false扩展桥接访问选项
要查询的 Hue 桥接可以通过以下形式的 URL 定义
<locator scheme>://<bridge id>:<user name>@<locator dependent address>/其中 bridge id 是返回的唯一桥接 ID
curl -k https://<address>/api/config/0而 user name 是在应用程序身份验证期间返回的秘密用户名。
要创建新的用户名，请在按下桥接的连接按钮后发出以下命令
curl -k -X POST http://<bridge address>/api \
-H 'Content-Type: application/json' \
-d '{"devicetype":"huebridge-telegraf-plugin"}'scheme 可以是以下值之一，并且还将决定 address 部分的结构。
address 方案
访问本地桥接，其中 address 是桥接的 DNS 名称或 IP 地址，例如
address://0123456789ABCDEF:sFlEGnMAFXO6RtZV17aViNUB95G2uXWw64texDzD@mybridge/cloud 方案
使用此方案，插件通过其云注册发现桥接。address 部分定义了要使用的发现端点。如果未另行指定，则使用 标准发现端点，例如
cloud://0123456789ABCDEF:sFlEGnMAFXO6RtZV17aViNUB95G2uXWw64texDzD@/mdns 方案
此方案使用 mDNS 来发现桥接。对于此方案，请将 address 部分留空，例如
mdns://0123456789ABCDEF:sFlEGnMAFXO6RtZV17aViNUB95G2uXWw64texDzD@/remote 方案
此方案通过 Cloud Remote API 访问桥接。address 部分定义了云 API 端点，默认为 标准 API 端点。
remote://0123456789ABCDEF:sFlEGnMAFXO6RtZV17aViNUB95G2uXWw64texDzD@/为了使用此方法，需要 Hue 开发者帐户，必须注册远程应用程序，并且必须完成相应的授权流程。有关详细信息，请参阅 Cloud2Cloud 入门文档。
此外，remote_client_id、remote_client_secret 和 remote_callback_url 参数必须在插件配置中设置，与应用程序注册期间使用的完全相同。
此外，remote_token_dir 参数必须指向包含持久化令牌的目录。
Metrics
huebridge_light- 标签 (tags)
bridge_id- 桥接 ID（查询此指标的桥接）room- 房间名称device- 设备名称
- 字段 (fields)
on(int) - 0：灯关闭 1：灯打开
- 标签 (tags)
huebridge_temperature- 标签 (tags)
bridge_id- 桥接 ID（查询此指标的桥接）room- 房间名称device- 设备名称enabled- 传感器的当前状态（活动：true|false）
- 字段 (fields)
temperature(float) - 当前温度（摄氏度）
- 标签 (tags)
huebridge_light_level- 标签 (tags)
bridge_id- 桥接 ID（查询此指标的桥接）room- 房间名称device- 设备名称enabled- 传感器的当前状态（活动：true|false）
- 字段 (fields)
light_level(int) - 当前光照水平（人类友好尺度 10.000*log10(lux)+1）light_level_lux(float) - 当前光照水平（勒克斯）
- 标签 (tags)
huebridge_motion_sensor- 标签 (tags)
bridge_id- 桥接 ID（查询此指标的桥接）room- 房间名称device- 设备名称enabled- 传感器的当前状态（活动：true|false）
- 字段 (fields)
motion(int) - 0：未检测到运动 1：检测到运动
- 标签 (tags)
huebridge_device_power- 标签 (tags)
bridge_id- 桥接 ID（查询此指标的桥接）room- 房间名称device- 设备名称
- 字段 (fields)
battery_level(int) - 电源状态（正常、低、危急）battery_state(string) - 电池充电水平（百分比）
- 标签 (tags)
示例输出
huebridge_light,huebridge_bridge_id=0123456789ABCDEF,huebridge_room=Name#15,huebridge_device=Name#3 on=0 1734880329
huebridge_temperature,huebridge_room=Name#15,huebridge_device=Name#7,huebridge_device_enabled=true,huebridge_bridge_id=0123456789ABCDEF temperature=17.63 1734880329
huebridge_light_level,huebridge_bridge_id=0123456789ABCDEF,huebridge_room=Name#15,huebridge_device=Name#7,huebridge_device_enabled=true light_level=18948,light_level_lux=78.46934003526889 1734880329
huebridge_motion_sensor,huebridge_bridge_id=0123456789ABCDEF,huebridge_room=Name#15,huebridge_device=Name#7,huebridge_device_enabled=true motion=0 1734880329
huebridge_device_power,huebridge_bridge_id=0123456789ABCDEF,huebridge_room=Name#15,huebridge_device=Name#7 battery_level=100,battery_state=normal 1734880329此页面是否有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持，请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。