Widgets

The Kaa Web Dashboard (WD) is pre-shipped with a collection of widgets that receive data from other Kaa services and display them in different visual layouts. The table below summarizes the current collection of Kaa widgets. It describes each widget’s purpose, type, and the Kaa services involved in the widget operation.

Widget name Purpose Services
EP List Create and view endpoints EPR
Software list Create and view software updates and their details OTAO, EPR
Software version details View and modify software updates and their details OTAO, EPR
EP Metadata View, add, edit and delete endpoint metadata EPR
EP Configuration View and edit endpoint configuration ECR
EP Location View location of one or more endpoints EPR, EPTS
Multi Series Chart View time series data in the graphical format EPTS
Time Series Table View time series data in the table format EPTS
Gauge View the last value in time series EPTS
Raw HTML Render custom HTML EPR
EP Label Display a custom image with labels that represent data EPR, EPTS
Control Execute remote commands via a switch EPTS, EPR, RCI
Filter List View endpoint filters and their details EPR
Filter details View and modify details of a specific filter EPR
EP Token Status Create, activate, suspend and revoke the endpoint token CM

EP list

The EP List widget is primarily used to display a list of the available devices for the user.

eplist-view

The second important feature of this widget is enabling the user to create new endpoints.

eplist-view

The widget also supports displaying filtered endpoints. eplist-view

You can also configure interoperation between this widget and the EP Location widget to control which endpoint locations are displayed on the map. eplist-view

This feature may be enabled by selecting the Should rows be selectable? option in the EP List widget settings

eplist-view

as well as the corresponding configuration option in the map widget. You can find more information in the EP Location widget section.

You can configure the widget to enable the direct link between entities in the table and their dashboards. To learn more, click here.

The EP List widget supports the following interfaces: EP List interfaces diagram

Filter list

The Filter List widget is used to display a list of the available filters for the user.
filterlist-view

It also enables the user to create new filters as well as delete them: filterlist-view

You can configure the widget to enable the direct link between entities in the table and their dashboards. To learn more, click here.

The Filter List widget supports the following interfaces: Filter List interfaces diagram

Software list

The Software List widget is used to display a list of the available software versions for the user.

softwarelist-view

It also enables the user to create new software versions.

You can configure the widget to enable the direct link between entities in the table and their dashboards. To learn more, click here.

The Software List widget supports the following interfaces:

Software List interfaces diagram

EP token status

The EP Token Status widget is used to manage the status of the [endpoint token][endpoint token]. The user can create, activate, suspend and revoke the endpoint token.

ep_token_status

The EP Token Status widget supports the following interfaces:

EP Token Status interfaces diagram

Configuration

The EP Configuration widget is used to view and edit configuration of the endpoint or the endpoint group.

configuration-sample

The widget enables the user to:

  1. Display a single integer value and change it.

configuration-sample

  1. Display several endpoint configuration parameters and change them.

configuration-sample

  1. Display configuration as JSON in the text editor area and modify it.

configuration-sample

The EP Configuration widget supports the following interfaces:

EP Configuration interfaces diagram

Control

The Control widget is used to execute commands on an endpoint.

control widget

The EP Configuration widget supports the following interfaces:

Control interfaces diagram

EP label

The EP Label widget is used to display endpoint dynamic data over a custom image.

example

The EP Label widget supports the following interfaces:

EP Label interfaces diagram

Filter details

The Filter Details widget is used to view and edit filter details.

filterDetails

It supports the following interfaces:

filterDetails interfaces diagram

Gauge

The Gauge widget is used to display the last time series data for an endpoint. This widget has different representations depending on its type. Here are some of the gauge layouts available in WD.

gauge-sample

It supports the following interfaces:

filterDetails interfaces diagram

Metadata

The widget is used to monitor the endpoint metadata information stored in the EPR service.

example

It supports the following interfaces:

metadata interfaces diagram

Multi series chart

The Multi Series Chart widget is used to display a chart that shows time series data for one or more endpoints.

icon

The Multi Series Chart widget supports the following interfaces:

 interfaces diagram

Raw HTML

The Raw HTML widget is used to embed custom HTML into the dashboards. This widget supports totally static HTML content

-screenshot-static-html

as well as dynamic endpoint data stored in the EPR service.

-screenshot-epr-response

There are two ways to embed an image into the HTML content: encoding it into Base64 or referencing it from the WD external static resources.

The Raw HTML widget supports the following interfaces:

Raw HTML interfaces diagram

Time series table

The Time Series Table widget is used to display endpoint time series data in real time.

Time Series Table example

The Time Series Table widget supports the following interfaces:

Raw HTML interfaces diagram

Software version details

The Software Version Details widget is used to view and edit software version details.

Software Version Details

The widget supports the following interfaces:

Software Version Details

EP location

A map widget is used to display the current location of one or multiple endpoints. It also allows tracking the endpoints movement over the specified period of time.

map-sample

It is also possible to reflect the endpoint status on the map.

map-sample

In our example configuration, the green marker indicates that the enpoint is active and the yellow one that the endpoint is stalled.

This widget may interoperate with the EP Location widget in terms of selection which locations to display on map. This can be enabled by selecting the Show only selected endpoints option in the EP Locationwidget settings.

map-sample

You can find more information here.

The EP Location widget supports the following interfaces:

EP Location interfaces diagram

You can configure the table widget to enable the direct link between entities in the table and their dashboards. In this case, you can click on an entity record in the table and get redirected to the entity dashboard.

The configuration flow:

  1. Create an entity dashboard, to which you would like to setup the redirects. It can be an endpoint, filter or software dashboard depending on the entity type of widget you are setuping (see EP List, Filter List and Software List widgets details).

  2. Select the target dashboard in widget settings:

eplist-view

Here’s an example with the endpoint list widget.

  1. Click on a row in the list.

eplist-view

  1. Immediately get redirected to the corresponding entity dashboard.

eplist-view