Difference between revisions of "Viewing Thing Data"

From Datonis
Jump to: navigation, search
(Created page with " Datonis Documentation Home > '''Viewing Thing Data''' This tutorial assumes that you have set up your Thing and started pushing data to Datoni...")
 
m
 
(11 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
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.
 
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 ==
+
== Viewing Metric timeseries data ==
Here is a short video that walks you through the process of viewing metrics and alerts for a Thing.
+
Here is a short video that walks you through the process of viewing metrics for a Thing.
{{#ev:youtube|https://youtu.be/-D2wrjnFTpE}}
+
{{#ev:youtube|https://youtu.be/hxyyytgA3V0}}
  
While viewing metrics, there are two views that need to be understood.
+
=== Data Views ===
 +
While viewing metrics, there are three views that need to be understood.
  
=== Viewing Aggregated Data ===
+
====== Default metric view ======
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 default metric view shows all metrics (maximum of a 5 at a time) plotted on separate line charts one below the other. You can see the trend of values over a period of time as well as counts for each metric.
  
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)
+
====== Correlated metric view ======
 +
If you wish to look at multiple metrics on the same line chart to understand their behavior with respect to each other, you can switch to the correlated metric view. The graph on this view uses a logarithmic scale to account for the differences in magnitudes of the selected metrics.
  
=== Viewing Raw Data ===
+
====== Tabular view ======
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.
+
This view offers a simple and easy to use paginated table for allowing you to have a closer look at data.
 +
 
 +
=== Selecting time ranges ===
 +
These trends show data for last 1 hour which is automatically refreshed every 5 minutes by default. You can adjust both - the refresh interval as well as the window of time (time range) for visualizing the data. If you select a broader time range, the views will show aggregated data.
 +
 
 +
Aggregations are automatic rollups of the metric data. For instance, let us assume that you are 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.
 +
 
 +
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)
 +
 
 +
=== Downloading as data CSV ===
 +
You can also download data in a CSV format for offline analysis. If the data is rolled up, you will have min, max, sum, count and avg values for each metric for each rollup window.
 +
 
 +
== Viewing Thing alert data ==
 +
Alerts are special events that can be reported by Edge devices to the platform. These are usually messages regarding:
 +
* Certain abnormal activity/alarm that is detected by the edge device on the thing (asset) that it is connected to. For example, it could be a "door left open" alarm generated for a critical asset.
 +
* Abnormal condition with respect to the edge device itself. For example, it could be a an alert regarding a critically low battery status on a the device that is monitoring an Oil well - which is sent before it stops transmitting.
 +
Here is a short video that walks you through the activity of viewing alert messages for a connected Thing or Asset.
 +
{{#ev:youtube|https://youtu.be/8gbnEZQ3C1A}}
 +
 
 +
== Viewing Thing waypoints ==
 +
Waypoints are location datapoints (pairs of latitude and longitude coordinates) that are sent periodically to Datonis. These are useful for tracking movements of moving assets like trucks, school buses etc. Please refer the [[Build_Your_Connected_Thing_with_Datonis_Agent_SDK|Datonis SDK documentation]] for more information on how to send waypoints for moving assets.
 +
 
 +
Here is a short video that describes how to view waypoints for such a moving asset:
 +
 
 +
{{#ev:youtube|https://youtu.be/2VuO_y0uks4}}
  
 
== Mashups ==
 
== Mashups ==
 
Mashups allow you to build custom visualisations of your metric data. Here is a short video that walks you through creating a mashup.
 
Mashups allow you to build custom visualisations of your metric data. Here is a short video that walks you through creating a mashup.
{{#ev:youtube|https://youtu.be/fs1P3Mz20Xs}}
+
{{#ev:youtube|https://youtu.be/EZIG29G1tGs}}
  
 
Here are some things to be considered while creating mashups.
 
Here are some things to be considered while creating mashups.
Line 28: Line 54:
 
* 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.
 
* 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.
 
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.
 

Latest revision as of 06:50, 27 July 2017

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 Metric timeseries data

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

Data Views

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

Default metric view

The default metric view shows all metrics (maximum of a 5 at a time) plotted on separate line charts one below the other. You can see the trend of values over a period of time as well as counts for each metric.

Correlated metric view

If you wish to look at multiple metrics on the same line chart to understand their behavior with respect to each other, you can switch to the correlated metric view. The graph on this view uses a logarithmic scale to account for the differences in magnitudes of the selected metrics.

Tabular view

This view offers a simple and easy to use paginated table for allowing you to have a closer look at data.

Selecting time ranges

These trends show data for last 1 hour which is automatically refreshed every 5 minutes by default. You can adjust both - the refresh interval as well as the window of time (time range) for visualizing the data. If you select a broader time range, the views will show aggregated data.

Aggregations are automatic rollups of the metric data. For instance, let us assume that you are 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.

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)

Downloading as data CSV

You can also download data in a CSV format for offline analysis. If the data is rolled up, you will have min, max, sum, count and avg values for each metric for each rollup window.

Viewing Thing alert data

Alerts are special events that can be reported by Edge devices to the platform. These are usually messages regarding:

  • Certain abnormal activity/alarm that is detected by the edge device on the thing (asset) that it is connected to. For example, it could be a "door left open" alarm generated for a critical asset.
  • Abnormal condition with respect to the edge device itself. For example, it could be a an alert regarding a critically low battery status on a the device that is monitoring an Oil well - which is sent before it stops transmitting.

Here is a short video that walks you through the activity of viewing alert messages for a connected Thing or Asset.

Viewing Thing waypoints

Waypoints are location datapoints (pairs of latitude and longitude coordinates) that are sent periodically to Datonis. These are useful for tracking movements of moving assets like trucks, school buses etc. Please refer the Datonis SDK documentation for more information on how to send waypoints for moving assets.

Here is a short video that describes how to view waypoints for such a moving asset:

Mashups

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.