Gauge Property Reference

In the widget's side panel (Figure 195, “Widget menu options”), click the setting icon to configure the following properties.

  • Title

    The title of the widget as displayed in the dashboard.

  • Description

    The description of the widget. This is free form text supporting markdown syntax. The description appears in the dashboard as a tooltip when hovering over the question mark on top of the widget.

In the widget side panel (Figure 195, “Widget menu options”), click the style icon to configure the following properties. Also find some Styling panel examples at Gauge Examples Gallery.

  • Layout

    • Type can be:

      • Radial Fill — A radial gauge where the value is indicated by a colored arc.

      • Radial Needle — A radial gauge where the value is indicated by a needle.

    • Padding — Percentage of widget height or width used for padding. Useful when labels will otherwise be clipped.

  • Value

    • Format — The available units that can be used to express values. Valid options are:

      • Raw shows the number without formatting (for example, 4987).

      • Abbreviated shows the number abbreviated as thousands (K), millions (M), billions (B), or trillions (T).

      • Metric shows the number abbreviated with metric (SI) prefixes.

      • Time converts the value to a time span (years, months, days, hours, minutes, seconds...), depending on the input type selected.

    • Input type — Enabled when the Time format is selected, gives the input units available to express values. Valid options are:

      • Milliseconds

      • Seconds

    • Decimal places — Enabled when the Raw or Metric formats are selected, indicates the number of digits past the decimal point. It is possible to do number rounding by providing negative decimal places. For example, a decimal place of -2 would format the number 123 to 100.

    • Suffix allows to provide any symbol or definition useful to describe the resulting value. For example, $ or ms.

  • Range defines the minimum and maximum values of the gauge. Options are:

    • Min value — default is 0

    • Max value — default is 100

    • Show min/max values allows to display these values in the chart.

  • Colors to customize the chart colors.

    • Palette allows to choose a predefined palette of colors (can be diverging colors or monochrome with different nuances) automatically assigned to thresholds.

    • Thresholds allows to configure thresholds for the selected colors, for example light green applied to all values below 50, dark green for all above 100. You can modify the color for any threshold: this will turn the palette to a Custom palette. Multiple thresholds are supported.

  • Labels — A list of labels and associated anchor values. Anchor values describe where on the gauge the label is drawn. For example, an anchor value of 50 on a range from 0 to 100 would draw the label at the midpoint of the gauge.

  • Small multiples

    When toggled, the query result is partitioned using the first grouping field or the specified field in the settings, and a visualization for each subresult is displayed in a grid.

    • Field name — name of the field used to partition the query result.

    • Number of columns — the number of columns in the grid. If the number of visualizations are less than the desired number of columns, the number of visualizations are used instead. If the resulting size of each visualization will be smaller than 150px, the number of columns are also overwritten by the maximum possible.

    • Show borders — allows to show or hide a border around each visualization.