Fork me on GitHub

pimatic-dashboard by Bert (bertreb) | github | npm

pimatic-dashboard

Plugin for presenting Pimatic data via an Influx database and Grafana dashboard

This plugin pushes pimatic device attribute values to an influx database with a grafana dashboard. The plugin is based on the pimatic-influxdb plugin from treban.

This plugin is focussed on presenting pimatic data in one or more grafana dashboards. You create a dashboard device and give it a measument name. Add devices that you want to add to this measurement. You can add all the device attribute to be used in the measurement or you can select specific attributes. If no attribute is selected, ALL device attributes will be used.

Influxdb needs to be installed before the first device is added. For the dashboards Grafana needs to bee installed.

Influxdb installation

Influxdb is a time-series database and designed for realtime IoT applications. Several instructions for installing Influxdb on your machine can be found on the internet. The following Influxdb information is important for the connection and is used in the Pimatic dashboard plugin config.

     database: Database name used in influxdb. If absent, the database is automatically created (default: pimatic)
  username: Username for access influx api
  password: Password for access influx api
  ip: The IP address of the influxdb rest api
  port: port from the influxdb rest api (default: 8086)

Grafana installation

t.b.d.

Measurement Device

In the measurement device you can add Pimatic device attributes to be streamed to Influxdb. You can add a device with all the numeric attributes or select specific attributes per device. Per Measurement device an Influx measurement is created. The measurements name must be set in the device config. This way you can create a set of data combined into a measurement series of data. Influx will store this data and in Grafana you can create a dashboard with this data.

After the device is created and pimatic devices/attributes are added, the fields and data will be added automatically to the database after the first updates of attributes.

Device configuration

  measurement: The measurement name for grouping the variables
  active: If enabled the data of this measurement will be streamed (default: true)
  variables: Variables to be streamed to Influx database (name from plugin config)
    [ 
        deviceId: Pimatic deviceId of the to be used attributes
      attributes: Attributes to stream to database
          [
              attributeId: AttributeId of the to be used attributes
              tag: Extra tag for Grafana queries
          ]
    ]

Plugin Config Options

Dashboard plugin config options
OptionDescriptionDefault
database
string
Database name used in influxdb
"pimatic"
username
string
Username for access influx api
password
string
Password for access influx api
ip
string
IP address of the influxdb rest api
port
string
Port of the influxdb rest api
"8086"
debug
boolean
Enabled debug messages
false

Device Config Options

DashboardMeasurement

DashboardMeasurement

DashboardMeasurement config
OptionDescriptionDefault
measurement
string
The measurement name for grouping the variables
active
boolean
If enabled the data of this measurement will be streamed
true
variables
array of objects
Variables to stream to database
[]
Elements
pimatic-dashboard is written by Bert (bertreb)