Skip to content

Graph

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

On this page

  1. Purpose and Scope
  2. Visualization and Styling
    1. Lines, Bars, and Points
    2. Axes and Units
    3. Colors and Series Overrides
  3. Legend and Interaction
  4. Aggregation and Temporal Resolution
  5. Thresholds and Notifications
    1. Thresholds in the Graph Widget
    2. Notifications
  6. Annotations and Events
  7. Multiple Queries and Comparisons
  8. Typical Limitations of the Graph Widget
    1. Summary

Purpose and Scope

The Graph widget is primarily designed for the visualization and analysis of time series data.

You can:

  • Display one or multiple time series simultaneously.
  • Combine multiple metrics from different devices or data sources in a single chart.
  • Display time series with different units in parallel, for example kW and °C.
  • Analyze and compare temporal trends over freely selectable time ranges.

Typical use cases include:

  • Energy consumption and power profiles.
  • Battery state of charge.
  • Temperatures, voltages, and currents.
  • KPIs and status values over time.

Visualization and Styling

The Graph widget offers extensive configuration options to customize the visualization.

Lines, Bars, and Points

  • Time series can be displayed as lines, bars, or points.
  • Multiple series can be combined in a single chart.
  • Lines can be shown or hidden individually.
  • Line width, point rendering, and fill options are configurable.
  • Null values can be connected or displayed as gaps.
  • Smoothing via line interpolation is possible.
  • Stacked lines or bars are supported.

Axes and Units

  • Left and right Y-axes can be used in parallel.
  • Different units per axis are supported.
  • Manual minimum and maximum values can be defined.
  • A logarithmic scale can be enabled.
  • The time axis is always synchronized with the global dashboard time filter.

Colors and Series Overrides

  • Series can be displayed automatically or with fixed colors.
  • Using Series Overrides and Overrides, individual time series can be customized, for example:
  • Color
  • Axis assignment
  • Visualization type
  • Line or point options
  • Series names can be made more readable using alias rules.

Legend and Interaction

The legend is a central interaction element of the Graph widget.

You can:

  • Show or hide individual series.
  • Display statistical values such as Min, Max, Avg, Current, or Total.
  • Sort series by values.
  • Standardize series names using alias rules.

Mouse-over interactions display tooltips with exact values for the selected point in time. Multiple series can be inspected simultaneously.

Aggregation and Temporal Resolution

Temporal aggregation is applied automatically based on the selected time range.

  • The resolution dynamically adapts to the selected time range.
  • Aggregations such as mean, sum, minimum, or maximum are applied depending on the metric.
  • The Graph widget itself does not perform complex calculations.

Mathematical derivations such as differences, consumption derived from counters, or smoothed curves are provided by the underlying metric definition or upstream logic and are visualized in the Graph widget.

Thresholds and Notifications

Thresholds in the Graph Widget

  • Thresholds can be defined directly within the Graph widget.
  • Limit values are displayed as horizontal lines or colored markers.
  • Critical ranges can be visually highlighted.

Notifications

  • Threshold violations can trigger notifications.
  • Configuration is done in the Graph widget, while optionally using channels from the central notification system.
  • Notifications can be sent to different recipients and channels, for example email or collaboration tools.

Annotations and Events

The Graph widget supports annotations to provide context for time series data.

You can:

  • Add manual annotations, for example for maintenance, errors, or switching operations.
  • Display annotations with comments along the timeline.
  • Correlate events directly with measured value trends.

Multiple Queries and Comparisons

The Graph widget is well suited for comparisons.

Typical scenarios include:

  • Actual vs target values.
  • Today vs yesterday.
  • Plant A vs plant B.
  • Before and after an optimization.

Multiple queries can be named, scaled, and visualized differently while remaining time-synchronized.

Typical Limitations of the Graph Widget

For realistic expectations:

  • No true state timeline behavior.
  • No tabular or combined visualizations within the same widget.
  • Limited panel-internal transformations.
  • Performance may degrade with a very large number of simultaneous time series.

Summary

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

  • Analyze time series data in detail.
  • Compare multiple metrics and assets.
  • Monitor thresholds and trigger notifications.
  • Make events and annotations visible directly within the timeline.

The widget is ideal for monitoring, analysis, and reporting of time series data. It is intentionally not designed for complex state models or data-driven transformations.