Receiver for Mira monitoring data¶
You can configure Mira nodes to send monitoring data.
Together with the Mira Gateway, the monitoring receiver program will then receive the data and store it in databases.
Prerequisites¶
InfluxDB 2 is required. InfluxDB can be found here.
Mira Gateway running with the monitor db enabled.
The nodes in the Mira network also have to enable the monitoring sender with at least one field enabled. (see mira_diag_enable_monitoring_sender). This feature is available in Mira 2.10.0 and later.
Configuration file¶
The configuration file is using the toml format.
Configure the following fields:
tundev_address = "<address>" # IPv6 Address assigned to the tundev interface
gw_monitor_db = "<path>" # Path including name of the gateway monitor database
[influx_config] # Configuration needed to connect to the Influx database
url = "<url>" # URL to the database, usually "http://localhost:8086"
bucket_name = "<bucket>" # Name of the bucket/database created in Influx
auth_token = "<token>" # Authentication token for the Influx server
The same configuration file works with the Mira Gateway API service. By using the same file to both services, there is less risk of having incorrect configuration.
How to run¶
Start InfluxDB and create a bucket/database.
Run the monitoring_receiver executable:
The application now start to listen for monitoring messages coming from nodes in the Mira network.