Stand with Ukraine flag
Pricing Try it now
Trendz Analytics
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker
Documentation > Metric exploration > Overview
Getting Started
Guides Installation
On this page

Metric Exploration Overview

The Trendz Metric Explorer is a feature that allows users to validate which telemetries have data, review statistics, analyze time patterns, and explore general telemetry behavior. It also enables the generation of new metrics from existing ones using AI Assistance or AI Suggestions. All generated metrics can be fully integrated into the Trendz ecosystem and used within ThingsBoard.

You can access the Metric Explorer by clicking the image icon.

The interface consists of three main sections:

  1. Header - Entity, Item, and Timerange selection.
  2. Fields Section - Telemetries and attributes grouped by category.
  3. Tabs Section - Data analysis and visualization tools.
<b>Header</b> - Entity, Item, and Timerange selection.
Header - Entity, Item, and Timerange selection.
<b>Fields Section</b> - Telemetries and attributes grouped by category.
Fields Section - Telemetries and attributes grouped by category.
<b>Tabs Section</b> - Data analysis and visualization tools.
Tabs Section - Data analysis and visualization tools.

To begin, select an Entity (Device or Asset profile), an Item (Device or Asset) you want to explore and specify the timerange for the analysis - you can change these settings at any time during exploring.

After selecting the entity, item, and timerange, choose a metric (telemetry or attribute) for analysis. Interaction with metrics is described in the next section.

Select an <b>Entity</b> (Device or Asset profile).
Select an Entity (Device or Asset profile).
Select an <b>Item</b> (Device or Asset) you want to explore.
Select an Item (Device or Asset) you want to explore.
Specify the <b>timerange</b> for the analysis.
Specify the timerange for the analysis.
Choose a metric (telemetry or attribute) for analysis.
Choose a metric (telemetry or attribute) for analysis.

Fields Section

This section displays all telemetries and attributes available in both ThingsBoard and Trendz.

Telemetries and attributes are divided into up to six groups:

  1. Anomaly - Anomalies (Anomaly Score or Anomaly Score Index) detected by Trendz Anomaly Models and saved to ThingsBoard.
  2. Attribute - Attributes from ThingsBoard.
  3. Calculation - Calculations saved by Trendz Calculation Fields to ThingsBoard.
  4. Generated Metrics - Metrics created by the Metric Explorer.
  5. Prediction - Predictions generated by Trendz Prediction Models and saved to ThingsBoard.
  6. Telemetry - Raw telemetries from ThingsBoard.
<b>Anomaly</b> - Anomalies (Anomaly Score or Anomaly Score Index) detected by Trendz Anomaly Models and saved to ThingsBoard.
Anomaly - Anomalies (Anomaly Score or Anomaly Score Index) detected by Trendz Anomaly Models and saved to ThingsBoard.
<b>Attribute</b> - Attributes from ThingsBoard.
Attribute - Attributes from ThingsBoard.
<b>Calculation</b> - Calculations saved by Trendz Calculation Fields to ThingsBoard.
Calculation - Calculations saved by Trendz Calculation Fields to ThingsBoard.
<b>Generated Metrics</b> - Metrics created by the Metric Explorer.
Generated Metrics - Metrics created by the Metric Explorer.
<b>Prediction</b> - Predictions generated by Trendz Prediction Models and saved to ThingsBoard.
Prediction - Predictions generated by Trendz Prediction Models and saved to ThingsBoard.
<b>Telemetry</b> - Raw telemetries from ThingsBoard.
Telemetry - Raw telemetries from ThingsBoard.

Note: Groups are only shown if the item contains telemetries in that category.

Each group lists all available telemetries. If a telemetry you are interested in is missing, click the Show Inactive Telemetries button to display telemetries that exist for the item but have no data in the selected timerange. If it still does not appear, perform a topology discovery to sync the latest ThingsBoard structure with Trendz.

If a telemetry you are interested in is missing, click the <b>Show Inactive Telemetries</b> button to display telemetries that exist for the item but have no data in the selected timerange.
If a telemetry you are interested in is missing, click the Show Inactive Telemetries button to display telemetries that exist for the item but have no data in the selected timerange.
If a telemetry you are interested in is missing, click the <b>Show Inactive Telemetries</b> button to display telemetries that exist for the item but have no data in the selected timerange.
If a telemetry you are interested in is missing, click the Show Inactive Telemetries button to display telemetries that exist for the item but have no data in the selected timerange.
If it still does not appear, perform a <b>refresh topology</b> to sync the latest ThingsBoard structure with Trendz.
If it still does not appear, perform a refresh topology to sync the latest ThingsBoard structure with Trendz.

You can also use the + New Metric button to create new metrics from existing ones. This functionality is described here.

You can also use the <b>+ New Metric</b> button to create new metrics from existing ones.
You can also use the + New Metric button to create new metrics from existing ones.

Attributes

Lists all attributes of the selected item with their corresponding Trendz business entity fields. Clicking an attribute displays its value.

Clicking an attribute displays its value.
Clicking an attribute displays its value.

Telemetries

Displays all telemetries of the selected item that have at least one data point within the timerange.

Each telemetry offers four tabs:

  1. Overview - Line chart or table view of telemetry values.
  2. Statistics - Basic statistical summary for the selected timerange.
  3. Time Patterns - Behavioral patterns across time units.
  4. Range Analysis - Distribution of telemetry values over time and range intervals.

Interaction with tabs is described in details in the Tabs Section.

<b>Overview</b> - Line chart or table view of telemetry values.
Overview - Line chart or table view of telemetry values.
<b>Statistics</b> - Basic statistical summary for the selected timerange.
Statistics - Basic statistical summary for the selected timerange.
<b>Time Patterns</b> - Behavioral patterns across time units.
Time Patterns - Behavioral patterns across time units.
<b>Range Analysis</b> - Distribution of telemetry values over time and range intervals.
Range Analysis - Distribution of telemetry values over time and range intervals.

Calculations, Predictions, and Anomalies

Telemetries generated by Trendz entities (Calculation Fields, Prediction Models, or Anomaly Models). These have the same tab structure as regular telemetries, with an additional Go to Entity button for quick navigation to the related Trendz entity.

<b>Go to Entity</b> button for quick navigation to the related Trendz entity.
Go to Entity button for quick navigation to the related Trendz entity.
<b>Go to Entity</b> button for quick navigation to the related Trendz entity.
Go to Entity button for quick navigation to the related Trendz entity.

If the field you are interested in does not appear in an appropriate folder, ensure the entity is saving telemetry to ThingsBoard. Refer to the respective guides to set up jobs to save telemetry to ThingsBoard:

Generated Metrics

Displays metrics generated directly within the Metric Explorer. Read more about generated metrics here.

Displays metrics generated directly within the Metric Explorer.
Displays metrics generated directly within the Metric Explorer.

Tabs Section

When a telemetry is selected, the Tabs Section displays analytical views useful for exploration.

You can zoom any chart in any tab, using Ctrl + Mouse Scroll.

You can enable or disable autoscale for any chart in any tab. When autoscale is disabled, the chart’s Y-axis range starts at 0 and ends at the maximum value. When autoscale is enabled, the Y-axis range starts at the minimum value and ends at the maximum value.

When autoscale is disabled, the chart’s Y-axis range starts at 0 and ends at the maximum value.
When autoscale is disabled, the chart’s Y-axis range starts at 0 and ends at the maximum value.
When autoscale is enabled, the Y-axis range starts at the minimum value and ends at the maximum value.
When autoscale is enabled, the Y-axis range starts at the minimum value and ends at the maximum value.

Overview Tab

Shows the historical trend of the telemetry within the selected timerange.

  • Switch between Table and Line Chart views.
Switch between <b>Table</b> and <b>Line Chart</b> views.
Switch between Table and Line Chart views.
Switch between <b>Table</b> and <b>Line Chart</b> views.
Switch between Table and Line Chart views.
  • Configure grouping units and aggregation methods.
Configure grouping units
Configure grouping units
Configure aggregation methods
Configure aggregation methods

Statistics Tab

Displays fundamental statistics for the telemetry within the selected timerange:

  • First Data Point - Earliest available record.
  • Latest Data Point - Most recent record.
  • Avg Step - Average time gap between points.
  • Minimum, Maximum, Average - Basic numeric summaries.
  • Volatility - Frequency of telemetry changes.
  • Value Distribution - Histogram showing value spread.
  • Data Availability - Histogram showing temporal distribution of points.
Displays fundamental statistics for the telemetry within the selected timerange.
Displays fundamental statistics for the telemetry within the selected timerange.

Time Patterns Tab

Analyzes telemetry behavior across time-based aggregations. Independent timeranges and aggregations can be set per chart.

Charts include:

  1. Hour of Day Distribution - Aggregation by hour of day.
  2. Day of Week Distribution - Aggregation by day of week.
  3. Weekly Heatmap - Aggregation by hour and weekday.
  4. Calendar Heatmap - Aggregation by calendar days.
<b>Hour of Day Distribution</b> - Aggregation by hour of day.
Hour of Day Distribution - Aggregation by hour of day.
<b>Day of Week Distribution</b> - Aggregation by day of week.
Day of Week Distribution - Aggregation by day of week.
<b>Weekly Heatmap</b> - Aggregation by hour and weekday.
Weekly Heatmap - Aggregation by hour and weekday.
<b>Calendar Heatmap</b> - Aggregation by calendar days.
Calendar Heatmap - Aggregation by calendar days.

Range Analysis Tab

Explores telemetry state durations and distributions.

You can:

  1. Configure ranges with colors, names, and value limits.
  2. Add or remove ranges.
  3. Reset to default (three automatically calculated ranges).
Configure ranges with colors.
Configure ranges with colors.
Remove ranges.
Remove ranges.
Add ranges.
Add ranges.
Reset to default (three automatically calculated ranges).
Reset to default (three automatically calculated ranges).

After configuration, click Rebuild to view:

  • Summary Cards - Total duration or percentage.
  • Charts - Duration or percentage grouped by time.
  • Range Summary - Most frequent range and analysis period.
After configuration, click <b>Rebuild</b> to build views.
After configuration, click Rebuild to build views.
<b>Summary Cards</b> - Total duration or percentage.
Summary Cards - Total duration or percentage.
<b>Charts</b> - Duration or percentage grouped by time.
Charts - Duration or percentage grouped by time.
<b>Range Summary</b> - Most frequent range and analysis period.
Range Summary - Most frequent range and analysis period.

Chart customization options:

  • Value Aggregation - Duration or duration percent.
  • Time Aggregation - Select time unit.
  • Chart Type - Stacked Bar or Line Chart.
<b>Value Aggregation</b> - Duration or duration percent.
Value Aggregation - Duration or duration percent.
<b>Time Aggregation</b> - Select time unit.
Time Aggregation - Select time unit.
<b>Chart Type</b> - Line Chart.
Chart Type - Line Chart.
<b>Chart Type</b> - Stacked Bar.
Chart Type - Stacked Bar.

You can save the range configuration as a View using the Save View button, and later embed it into a ThingsBoard dashboard. Refer to the documentation on sharing views to ThingsBoard for details.

Next Steps