InfluxDB is essentially a time series database process that runs on a server, while Grafana is a visualization tool for time series data. Grafana is a very lightweight server-side application, and most of the data monitoring runs in a browser. For details on version information for these two components, please refer to the .

Grafana and InfluxDB can be deployed using images for Docker on linux. These images are provided by Enea along with a deploy script and predefined dashboards. The Grafana and InfluxDB images can be deployed on the same machine or on separate machines.

The following must be present in order to deploy an image: CentOS 7 Linux. Internet connection for installing the Docker tool. Root rights on the CentOS 7 machine.

In order to use the Grafana and InfluxDB containers, the Docker tool that runs and manages containers needs to be available on the server. To install Docker on a CentOS 7 server open a terminal, log into a bash shell with the root account and run the following commands: yum check-update yum install -y yum-utils device-mapper-persistent-data lvm2 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo yum install docker In order to deploy the Grafana and InfluxDB images, the Docker service needs to be started. To start the Docker service, log into a bash shell with the root account and run the following command: systemctl start docker. By default, the Docker service is not configured to start at boot. In order to configure it to autostart, log into a bash shell with the root account and run the following command: systemctl enable docker. The Grafana and InfluxDB images are configured to autostart when the Docker service starts.

On the CentOS 7 server open a terminal, log into a bash shell with the root account and perform the following: Extract Enea_Edge_Telemetry_Deploy_<version>-build<build_number>.tar.gz. The directory in which the archive will be unpacked will be denoted as: <Telemetry-installerdir>. Enter <Telemetry-installerdir>. Run the provided telemetry_deploy.sh script. When prompted, select what images you want to deploy. Select Both unless you wish for the Grafana and InfluxDB images to be on separate servers. If an image is already deployed, you will be prompted to replace it. By default, Grafana is configured for deployment on the same server as InfluxDB. Please read the Grafana documentation on how to configure it if you wish to deploy the images on separate servers. During the InfluxDB deployment, you will be prompted to provide a username and password. These must match the ones configured in the Enea Edge Management application for Telemetry. Changing the InfluxDB username and password requires redeploying the InfluxDB image. Verify the installation by running the command docker ps -a. The Grafana and InfluxDB containers should be present and have the status Up. The provided Grafana instance by default uses the Username: admin and Password: admin.

If a firewall is running on the machines where Grafana and InfluxDB are deployed, this firewall needs to be configured so the required ports are enabled. To enable the ports, log into a bash shell with the root account and perform the following: For InfluxDB, run the following command: firewall-cmd --permanent --add-port=25826/udp For Grafana, run the following command: firewall-cmd --permanent --add-port=3000/tcp

Customizing InfluxDB and Grafana parameters can be done in the Enea Edge Management GUI by selecting the System menu, then Configuration, accessing the Properties tab, and clicking on the Telemetry tab. The settings that can be changed are listed in the table below: Field name Description Default value Grafana Hostname or IP Address The public hostname or IP address where the Grafana instance is installed. no default Grafana Port The port Grafana uses. 3000 Grafana Dashboard The dashboard that should be used when opening Grafana using the Enea Edge Management application. host InfluxDB Hostname or IP Address The public hostname or IP address where the InfluxDB database is installed. no default InfluxDB Port The port used for communication between InfluxDB and the Telemetry server. 25826 InfluxDB Username The username used for encrypting communication between InfluxDB and the Telemetry server. admin0 InfluxDB Password The password used for encrypting communication between InfluxDB and the Telemetry server. admin When changing any of the settings in the Telemetry tab, the Enea Edge Management application will inform all uCPE devices of the change if they have telemetry running.

When a uCPE Device is selected, in the Operations menu, the Start Telemetry and Stop Telemetry options are available. When starting Telemetry for a uCPE device, the Enea Edge Management application sends the following information about the InfluxDB: The IP address and hostname where InfluxDB is installed. The port used for communication between InfluxDB and the Telemetry server. The credentials used for encrypting communication between InfluxDB and the Telemetry server. These fields are read-only and are populated with the values already set in the System Configuration. If one of the fields is not set or if it does not have the desired value, modify it in the System Configuration. The password is sent encrypted using the Base64 scheme.

When the Telemetry status is changed on a uCPE device, a notification is sent to the Enea Edge Management application. These notifications can be inspected under Fault found in the Event menu.

When a uCPE Device is selected, the Telemetry button is available. Pressing this button will open a new window pointing to Grafana. The current uCPE device will be selected in Grafana. The hostname or IP Address and the port of the Grafana installation can be customized by selecting System, then the Configuration menu, accessing the Properties tab, and clicking on the Telemetry tab. The default dashboard available when launching Grafana can be customized as well.