Valor del item

Descripción general

El widget Item value muestra el valor de un único item numérico o de cadena. Es útil para supervisar métricas importantes, visualizar umbrales y detectar cambios repentinos en los datos.

Puede configurar el widget para mostrar lo siguiente:

  • Marca de tiempo de la métrica (2024-11-21 09:57:30)
  • Descripción del item (Load average (1m), Agent status)
  • Valor del item, indicador de cambio y unidades (0.47 ↓, 99 ↑ Mbps)
  • Color de fondo
  • Gráfico sparkline de los valores del período de tiempo especificado

Al hacer clic en el widget, se abre un gráfico ad hoc para items numéricos o los datos más recientes para items de cadena.

Configuración

Para configurar, seleccione Valor del item como tipo de widget:

Además de los parámetros comunes para todos los widgets, puede establecer las siguientes opciones específicas:
Item Seleccione el item.
Como alternativa, seleccione un widget compatible como fuente de datos para el item.
Los items que devuelven datos binarios no son compatibles.
Mostrar Marque la casilla para mostrar el elemento correspondiente: descripción, valor, hora, indicador de cambio, minigráfico. Desmárquela para ocultarlo. Debe seleccionarse al menos un elemento.
Sobrescribir host Seleccione un widget compatible o el selector de host del dashboard como fuente de datos para hosts.
Este parámetro no está disponible al configurar el widget en un dashboard de template.
Configuración avanzada Haga clic en el encabezado Configuración avanzada para mostrar las opciones de configuración avanzada.

Configuración avanzada

Las opciones de configuración avanzada están disponibles en la sección plegable Configuración avanzada, y solo para aquellos elementos que están seleccionados en el campo Mostrar (ver arriba).

Tenga en cuenta que varios elementos no pueden ocupar el mismo espacio; si se colocan en el mismo espacio, se mostrará un mensaje de error.

Parámetros genéricos del widget

Estos parámetros determinan el color de fondo (estático o dinámico) de todo el widget y una función de agregación para mostrar los valores.
Color de fondo Seleccione el color de fondo de todo el widget en el selector de color.
D representa el color predeterminado (depende del tema del frontend). Para volver al valor predeterminado, haga clic en el botón Usar predeterminado del selector de color.
Umbrales Configure el color de fondo dinámico de todo el widget. Haga clic en Añadir para añadir un umbral, seleccione el color de fondo en el selector de color y especifique un valor numérico. Cuando el valor del item sea igual o superior al valor del umbral, cambiará el color de fondo.
La lista se ordenará en orden ascendente al guardarla.
Tenga en cuenta que el color de fondo dinámico se mostrará correctamente solo para items numéricos.
Función de agregación Especifique qué función de agregación se utilizará dentro del Período de tiempo seleccionado:
min - muestra el valor más pequeño;
max - muestra el valor más grande;
avg - muestra el valor promedio;
count - muestra la cantidad de valores;
sum - muestra la suma de los valores;
first - muestra el primer valor;
last - muestra el último valor.
Si se selecciona no utilizar, se muestra el valor más reciente (sin agregación).

La agregación permite mostrar un valor agregado para el intervalo especificado (5 minutos, una hora, un día), en lugar del valor más reciente.
Solo se pueden mostrar datos numéricos para min, max, avg y sum. Para count, los datos no numéricos se convertirán a numéricos.
Período de tiempo Período de tiempo que se utilizará para agregar los valores. Seleccione la fuente de datos para el período de tiempo:
Dashboard - utiliza el selector de período de tiempo del dashboard;
Widget - utiliza un widget compatible (establecido en el parámetro Widget);
Personalizado - utiliza un período de tiempo personalizado establecido en los parámetros Desde y Hasta; si se establece, se mostrará un icono de reloj en la esquina superior derecha del widget, que indicará la hora establecida al pasar el ratón por encima.
Tenga en cuenta que, independientemente de la configuración de Período de tiempo del widget, los widgets compatibles aún pueden utilizarlo como fuente de datos para el período de tiempo.
Este parámetro está oculto cuando Función de agregación está establecida en "no utilizar".
Widget Introduzca o seleccione un widget compatible como fuente de datos para el período de tiempo.
Este parámetro está disponible si Período de tiempo está establecido en "Widget".
Desde Introduzca o seleccione el inicio del período de tiempo.
Se admite la sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).
Este parámetro está disponible si Período de tiempo está establecido en "Personalizado".
Hasta Introduzca o seleccione el final del período de tiempo.
Se admite la sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).
Este parámetro está disponible si Período de tiempo está establecido en "Personalizado".
Datos históricos Obtenga los datos del historial o de las tendencias:
Auto - selección automática;
History - obtiene los datos del historial;
Trends - obtiene los datos de las tendencias.

Esta configuración se aplica únicamente a los datos numéricos. Los datos no numéricos siempre se obtendrán del historial.
Descripción

Estos parámetros determinan cómo debe mostrarse la descripción de la métrica.
Descripción Introduzca la descripción de la métrica. Esta descripción puede sobrescribir el nombre por defecto de la métrica. Se admiten descripciones multilínea. Es posible una combinación de texto y macros soportadas.
Se admiten {HOST.*}, {ITEM.*}, {INVENTORY.*} y macros de usuario.
Posición horizontal Seleccione la posición horizontal de la descripción de la métrica: izquierda, derecha o centrada.
Posición vertical Seleccione la posición vertical de la descripción de la métrica: arriba, abajo o en el medio.
Tamaño Introduzca el tamaño de la fuente para la descripción de la métrica (en porcentaje relativo a la altura total del widget).
Negrita Marque la casilla para mostrar la descripción de la métrica en negrita.
Color Seleccione el color de la descripción de la métrica desde el selector de color.
D significa color por defecto (depende del tema de la interfaz web). Para volver al valor por defecto, haga clic en el botón Usar por defecto en el selector de color.
Valor

Estos parámetros determinan cómo se debe mostrar el valor de la métrica.
Decimales Seleccione cuántos decimales se mostrarán con el valor. Este valor solo afectará a las métricas de tipo flotante. Para las métricas con unidades configuradas como "s", si este valor es mayor que 0 (el valor predeterminado es 2), el widget redondea la unidad de tiempo más significativa y muestra un valor numérico (por ejemplo, "10.43m") en lugar de convertir el valor en una cadena de tiempo completa. Cuando se establece en 0, los segundos se convierten en una cadena de tiempo legible (por ejemplo, "4h 56m 30s").
Tamaño Introduzca la altura del tamaño de la fuente para los decimales (en porcentaje relativo a la altura total del widget).
Posición horizontal Seleccione la posición horizontal del valor de la métrica: izquierda, derecha o centro.
Posición vertical Seleccione la posición vertical del valor de la métrica: arriba, abajo o medio.
Tamaño Introduzca la altura del tamaño de la fuente para el valor de la métrica (en porcentaje relativo a la altura total del widget).
Tenga en cuenta que el tamaño del valor de la métrica tiene prioridad; otros elementos deben ceder espacio para el valor. Sin embargo, con el indicador de cambio, si el valor es demasiado grande, se truncará para mostrar el indicador de cambio.
Negrita Marque la casilla para mostrar el valor de la métrica en negrita.
Color Seleccione el color del valor de la métrica desde el selector de color.
D significa color por defecto (depende del tema de la interfaz). Para volver al valor por defecto, haga clic en el botón Usar por defecto en el selector de color.
Unidades
Unidades Marque la casilla para mostrar las unidades junto al valor de la métrica. Si introduce un nombre de unidad, sobrescribirá la unidad de la configuración de la métrica.
Posición Seleccione la posición de la unidad de la métrica: encima, debajo, antes o después del valor.
Tamaño Introduzca la altura del tamaño de la fuente para la unidad de la métrica (en porcentaje relativo a la altura total del widget).
Negrita Marque la casilla para mostrar la unidad de la métrica en negrita.
Color Seleccione el color de la unidad de la métrica desde el selector de color.
D significa color por defecto (depende del tema de la interfaz). Para volver al valor por defecto, haga clic en el botón Usar por defecto en el selector de color.
Hora

Estos parámetros determinan cómo se debe mostrar la hora (valor de reloj del historial de la métrica).
Posición horizontal Seleccione la posición horizontal de la hora: izquierda, derecha o centro.
Posición vertical Seleccione la posición vertical de la hora: arriba, abajo o medio.
Tamaño Introduzca la altura del tamaño de la fuente para la hora (en porcentaje relativo a la altura total del widget).
Negrita Marque la casilla para mostrar la hora en negrita.
Color Seleccione el color de la hora desde el selector de color.
D significa color por defecto (depende del tema de la interfaz). Para volver al valor por defecto, haga clic en el botón Usar por defecto en el selector de color.
Indicador de cambio

La sección permite seleccionar el color de los indicadores de cambio mediante el selector de color.

Los indicadores de cambio son los siguientes:

  • ↑ - el valor del item ha aumentado (para items numéricos)
  • ↓ - el valor del item ha disminuido (para items numéricos)
  • ↕ - el valor del item ha cambiado (para items de tipo cadena y items con asignación de valores)

Nota:

  • Los indicadores de aumento (↑) y disminución (↓) no se muestran si solo hay un valor.
  • Los valores siempre se comparan dentro del mismo ámbito; por ejemplo:
    • El valor más reciente se compara con el valor anterior.
    • Un valor mensual se compara con el mes anterior.
    • Para las agregaciones, el período anterior tiene la misma duración que el período seleccionado y termina inmediatamente antes del inicio del período seleccionado.

D representa el color predeterminado (depende del tema del frontend). Para volver al valor predeterminado, haga clic en el botón Usar predeterminado del selector de color.

El tamaño vertical del indicador de cambio es igual al tamaño del valor (la parte entera del valor para items numéricos).

Sparkline

Estos parámetros determinan cómo debe mostrarse el gráfico de sparkline.
Ancho Establezca el grosor de la línea del gráfico usando el control deslizante o introduciendo manualmente un valor en el rango de 0 a 10.
Color Seleccione el color de la línea y del relleno.
Relleno Establezca el nivel de transparencia del color de relleno usando el control deslizante o introduciendo manualmente un valor en el rango de 0 a 10.
Período de tiempo Especifique el período de tiempo para los valores que se incluirán en el gráfico de sparkline. Seleccione la fuente de datos para el período de tiempo:
Panel: use el selector de período de tiempo del panel;
Widget: use un widget compatible (establecido en el parámetro Widget);
Personalizado: use un período de tiempo personalizado establecido en los parámetros Desde y Hasta; si se establece, se mostrará un icono de reloj en la esquina superior derecha del widget, indicando el tiempo establecido al pasar el ratón.
Tenga en cuenta que, independientemente de la configuración del Período de tiempo del widget, los widgets compatibles aún pueden usarlo como fuente de datos para el período de tiempo.
Este parámetro no está disponible si la Función de agregación está configurada como "no utilizada".
Widget Introduzca o seleccione un widget compatible como fuente de datos para el período de tiempo.
Este parámetro está disponible si Período de tiempo está configurado como "Widget".
Desde Introduzca o seleccione el inicio del período de tiempo.
Se admite la sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).
Este parámetro está disponible si Período de tiempo está configurado como "Personalizado".
Hasta Introduzca o seleccione el final del período de tiempo.
Se admite la sintaxis de tiempo relativo (now, now/d, now/w-1w, etc.).
Este parámetro está disponible si Período de tiempo está configurado como "Personalizado".
Datos históricos Tomar datos del historial o de tendencias:
Auto: selección automática;
Historial: tomar datos del historial;
Tendencias: tomar datos de tendencias.