Skip to content

Data Visualization

Data stored in the Data Services can be visualized via Grafana, an open source web application which provides charts, graphs and alerts for data visualization. An instance of Grafana is available on each node to visualize data stored in databases on the node. This chapter describes only how Grafana is configured and how it can be accessed. Refer to the Grafana documentation for general information on how to use Grafana.

warning

  • An older version of Grafana is installed with the Nerve Data Services due to the AGPL license. If a newer version is needed, it needs to be provisioned separately in the workload repository.
  • To use Grafana, the user must be logged in to the Local UI. When logged out, Grafana is no longer able to perform its internal operations and reports random errors. To continue working with Grafana, close the browser tab, log in again and re-open Grafana.

Data Visualization on the node

On the node, a single data source exists in Grafana, formatted as <serialnumber>. Use this data source in all panels to visualize data received by the Data Services.

  1. Access the Local UI on the node. This is Nerve Device specific. Refer to the table below for device specific links to the Local UI. The initial login credentials to the Local UI can be found in the customer profile.

    Nerve Device Physical port Local UI
    MFN 100 P1 http://172.20.2.1:3333
    Kontron KBox A-150-APL LAN 1 <wanip>:3333

    To figure out the IP address of the WAN interface, refer to Finding out the IP address of the device in the Kontron KBox A-150-APL chapter of the device guide.
    Kontron KBox A-250 ETH 2 <wanip>:3333

    To figure out the IP address of the WAN interface, refer to Finding out the IP address of the device in the Kontron KBox A-250 chapter of the device guide.
    Maxtang AXWL10 LAN1 <wanip>:3333

    To figure out the IP address of the WAN interface, refer to Finding out the IP address of the device in the Maxtang AXWL10 chapter of the device guide.
    Siemens SIMATIC IPC127E X1 P1 http://172.20.2.1:3333
    Siemens SIMATIC IPC427E X1 P1 http://172.20.2.1:3333
    Supermicro SuperServer E100-9AP-IA LAN1 <wanip>:3333

    To figure out the IP address of the WAN interface, refer to Finding out the IP address of the device in the Supermicro SuperServer E100-9AP-IA chapter of the device guide.
    Toshiba FA2100T-700 First rear port http://172.20.2.1:3333
    Vecow SPC-5600-i5-8500 LAN 1 http://172.20.2.1:3333
    Winmate EACIL20 LAN1 <wanip>:3333

    To figure out the IP address of the WAN interface, refer to Finding out the IP address of the device in the Winmate EACIL20 chapter of the device guide.
  2. Select Workload management in the navigation on the left.

    Select workload management

  3. Select the Nerve Data Services Docker Compose workload.

  4. Select the Grafana web UI link.

    Select the Grafana web UI link

  5. A new browser tab opens to show the home screen of Grafana. Login with the following credentials:

    • Username: admin
    • Password: admin

    Note

    It is recommended to change the login credentials after the initial login.

From here dashboards can be created as described below.

Creating a dashboard

The instructions below cover the general workflow of creating a dashboard.

  1. Access the visualization element on the node.
  2. Select + > Dashboard in the navigation on the left. A box will appear.

    Create dashboard

  3. Select Add Query in the New Panel box.

    Add query

  4. Select the data source from the drop-down menu. The name of the data source is the serial number of the node.

    Select data source

  5. Fill in the query information below that appears below. This information depends on the use case and the Gateway configuration.

    Query information

    Note

    Customize general settings and visualization settings by selecting General and Data in the navigation on the left. Refer to the Grafana documentation for more information.

    Optional settings

  6. Select the save icon in the upper-right corner to save the dashboard.

    Save dashboard

Access the dashboard from the home menu.

Home menu access

For specific examples on how to use Grafana with Nerve Data Services, refer to the Examples section.