Skip to content

Cookie preferences

We use cookies for our own analytics and to see how our campaigns perform. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details.

Security, load balancing and remembering your cookie choice.

Show us which pages people read and how they find the site, so we can improve it (Google Analytics).

Show us which of our ad campaigns bring visitors to the site (Google Ads).

© 2026 The ThingsBoard Authors
Try for free

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Metric Explorer

The Trendz Metric Explorer lets you validate which telemetries have data, review statistics, analyze time patterns, and explore general telemetry behavior for any device or asset. It also enables generating new metrics from existing ones using AI Assistance or AI Suggestions.

Video: https://www.youtube.com/watch?v=r2pqMzdXEHE

You can access the Metric Explorer by clicking the chart icon ( ) in the Trendz navigation.

The interface has three main sections:

┌──────────────────────────────────────────────────────┐
│ HEADER — Entity / Item / Timerange │
├─────────────────────────┬────────────────────────────┤
│ FIELDS SECTION │ TABS SECTION │
│ │ │
│ • Anomaly │ ┌─ Overview │
│ • Attribute │ ├─ Statistics │
│ • Calculation │ ├─ Time Patterns │
│ • Generated Metrics │ └─ Range Analysis │
│ • Prediction │ │
│ • Telemetry │ │
└─────────────────────────┴────────────────────────────┘

To begin, select an Entity (Device or Asset profile), an Item (Device or Asset) to explore, and specify the timerange for the analysis. These settings can be changed at any time.

After selecting the entity, item, and timerange, choose a metric (telemetry or attribute) for analysis.

The Fields Section shows all telemetries and attributes available in both ThingsBoard and Trendz, divided into up to six groups:

Group Description
Anomaly Anomaly Score or Anomaly Score Index detected by Trendz Anomaly Models and saved to ThingsBoard.
Attribute Attributes from ThingsBoard.
Calculation Calculations saved by Trendz Calculation Fields to ThingsBoard.
Generated Metrics Metrics created directly in the Metric Explorer.
Prediction Predictions generated by Trendz Prediction Models and saved to ThingsBoard.
Telemetry Raw telemetries from ThingsBoard.

If a telemetry you are looking for is missing, click Show Inactive Telemetries 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.

You can also use the + New Metric button to create new metrics from existing ones. See Generate New Metric for details.

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

Shows all telemetries of the selected item that have at least one data point in the selected timerange.

Each telemetry entry offers four analysis tabs:

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

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

If a field does not appear in the expected group, ensure the Trendz entity is configured to save telemetry to ThingsBoard. Refer to the respective guides:

Displays metrics generated directly within the Metric Explorer. See Generate New Metric for details.

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

Chart controls available in all tabs:

  • Zoom — hold Ctrl and scroll with the mouse wheel to zoom any chart.
  • Autoscale — when disabled, the Y-axis starts at 0 and ends at the maximum value; when enabled, the Y-axis fits the actual data range (min to max).

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

  • Switch between Table and Line Chart views.
  • Configure the grouping unit and aggregation method.

Displays fundamental statistics for the selected telemetry within the timerange:

Metric Description
First Data Point Earliest available record.
Latest Data Point Most recent record.
Avg Step Average time gap between consecutive data points.
Minimum / Maximum / Average Basic numeric summaries.
Volatility Frequency of telemetry value changes.
Value Distribution Histogram showing the spread of values.
Data Availability Histogram showing the temporal distribution of data points.

Analyzes telemetry behavior across time-based aggregations. Each chart can have an independent timerange and aggregation setting.

Chart Description
Hour of Day Distribution Aggregation by hour of day.
Day of Week Distribution Aggregation by day of week.
Weekly Heatmap Aggregation by hour and weekday.
Calendar Heatmap Aggregation by calendar days.

Explores how long telemetry values stay within defined ranges. You define the ranges, and Trendz calculates duration and distribution statistics.

Setting up ranges:

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

After configuration, click Rebuild to generate the views:

View Description
Summary Cards Total duration or percentage spent in each range.
Charts Duration or percentage grouped by time.
Range Summary Most frequent range and the analysis period.

Chart customization options:

Option Choices
Value Aggregation Duration or duration percentage.
Time Aggregation Select the time unit.
Chart Type Line Chart or Stacked Bar.

You can save a range configuration as a View using the Save View button, then embed it into a ThingsBoard dashboard. See Add View on Dashboard for details.