search

mxinden / modbus_exporter

Exporter which retrieves stats from a modbus system and exports them via HTTP for Prometheus consumption.
GNU General Public License v3.0
1 stars 0 forks source link

readme

Development on this fork has been discontinued. You can check out https://github.com/richih/modbus_exporter instead.

Modbus exporter

Prometheus exporter which retrieves stats from a modbus tcp system and exports them via HTTP for Prometheus consumption.

Scrape sequence

Reproduce diagram Go to: https://bramp.github.io/js-sequence-diagrams/ ``` Note right of Prometheus: promehteus.yml \n --- \n target: Modbus-TCP-10.0.0.5 \n subtarget: Modbus-Unit-10 \n module: VendorXY Prometheus->Exporter: http://xxx.de/metrics?target=10.0.0.5&subtarget=10&module=vendorxy Note right of Exporter: modbus.yml \n --- \n module: VendorXY \n - temperature_a: 40001 \n - temperature_b: 40002 Exporter->Modbus_TCP_10.0.0.5: tcp://10.0.0.5?unit=10®ister=40001 Modbus_TCP_10.0.0.5->Modbus_RTU_10: rtu://_?register=40001 Modbus_RTU_10-->Modbus_TCP_10.0.0.5: value=20 Modbus_TCP_10.0.0.5-->Exporter: value=20 Exporter->Modbus_TCP_10.0.0.5: tcp://10.0.0.5?unit=10®ister=40002 Modbus_TCP_10.0.0.5->Modbus_RTU_10: rtu://_?register=40002 Modbus_RTU_10-->Modbus_TCP_10.0.0.5: value=19 Modbus_TCP_10.0.0.5-->Exporter: value=19 Exporter-->Prometheus:temperature_a{module="VendorXY",sub_target="10"} 20 \ntemperature_b{module="VendorXY",sub_target="10"} 19 ```

Building

make build

Getting Started

The modbus exporter needs to be passed the target and module as parameters by Prometheus, this can be done with relabelling (see prometheus.yml).

Once Prometheus is properly configured, run the exporter via:

./modbus_exporter [flags]

Supported flags:

Usage of ./modbus_exporter:
  -config.file string
        Sets the configuration file. (default "modbus.yml")
  -modbus-listen-address string
        The address to listen on for HTTP requests exposing modbus metrics. (default ":9602")
  -telemetry-listen-address string
        The address to listen on for HTTP requests exposing telemetry metrics about the exporter itself. (default ":9011")

Configuration File

Check out modbus.yml for more details on the configuration file format.

TODO

Support for serial modbus was dropped in git commit d06573828793094fd2bdf3e7c5d072e7a4fd381b.