Skip to content
Stand with Ukraine flag

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.

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:

GroupDescription
AnomalyAnomaly Score or Anomaly Score Index detected by Trendz Anomaly Models and saved to ThingsBoard.
AttributeAttributes from ThingsBoard.
CalculationCalculations saved by Trendz Calculation Fields to ThingsBoard.
Generated MetricsMetrics created directly in the Metric Explorer.
PredictionPredictions generated by Trendz Prediction Models and saved to ThingsBoard.
TelemetryRaw 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:

TabDescription
OverviewLine chart or table view of telemetry values.
StatisticsBasic statistical summary for the selected timerange.
Time PatternsBehavioral patterns across time units.
Range AnalysisDistribution 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:

MetricDescription
First Data PointEarliest available record.
Latest Data PointMost recent record.
Avg StepAverage time gap between consecutive data points.
Minimum / Maximum / AverageBasic numeric summaries.
VolatilityFrequency of telemetry value changes.
Value DistributionHistogram showing the spread of values.
Data AvailabilityHistogram showing the temporal distribution of data points.

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

ChartDescription
Hour of Day DistributionAggregation by hour of day.
Day of Week DistributionAggregation by day of week.
Weekly HeatmapAggregation by hour and weekday.
Calendar HeatmapAggregation 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:

ViewDescription
Summary CardsTotal duration or percentage spent in each range.
ChartsDuration or percentage grouped by time.
Range SummaryMost frequent range and the analysis period.

Chart customization options:

OptionChoices
Value AggregationDuration or duration percentage.
Time AggregationSelect the time unit.
Chart TypeLine 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.