Gauge

The Gauge Chart is a dial-style visualization ideal for displaying numeric values relative to a scale, often representing KPIs or target-driven metrics.
It features a needle or pointer indicating the value position, with support for ranges, color zones, and optional target markers.

Use cases:

• Displaying real-time KPIs or metrics.
• Visualizing progress towards a target.
• Showing performance against thresholds.
• Tracking single or multiple measures simultaneously.

Note

Use Gauge Charts when you need to emphasize a key metric’s status relative to a defined range or target.
Avoid for comparing large data sets or multi-category breakdowns.

---

⚙️ Setup

1. Drag the Gauge Chart widget from the chart library onto your designer workspace.
2. Select the chart.
3. Go to the Widget Configuration tab in the Configuration panel.
4. Under the Configuration panel tab, select the Basic Configuration option to access essential settings for the Gauge Chart.
5. Select the Source from which the chart will fetch its data.
6. Map:
   • Measure — Numeric value(s) to display on the gauge. Supports multiple measures for multi-dial charts.
7. Optionally add a Date field for time-based filtering.

---

📊 Basic Configuration

Configuration Item	Description
Source	The data source to query for chart values.
Measure	Numeric value(s) to be represented by gauge needles. Can support multiple measures per chart.
Date Field (optional)	Enables date-based filtering and drilldown capability.

Note

For multi-measure dashboards, assign multiple Measures to display separate gauge indicators within the same chart.

---

🎨 Chart Customizations

Category	Options & Description
General	Theme, background, border, and interactivity options.
Title	Chart title, font, alignment, and visibility settings.
Position	Adjust horizontal and vertical positioning of the gauge within the chart.
Series	Define dial appearance, scale ranges, intervals, maximum value, target pointers, and dual progress indicators.
Measures	Customize gauge needle properties, color, dual pointer behavior, and value display formatting for each measure.
Tooltip	Tooltip content, format, and triggers on hover.
Others	Control dial rotation, anchor visibility, axis labels, split lines, and pointer styles.

Note

Use Target Pointer options within Series settings to mark desired thresholds visually.

---

📊 Example Visualization