Documentation
Table of Contents
25 Gauge
Overview
The Gauge widget displays the value of a single item as a gauge.
When configured, the widget can consist of the following elements:
- Item description (for example, "CPU utilization", "Speed")
- Item value (for example, "30.70", "19.80")
- Item value units (for example, "%", "km/h")
- Gauge scale (for example, "0%/100%", "0/100/180/200")
- Gauge arc (gauge value arc and gauge thresholds arc)
- Gauge needle
The widget can be visually fine-tuned using the advanced configuration options to create a wide variety of visual styles.
The gauge widget can display only numeric values. Displaying binary values is not supported.
Clicking on the Gauge widget leads to a graph for the item.
Configuración
Para configurar, seleccione Gauge como tipo:
Además de los parámetros que son comunes para todos los widgets, puede configurar las siguientes opciones específicas:
| Métrica | Seleccione la métrica. Tenga en cuenta que solo puede seleccionar métricas que devuelvan datos numéricos. |
| Min | Ingrese el valor mínimo del indicador. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Se admiten asignaciones de valores. |
| Max | Ingrese el valor máximo del indicador. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). Se admiten asignaciones de valores. |
| Colores | Seleccione el color en el selector de color: Arco de valor: seleccione el color del arco del valor del indicador; Fondo del arco: seleccione el arco del valor del indicador y el fondo del arco de los umbrales del indicador color; Fondo: seleccione el color de fondo del widget. "D" representa el color predeterminado, que depende del tema de la interfaz. Si se establecen Umbrales, el color predeterminado para Arco de valor depende del color del umbral. Para volver al color predeterminado, haga clic en el botón Usar predeterminado en el selector de color. |
| Mostrar | Marque la casilla de verificación para mostrar el elemento de calibre respectivo: descripción, valor, arco de valor, aguja, escala (el valor mínimo y máximo del calibre al principio y al final del arco de calibre). Desmarcar para ocultar. Se debe seleccionar al menos un elemento. Tenga en cuenta que la aguja y la escala del indicador se pueden mostrar si se muestra el arco del valor del indicador o el arco de los umbrales del indicador (consulte las opciones de configuración avanzada). También tenga en cuenta que si se muestra la aguja del calibre, el valor se coloca debajo de la aguja; si la aguja está oculta, el valor se alinea con la parte inferior del arco indicador. |
| Reemplazar equipo | Seleccione un widget compatible (Navegador de equipo) o el tablero como fuente de datos para equipos. Este parámetro no está disponible al configurar el widget en una plantilla de tablero. |
| Configuración avanzada | Haga clic en la etiqueta Configuración avanzada para mostrar las opciones de configuración avanzada. Aquí también podrás ajustar los elementos de gauge seleccionados en el campo Mostrar. |
Advanced configuration
Advanced configuration options are available in the collapsible Advanced configuration section.
| Angle | Select the gauge angle (180° or 270°). |
| Description | |
| Description | Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible. {HOST.*}, {ITEM.*}, {INVENTORY.*} and user macros are supported. |
| Size | Enter the font size height for the item description (in percent, relative to the total widget height). |
| Vertical position | Select the vertical position of the item description (top or bottom, relative to the gauge arc). |
| Bold | Mark the checkbox to display the item description in bold. |
| Color | Select the item description color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Value | |
| Decimal places | Enter the number of decimal places to display with the value. This option affects only items that return numeric (float) data. |
| Size | Enter the font size height for the value (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display the value in bold. |
| Color | Select the value color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Arc | Mark the checkbox to display the gauge value arc. |
| Arc size | Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius). |
| Units | |
| Units | Mark the checkbox to display units with the item value. If you enter a unit name, it will override the units set in the item configuration. |
| Size | Enter the font size height for the item units (in percent, relative to the gauge arc height). |
| Bold | Mark the checkbox to display item units in bold. |
| Position | Select the position of the item units (above, below, before or after, relative to the item value). This option is ignored for the following time-related units: unixtime, uptime, s. |
| Color | Select the item units color from the color picker. "D" stands for the default color, which depends on the frontend theme. To return to the default value, click the Use default button in the color picker. |
| Needle | |
| Needle | Mark the checkbox to display the gauge needle. If the needle is displayed, the value is placed under the needle; if the needle is hidden, the value is aligned with the bottom of the gauge arc. |
| Color | Select the gauge needle color from the color picker. "D" stands for the default color; if Thresholds are not set, the default color depends on the frontend theme; if Thresholds are set, the default color depends on the threshold color. To return to the default value, click the Use default button in the color picker. |
| Scale | |
| Scale | Mark the checkbox to display the minimum and maximum value of the gauge at the beginning and end of the gauge scale. |
| Show units | Mark the checkbox to display units with the minimum and maximum value of the gauge. |
| Size | Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height). |
| Decimal places | Enter the number of decimal places to display with the minimum and maximum value of the gauge. This option affects only items that return numeric (float) data. |
| Thresholds | |
| Thresholds | Click Add to add a threshold, select a threshold color from the color picker, and specify a numeric value. The thresholds list will be sorted in ascending order when saved. Note that the colors configured as thresholds will be displayed correctly only for numeric items. Suffixes (for example, "1d", "2w", "4K", "8G") are supported. Value mappings are supported. |
| Show labels | Mark the checkbox to display threshold values as labels on the gauge scale. |
| Show arc | Mark the checkbox to display the gauge thresholds arc. |
| Arc size | Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius). |
The information displayed by the gauge widget can be downloaded as a .png image using the widget menu.
A screenshot of the widget will be saved to the Downloads folder.