Datonis:Viewing Thing Data

From Datonis
Jump to: navigation, search
Datonis Documentation Home > Viewing Thing Data

This tutorial assumes that you have set up your Thing and started pushing data to Datonis. The article Building your connected Thing with the Datonis Agent SDK covers this in detail.

It also assumes that you know about Things. Things can transmit Metrics, Waypoints and Alerts to Datonis. This section covers the default visualisations that Datonis provides for viewing this data.

Viewing Metrics and Alerts

Here is a short video that walks you through the process of viewing metrics and alerts for a Thing.

While viewing metrics, there are two views that need to be understood.

Viewing Aggregated Data

Aggregations are automatic rollups of the metric data. For instance, you am sending temperature readings every 10 seconds to Datonis. Datonis will automatically roll up this metric at a minute, hour, day boundaries.  So if there are 6 temperature readings sent to Datonis in a minute, Datonis will automatically create a 'minute' level aggregation of that metric.  Min, max and average values are automatically computed. This ensures that querying metric data is extremely fast.

The Aggregated View tab under the Metric data view shows only aggregated data at the lowest granularity of a minute. If you perform queries across larger time ranges, you will notice that the view automatically aggregates the data at hourly, daily levels. Hovering your mouse over a metric value will also show you the avg, min and max values observed for that interval (or aggregation level)

Viewing Raw Data

If you wish to view specific metric values, you can view this in the raw data view. Please note that the date range for querying raw data is always restricted to a single day. Aggregated data can be queried across bigger date ranges.


Mashups allow you to build custom visualisations of your metric data. Here is a short video that walks you through creating a mashup.

Here are some things to be considered while creating mashups.

  • A single mashup can hold upto 10 widgets. 
  • Adding widgets consists of selecting widget types, selecting Things and their metrics. Each widget imposes a restriction on the number of metrics it can display. For instance, the Latest Value widget can only display a single metric. A line chart can display upto 5 metrics.
  • The configure metrics section in the Add Widget wizard will have widget specific configuration options. For instance, while adding an Angular Gauge widget, you can set lower,intermediate and higher limit values.

Mashups currently support a number of chart types including line, area, bar and pie, donut, radar, angular gauges and a table view.

Viewing Waypoints

The waypoints view allow you to view the waypoints being sent by your Thing. To access the waypoints view, you would need to go to the Things view from the Manage menu.

  • Click on a Thing to drill down.
  • In the Thing detail view, you will see a tab called Waypoints. Click that.
  • In the waypoints view, you can select the number of waypoints and a date range and you can plot the waypoints on a map.