家友导出器

Prometheus 导出器，用于 TP-Link Kasa 智能家居产品。

导出本地网络中所有设备的指标。

支持的产品

可能还有其他具有相同API的产品。以下产品已经过测试。

智能WiFi插座（HS110）

智能WiFi插座（KP115）

导出指标

所有三个指标均通过API报告，带有 device_id 和 device_alias 标签

• 设备电流安培数
• 设备电压伏特
• 设备功率瓦特
• 设备总电能焦耳

构建

安装Rust，然后从克隆的仓库中

$ cargo build --release

用法

构建后，运行以下命令以获取帮助

$ ./target/release/kasa_exporter --help
Prometheus exporter for TP-Link kasa devices

Usage: kasa_exporter [OPTIONS]

Options:
      --web.listen-address <LISTEN_ADDRESS>
          Address on which to expose metrics and web interface [default: [::1]:12345]
  -h, --help
          Print help
  -V, --version
          Print version

注意，web.listen-address 期望 <ip>:<port>，例如。

• 127.0.0.1:12345 用于IPv4
• [::1]:12345 用于IPv6

示例响应

$ curl https://127.0.0.1:12345/
# HELP device_electric_current_amperes Corrent reading from device
# TYPE device_electric_current_amperes gauge
device_electric_current_amperes{device_alias="Banana",device_id="800607035E84C0B634C36B7DF52CCEC3188C1BAB"} 0.256972
device_electric_current_amperes{device_alias="Potato",device_id="800691A498F774D60997B91E241EE2CC18D08921"} 0.031424
# HELP device_electric_potential_volts Voltage reading from device
# TYPE device_electric_potential_volts gauge
device_electric_potential_volts{device_alias="Banana",device_id="800607035E84C0B634C36B7DF52CCEC3188C1BAB"} 123.16094
device_electric_potential_volts{device_alias="Potato",device_id="800691A498F774D60997B91E241EE2CC18D08921"} 123.130631
# HELP device_electric_power_watts Power reading from device
# TYPE device_electric_power_watts gauge
device_electric_power_watts{device_alias="Banana",device_id="800607035E84C0B634C36B7DF52CCEC3188C1BAB"} 30.071476
device_electric_power_watts{device_alias="Potato",device_id="800691A498F774D60997B91E241EE2CC18D08921"} 0.750854

许可证

MIT