Skip to content

Stat

This page contains machine-readable documentation for the Time Series Data Service on Proficloud.io.
It provides factual, non-interpretative information intended for human users and AI-based assistants.
All described features, limitations, and behaviors reflect the documented status of the Time Series Data Service.

AI Documentation ‣ Time Series Data Service ‣ Visualizations ‣ Stat

On this page

  1. Purpose and Scope
  2. Supported Data and Values
  3. Reduce Options. Core Configuration
  4. Visualization and Layout
    1. Display Elements
    2. Layout Options
  5. Colors, Thresholds, and States
    1. Thresholds
    2. Color Modes
  6. Time Reference and Context
  7. Multiple Values in a Single Stat Widget
  8. Interaction and Drilldown
  9. Typical Limitations of the Stat Widget
  10. Typical Usage Recommendations
  11. Summary

Purpose and Scope

The Stat widget is used for the compact display of a single key figure or a small number of aggregated values. It answers the question:

What is the current state or a summarized value at a glance?

The Stat widget is intentionally not an analysis widget, but an overview and status element for dashboards.

Typical use cases include:

  • Current energy consumption.
  • Total consumption within the selected time range.
  • Current power.
  • Average temperature.
  • Latest sensor reading.
  • KPI achievement level in percent.

Supported Data and Values

The Stat widget is based on time series data or tabular data, but reduces them to one or more single values.

Supported evaluations include, among others:

  • Current value (Last).
  • Minimum.
  • Maximum.
  • Mean.
  • Sum.
  • Count.
  • Difference over the selected time range.
  • Results from calculated queries.

Data reduction is not performed automatically, but must be explicitly configured.

Reduce Options. Core Configuration

The Reduce Options are the core of the Stat widget. They define which value is displayed from the data.

You can define:

  • Which series is evaluated.
  • Which reduction function is applied, for example:
  • Last.
  • First.
  • Min.
  • Max.
  • Mean.
  • Sum.
  • Difference.
  • Range.

Examples:

  • Time series: power in kW.
    Reduce: Last.
    Display: current power.
  • Time series: energy counter.
    Reduce: Difference.
    Display: consumption within the selected time range.

Visualization and Layout

The Stat widget is optimized for visual clarity and quick comprehension.

Display Elements

  • Large numeric value.
  • Unit.
  • Title and optional description.
  • Optional mini trend visualization (sparkline).

Layout Options

  • Single value or multiple values within one widget.
  • Horizontal or vertical arrangement.
  • Automatic or fixed font sizes.

The widget is particularly well suited for KPI rows and overview dashboards.

Colors, Thresholds, and States

The Stat widget is well suited for representing states.

Thresholds

  • Configurable limit values.
  • Color changes for the value or the background.
  • Representation of a simple traffic light logic.

Typical examples:

  • Battery state of charge below 20 percent. Displayed in red.
  • Power above nominal value. Displayed in red.
  • Consumption within target range. Displayed in green.

Color Modes

  • Value.
  • Background.
  • None.

Time Reference and Context

Important for correct interpretation:

  • The Stat widget does not show a trend, but a result.
  • The displayed value always depends on the selected time range.
  • The global dashboard time filter is therefore decisive.

A common mistake is interpreting Stat values without considering the selected time range.

Multiple Values in a Single Stat Widget

The Stat widget can display multiple values at the same time.

You can:

  • Define multiple queries.
  • Display each query as a separate Stat field.
  • Use aliases to give series meaningful names.

This allows, for example, combining the following in one widget:

  • Consumption today.
  • Consumption yesterday.
  • Average consumption.

Interaction and Drilldown

The Stat widget can be used as an entry point for deeper analysis.

Possible options include:

  • Linking to other dashboards.
  • Linking to detailed time series views.
  • Using the Stat widget as a clickable KPI.

Typical flow:

  • Stat shows current consumption.
  • Click opens a detailed time series visualization.

Typical Limitations of the Stat Widget

For realistic expectations:

  • No built-in alerting within the widget itself.
  • No complex calculations inside the widget.
  • No visualization of state transitions or trends.
  • Dependent on well-defined metrics and queries.

The Stat widget is a display widget, not an analysis widget.

Typical Usage Recommendations

Very well suited for:

  • KPI dashboards.
  • Management overviews.
  • Status indicators.
  • Target achievement.
  • Consumption totals.

Less suited for:

  • Root cause analysis.
  • Trend evaluation.
  • Time comparisons without complementary charts.

Summary

With the Stat widget in the Time Series Data Service, you can:

  • Reduce complex time series data to a clear statement.
  • Visually represent states in an intuitive way.
  • Create dashboards that are clear and support decision-making.

In industrial and energy dashboards, the Stat widget is the counterpart to Graph or Time Series widgets. First gain an overview, then dive into the details.