Dashboards and Widgets

Gauge widget

The Gauge widget enables you to present data on a relative scale, including peak values if desired.

Overview

If the metric you're keeping an eye on has a relative value, or is most meaningful to you as an aggregate value compared to a max, the Gauge widget may be your favorite new LogicMonitor feature. 

Overview


Create a Gauge Widget

Click on the Add drop-down and select gauge widget from the list. The Configuration form for setting up the gauge will be displayed. See these instructions for help filling out the title, description, dashboard and refresh frequency fields.

Gauge Datapoint

Begin by following our instructions for adding a datapoint to your gauge widget. If you're looking to create a virtual datapoint (perform a function on a datapoint) that is done slightly differently for this widget - first add a datapoint and then select the 'perform function on this datapoint' and enter an expression. Additional configuration options for each datapoint include Data Series, Legend, Gauge Minimum Value, and Gauge Maximum Value:

Data Series

Select how you would like to see the data represented on the gauge, as an average, maximum or minimum.

Legend

This field provides a place for explanation of the data displayed. 

Perform function on this datapoint

The perform function enables you to change how the datapoint value is calculated.  This is useful if you are looking to edit units, display the value as a percentage, or have other formulas typically utilized when displaying the datapoint type.

Perform function on this datapoint


Gauge Minimum Value (0%)

The minimum value to be displayed on the widget.  Commonly 0, but potentially a different value if you are looking at a limited subset or range.

Gauge Maximum Value (100%)

The maximum value to be represented on the widget.

Show Peak

Select this checkbox to display a peak value over a selected time range.  While the gauge widget is designed to display current value of a configured datapoint, the Peak option enables you to view the highest value of that datapoint over the last 1 hour to 1 year.

Show Peak

Gauge Widget Display


Once you have configured your Gauge Widget, it will appear on the designated dashboard. Note that the Gauge Widget has two potential display modes: Gauge and History Graph. 

1. Gauge: this will display data as a gauge. In this mode, the most recently collected data will be displayed in the widget. This is a single, snapshot value. As such, the data series configuration field (display the max, min, or mean of collected data) will not impact the data's display when the widget is set to "Gauge" mode. This mode is useful for displaying data as a percentage (ie. percent CPU usage on a node). 




2. History Graph: this will display all raw historical data on a line graph. In history graph mode, the data series configuration field (display the max, min, or mean of collected data) will impact the displayed trending values.