KNX 输入插件
此服务插件通过 KNX-IP 接口连接，监听 KNX 家庭自动化总线 上的消息。有关支持的 KNX 数据点类型的信息可以在底层 knx-go 项目 中找到。
发布于: Telegraf v1.19.0 标签: iot 操作系统支持: all
服务输入
此插件是服务输入。普通插件收集由 interval 设置确定的指标。服务插件启动一个服务来监听并等待指标或事件发生。服务插件与普通插件的两个主要区别是：
- 全局或插件特定的
interval设置可能不适用 --test、--test-wait和--once的 CLI 选项可能不会为此插件生成输出
全局配置选项
插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。
配置
# Listener capable of handling KNX bus messages provided through a KNX-IP Interface.
[[inputs.knx_listener]]
## Type of KNX-IP interface.
## Can be either "tunnel_udp", "tunnel_tcp", "tunnel" (alias for tunnel_udp) or "router".
# service_type = "tunnel"
## Address of the KNX-IP interface.
service_address = "localhost:3671"
## Measurement definition(s)
# [[inputs.knx_listener.measurement]]
# ## Name of the measurement
# name = "temperature"
# ## Datapoint-Type (DPT) of the KNX messages
# dpt = "9.001"
# ## Use the string representation instead of the numerical value for the
# ## datapoint-type and the addresses below
# # as_string = false
# ## List of Group-Addresses (GAs) assigned to the measurement
# addresses = ["5/5/1"]
# [[inputs.knx_listener.measurement]]
# name = "illumination"
# dpt = "9.004"
# addresses = ["5/5/3"]相关工具
- knx-telegraf-config-generator: 从 KNX 项目文件生成 Telegraf 配置
测量配置
每个测量只包含一个数据点类型 (DPT) 并为该测量分配一组地址。例如，您可以将所有温度传感器消息分组到“temperature”测量中。但是，您可以自由地将一种数据点类型的消息拆分到多个测量中。
您不应将组地址 (GA) 分配给多个测量！
Metrics
接收到的 KNX 数据以“value”字段的形式存储在上面配置的命名测量中。除了值之外，还有以下标签添加到数据点：
groupaddress: 对应值的 KNX 组地址unit: 值的单位source: 发送该值的 KNX 物理地址
要了解数据点的具体数据类型，请查阅您的 KNX 项目、KNX 规范或“knx-go”项目以查找相应 DPT。
示例输出
本节以 Line Protocol 格式展示示例输出。
illumination,groupaddress=5/5/4,host=Hugin,source=1.1.12,unit=lux value=17.889999389648438 1582132674999013274
temperature,groupaddress=5/5/1,host=Hugin,source=1.1.8,unit=°C value=17.799999237060547 1582132663427587361
windowopen,groupaddress=1/0/1,host=Hugin,source=1.1.3 value=true 1582132630425581320此页面是否有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持，请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。