Skip to content

Gauge

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 ‣ Gauge

On this page

  1. Purpose and Scope
  2. Data Basis and Reduction
  3. Min and Max Values. Core Prerequisite
  4. Thresholds and Color Logic
    1. Thresholds
  5. Visualization and Variants
    1. Display Elements
    2. Layout
  6. Time Reference and Interpretation
  7. Multiple Gauges in One Widget
  8. Interaction and Use in Dashboards
  9. Typical Limitations of the Gauge Widget
  10. Differentiation from the Stat Widget
  11. Summary

Purpose and Scope

The Gauge widget displays a single numeric value in relation to a defined value range. It does not only answer the question of how high a value is, but more importantly:

Where is this value located within the allowed or expected range?

This makes the Gauge widget more state-oriented than the Stat widget and particularly suitable for evaluating limit and target ranges.

Typical use cases include:

  • Battery state of charge in percent.
  • Current power in relation to nominal power.
  • System utilization.
  • Temperature within permissible limits.
  • Fill level or capacity utilization.

Data Basis and Reduction

Like the Stat widget, the Gauge widget works with reduced values derived from time series or tabular data.

Supported reduction functions include, among others:

  • Last.
  • First.
  • Min.
  • Max.
  • Mean.
  • Sum.
  • Difference.

The Gauge always displays exactly one value per visualization. If multiple values need to be displayed, this is done using multiple series within the panel or multiple Gauge widgets.

Min and Max Values. Core Prerequisite

The Gauge widget is only meaningful if minimum and maximum values are correctly defined.

Possible ways to define them include:

  • Automatic derivation from the data.
  • Manual definition.
  • Configuration via field overrides per series.

Typical examples:

  • State of charge: 0 to 100 percent.
  • Power: 0 to 500 kW.
  • Temperature: minus 20 to plus 80 degrees Celsius.

Without meaningful limit values, the Gauge loses its interpretability because the context is missing.

Thresholds and Color Logic

The real strength of the Gauge widget lies in the combination of scale and color logic.

Thresholds

  • Freely definable value ranges.
  • Colored segments along the scale.
  • Representation of a classic traffic light logic.

Example for battery state of charge:

  • 0 to 20 percent: red.
  • 20 to 40 percent: yellow.
  • 40 to 100 percent: green.

The color refers to the position of the value within the defined range, not just to the absolute numeric value.

Visualization and Variants

Display Elements

  • Semi-circular or full-circle gauge.
  • Display as a needle or a filled area.
  • Optional display of the numeric value.
  • Unit and title are freely configurable.

Layout

  • Very compact visualization.
  • Well suited for overview and status dashboards.
  • Less suitable for detail or analysis pages.

Time Reference and Interpretation

For correct interpretation, the following is important:

  • The Gauge does not show a time trend.
  • The displayed value is always the result of the reduction over the selected time range.
  • In practice, the last available value is often used.

A common mistake is to view a Gauge over a long time range when the intention is actually to assess the current state.

Multiple Gauges in One Widget

The Gauge widget can display multiple series.

You can:

  • Define multiple queries.
  • Display each series as a separate gauge.
  • Clearly name series using aliases.

Example:

  • State of charge battery A.
  • State of charge battery B.
  • State of charge battery C.

This is meaningful as long as the scales are comparable.

Interaction and Use in Dashboards

The Gauge widget is very well suited as a visual entry point.

Typical usage pattern:

  • Gauge shows current state or utilization.
  • Click leads to a detailed dashboard with a time series view.

The Gauge is a warning and status signal, not an analysis tool.

Typical Limitations of the Gauge Widget

For realistic expectations:

  • No built-in alerting within the widget itself.
  • No complex calculations within the panel.
  • No visualization of state changes or history.
  • Limited comparison options between time ranges.

The Gauge answers one clearly defined question, and only that one.

Differentiation from the Stat Widget

In short:

  • Stat shows a value.
  • Gauge shows a value in the context of a defined range.

If context is crucial, the Gauge is the better choice. If space efficiency and pure numeric display are more important, the Stat widget is more suitable.

Summary

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

  • Quickly and intuitively assess states.
  • Evaluate capacities and utilization.
  • Apply traffic light logic to technical and energy-related KPIs.

The Gauge widget is not designed for analysis, but for quick assessment and decision-making at the dashboard level.