Gauge Widget Creation

Last updated on 02 November, 2022

Creating a Gauge widget involves configuring datapoints you want represented on the widget, and then choosing settings for how you want your Gauge widget to display on your dashboard.

While the gauge Widget is designed to display the current value of a configured datapoint, the Show Peak option enables you to view the highest value of that datapoint over the last hour to year. The peak is historical, so you can choose a time range that doesn’t include now for context. With this, the peak may actually be lower than the current value.

Creating a Gauge Widget

  1. Select the Gauge widget. For more information, see Selecting a Widget.
  2. Complete the Basic Information fields. For more information, see Standard Widget Configurations.
  3. In the Gauge Options settings, configure the widget datapoints. For more information, see Configuring a Datapoint.
  4. In the Data Series field, select how you’d like to see the data represented on the gauge, as an average, maximum, or minimum.
  5. In the Aggregate field, select how you’d like to see the aggregate value of metrics across all resources.
  6. To change how the datapoint value is calculated, select Perform Expression on Datapoint.

Note: This is helpful if you’re looking to edit units, display the value as a percentage, or have other formulas typically used when displaying the datapoint type.

  1. Enter a Legend name to provide an explanation for the data being displayed.

Note: Tokens can be used in this field if you’ve cloned a dashboard and need to update the information for a new client.

  1. In the Minimum field, enter a minimum value to be displayed on the widget.

Note: This value is commonly 0, but potentially a different value if you’re looking at a limited subset or range or if your range includes negative values.

  1. In the Maximum field, enter a maximum value to be represented on the widget.
  2. In the Display Unit As field, choose one of the following options:
    • If the actual number is meaningful (temp, count of servers, requests processed, and so on), select Raw value, and then enter a Unit (e.g., degrees) for the raw value.
    • If the number represents a part of a maximum capacity (CPU load, memory available, disk space available, and so on), select Percentage.
  3. Toggle on Show Peak to display a peak value over a selected time range.
  4. Toggle on Change gauge color according to thresholds to set specific thresholds to be displayed in green, yellow, or red in the Gauge widget.

Note: These thresholds are not related to the alert thresholds even though they’re the same colors.

  1. Select a Widget Color Schema. For more information, see Standard Widget Configurations.
  2. To preview the widget before saving, select Preview in the top right corner of the widget form.
  3. Select Save to save the widget to your dashboard.
In This Article