9 Gráfico

Resumen

El widget de gráfico proporciona una forma moderna y versátil de visualizar datos recopilados por Zabbix mediante una técnica de dibujo de imágenes vectoriales. Este widget de gráfico es compatible desde Zabbix 4.0. Tenga en cuenta que el widget de gráfico compatible antes de Zabbix 4.0 todavía puede utilizarse como Graph (classic). Consulte también la sección Adding widgets en la página Dashboards para obtener más detalles.

Configuración

Para configurar, seleccione Gráfico como tipo:

Conjunto de datos

La pestaña Conjunto de datos permite seleccionar datos para el gráfico agregando conjuntos de datos. Se pueden agregar dos tipos de conjuntos de datos:

  • Patrones de item - se muestran los datos de los items que coinciden. El gráfico se dibuja usando distintos tonos de un solo color para cada item.
  • Lista de item - se muestran los datos de los items seleccionados. El gráfico se dibuja usando distintos colores para cada item.

De forma predeterminada, se agrega un conjunto de datos de Patrones de item.

Conjunto de datos Para el conjunto de datos de Patrones de item:
Seleccione o introduzca patrones de host e item; se mostrarán en el gráfico los datos de los items que coincidan con estos patrones; se pueden mostrar hasta 50 items.
Se pueden usar patrones comodín para la selección (por ejemplo, * devolverá resultados que coincidan con cero o más caracteres).
Para especificar un patrón comodín, introduzca la cadena manualmente y pulse Enter.
El símbolo comodín siempre se interpreta, por lo que no es posible agregar, por ejemplo, un item llamado item* de forma individual si hay otros items coincidentes (por ejemplo, item2, item3).
Es obligatorio especificar patrones de host e item para los conjuntos de datos de "Patrones de item".
Consulte también: Detalles de configuración del conjunto de datos.

Para el conjunto de datos de Lista de item:
Seleccione items para el gráfico haciendo clic en el botón Agregar item.
Desde Zabbix 7.0.1, también puede seleccionar widgets compatibles como fuente de datos para los items haciendo clic en el botón Agregar widget.
Es obligatorio especificar items o widgets para los conjuntos de datos de "Lista de item".
Consulte también: Detalles de configuración del conjunto de datos.

Tenga en cuenta que solo se permiten tipos de item numéricos.

Al configurar el widget en un panel de template, el parámetro para especificar patrones de host no está disponible, y el parámetro para especificar una lista de item solo permite seleccionar los items configurados en el template.
Dibujar Elija el tipo de dibujo de la métrica.
Tipos de dibujo posibles: Línea (establecido de forma predeterminada), Puntos, Escalera y Barra.
Tenga en cuenta que si solo hay un punto de datos en el gráfico de línea/escalera, se dibuja como un punto independientemente del tipo de dibujo. El tamaño del punto se calcula a partir del ancho de la línea, pero no puede ser inferior a 3 píxeles, incluso si el ancho de la línea es menor.
Apilado Marque la casilla para mostrar los datos apilados (se muestran áreas rellenas).
Esta opción está deshabilitada cuando se selecciona el tipo de dibujo Puntos.
Ancho Establezca el ancho de la línea.
Esta opción está disponible cuando se selecciona el tipo de dibujo Línea o Escalera.
Tamaño del punto Establezca el tamaño del punto.
Esta opción está disponible cuando se selecciona el tipo de dibujo Puntos.
Transparencia Establezca el nivel de transparencia.
Relleno Establezca el nivel de relleno.
Esta opción está disponible cuando se selecciona el tipo de dibujo Línea o Escalera.
Datos faltantes Seleccione la opción para mostrar los datos faltantes:
Ninguno - el espacio queda vacío;
Conectado - se conectan dos valores de borde;
Tratar como 0 - los datos faltantes se muestran como valores 0;
Último conocido - los datos faltantes se muestran con el mismo valor que el último valor conocido; no aplicable para el tipo de dibujo Puntos y Barra.
Eje Y Seleccione el lado del gráfico donde se mostrará el eje Y.
Desplazamiento temporal Especifique el desplazamiento temporal si es necesario.
Puede usar sufijos de tiempo en este campo. Se permiten valores negativos.
Función de agregación Especifique qué función de agregación usar para cada item o para todo un conjunto de datos dentro del Intervalo de agregación seleccionado:
min - muestra el valor más pequeño;
max - muestra el valor más grande;
avg - muestra el valor promedio;
sum - muestra la suma de los valores;
count - muestra el recuento de valores;
first - muestra el primer valor;
last - muestra el último valor.
Si se selecciona no usado, se muestran todos los valores (sin agregación).

Solo se pueden mostrar datos numéricos para min, max, avg y sum. Para count, los datos no numéricos se convertirán en numéricos.
Consulte también: Agregación en gráficos.
Intervalo de agregación Especifique el intervalo para agregar valores.
Puede usar sufijos de tiempo en este campo. Un valor numérico sin sufijo se considerará en segundos.

Tenga en cuenta que si el widget está configurado para mostrar datos históricos basados en trends (Selección de datos históricos está establecido en Trends o Auto), se recomienda usar un intervalo de agregación que sea múltiplo de 1 hora (por ejemplo, 3600, 60m, 1h, 3h, etc.). Trends almacena valores agregados por hora, por lo que usar un intervalo de agregación que no sea múltiplo de 1 hora (por ejemplo, 100s, 7min, 15min, 90min, etc.) puede dar lugar a resultados difíciles de interpretar.
Agregar Especifique si se debe agregar:
Cada item - cada item del conjunto de datos se agregará y se mostrará por separado;
Conjunto de datos - todos los items del conjunto de datos se agregarán y se mostrarán como un solo valor.
Aproximación Especifique qué valor mostrar cuando exista más de un valor por píxel vertical del gráfico:
all - muestra los valores más pequeño, más grande y promedio;
min - muestra el valor más pequeño;
max - muestra el valor más grande;
avg - muestra el valor promedio.

Esta configuración es útil al mostrar un gráfico para un período de tiempo largo con un intervalo de actualización frecuente (como un año de valores recopilados cada 10 minutos).
Etiqueta del conjunto de datos Especifique la etiqueta del conjunto de datos que se muestra en la configuración del gráfico Conjunto de datos y en la Leyenda del gráfico (para conjuntos de datos agregados).
Todos los conjuntos de datos se numeran, incluidos aquellos con una Etiqueta del conjunto de datos especificada. Si no se especifica ninguna etiqueta, el conjunto de datos se etiquetará automáticamente según su número (por ejemplo, "Conjunto de datos #2", "Conjunto de datos #3", etc.). La numeración de los conjuntos de datos se recalcula después de reordenar o arrastrar los conjuntos de datos.
Las etiquetas de conjunto de datos demasiado largas se acortarán para ajustarse al lugar donde se muestran (por ejemplo, "Number of proc...").
Detalles de configuración del conjunto de datos

Los conjuntos de datos existentes se muestran en una lista. Puede:

  • Hacer clic en el icono de mover y arrastrar un conjunto de datos a una nueva posición en la lista.
  • Hacer clic en el icono de expandir para expandir los detalles del conjunto de datos. Cuando está expandido, este icono se convierte en un icono de contraer .
  • Hacer clic en el icono de color para cambiar el color, ya sea desde el selector de color o manualmente. Para el conjunto de datos Item patterns, el color se usa para calcular distintos tonos de color para cada item. Para el conjunto de datos Item list, el color se usa para el item especificado.
  • Hacer clic en el botón Add new data set para añadir un conjunto de datos vacío que permita seleccionar patrones de host e item. Si hace clic en el icono de flecha hacia abajo junto al botón Add new data set, aparecerá un menú desplegable que le permitirá añadir un nuevo conjunto de datos Item patterns o Item list, o bien Clone el conjunto de datos actualmente abierto. Si todos los conjuntos de datos están contraídos, la opción Clone no está disponible.

El conjunto de datos Item patterns contiene los campos Host patterns y Item patterns, que ambos reconocen nombres completos o patrones que contienen un símbolo comodín (*). Esta funcionalidad le permite seleccionar todos los nombres de host y los nombres de item que contienen el patrón seleccionado. Mientras escribe el nombre del item o el patrón de item en el campo Item patterns, solo se muestran en la lista desplegable los items que pertenecen al/los nombre(s) de host seleccionado(s).

Por ejemplo, al escribir un patrón z* en el campo Host patterns, la lista desplegable muestra todos los nombres de host que contienen este patrón: z*, Zabbix server, Zabbix proxy. Después de pulsar Enter, este patrón se acepta y se muestra como z*. De forma similar, al escribir el patrón a* en el campo Item patterns, la lista desplegable muestra todos los nombres de item que contienen este patrón: a*, Available memory, Available memory in %.

Después de pulsar Enter, el patrón se acepta y se muestra como a*. A continuación, el gráfico muestra todos los items que pertenecen al/los nombre(s) de host seleccionado(s).

El conjunto de datos Lista de elementos contiene el botón Agregar elemento que le permite agregar elementos que se mostrarán en el gráfico. Desde Zabbix 7.0.1, también puede agregar widgets compatibles como fuente de datos para los elementos haciendo clic en el botón Agregar widget.

Por ejemplo, al hacer clic en el botón Agregar elemento se abre una ventana emergente que contiene un parámetro Host. Una vez seleccionado un host, todos los elementos que están disponibles para su selección se muestran en una lista. Después de seleccionar uno o más elementos, se mostrarán en la lista de elementos del conjunto de datos y en el gráfico.

Agregación en gráficos

La agregación permite mostrar un valor agregado (mínimo, máximo, promedio, etc.) durante un intervalo de tiempo especificado (5 minutos, una hora, un día, etc.) en lugar de todos los valores individuales. Dentro de un conjunto de datos, la agregación puede aplicarse a cada item por separado o a todo el conjunto de datos.

Algunos casos de uso de la función de agregación pueden ser los siguientes:

  • El número promedio de solicitudes a un server Nginx por día.
  • El menor espacio en disco entre clústeres por semana.

En el siguiente ejemplo, la función de agregación "max" se aplica al item con un intervalo de agregación de cinco minutos:

El ejemplo muestra la carga máxima de CPU durante cinco minutos (agregada a partir de valores promedio de un minuto), comparada con la carga promedio de CPU durante cinco minutos.

Cuando se selecciona Show aggregation function para la leyenda, los items se muestran entre paréntesis, precedidos por la función de agregación en la leyenda y en la información sobre herramientas. Si se especifica Data set label para un gráfico, la etiqueta se muestra entre paréntesis, precedida por la función de agregación.

Mostrando opciones

La pestaña Mostrando opciones permite definir la selección de datos históricos:

Selección de datos históricos Establece la fuente de los datos del gráfico:
Auto - los datos se obtienen según el algoritmo clásico del gráfico (predeterminado);
History - datos de history;
Trends - datos de trends.
Simple triggers Marque la casilla para mostrar los umbrales de trigger para los simple triggers. Los umbrales se dibujarán como líneas discontinuas usando el color de severidad del trigger.
Un simple trigger es un trigger con una función (solo last, max, min, avg) para un item en la expresión.
Se pueden dibujar como máximo tres triggers. Tenga en cuenta que el trigger debe estar dentro del rango dibujado para ser visible.
Working time Marque la casilla para mostrar el tiempo de trabajo en el gráfico. El tiempo de trabajo (días laborables) se muestra en los gráficos con un fondo blanco, mientras que el tiempo no laborable se muestra en gris (con el tema predeterminado del frontend Original blue).
Percentile line (left) Marque la casilla e introduzca el valor del percentil para mostrar el percentil especificado como una línea en el eje Y izquierdo del gráfico.
Por ejemplo, si se establece un percentil del 95%, la línea del percentil estará en el nivel por debajo del cual cae el 95 por ciento de los valores.
Percentile line (right) Marque la casilla e introduzca el valor del percentil para mostrar el percentil especificado como una línea en el eje Y derecho del gráfico.
Por ejemplo, si se establece un percentil del 95%, la línea del percentil estará en el nivel por debajo del cual cae el 95 por ciento de los valores.

Período de tiempo

La pestaña Período de tiempo permite establecer un período de tiempo para el que se mostrarán los datos en el gráfico:

Período de tiempo Seleccione la fuente de datos para el período de tiempo:
Dashboard - establezca el selector Período de tiempo como fuente de datos;
Widget - establezca un widget compatible especificado en el parámetro Widget como fuente de datos;
Custom - establezca el período de tiempo especificado en los parámetros From y To como fuente de datos; si se establece, se mostrará un icono de reloj en la esquina superior derecha del widget, indicando la hora configurada al pasar el mouse.
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 en "Widget".
From 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 en "Custom".
To 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 en "Custom".

Ejes

La pestaña Ejes permite personalizar cómo se muestran los ejes:

Left Y Marque esta casilla para hacer visible el eje Y izquierdo.
La casilla puede estar deshabilitada si no está seleccionada en la pestaña Data set o en la pestaña Overrides.
Right Y Marque esta casilla para hacer visible el eje Y derecho.
La casilla puede estar deshabilitada si no está seleccionada en la pestaña Data set o en la pestaña Overrides.
X-Axis Desmarque esta casilla para ocultar el eje X (marcada de forma predeterminada).
Min Establezca el valor mínimo del eje correspondiente.
Se especifica el valor mínimo del rango visible del eje Y.
Max Establezca el valor máximo del eje correspondiente.
Se especifica el valor máximo del rango visible del eje Y.
Units Elija la unidad para los valores del eje del gráfico en la lista desplegable.
Si se selecciona la opción Auto, los valores del eje se muestran usando las unidades del primer item del eje correspondiente.
La opción Static permite asignar un nombre personalizado al eje correspondiente. Si se selecciona la opción Static y el campo de entrada value se deja en blanco, el nombre del eje correspondiente constará solo de un valor numérico.

Leyenda

La pestaña Leyenda permite personalizar la leyenda del gráfico:

Mostrar leyenda Desmarque esta casilla para ocultar la leyenda en el gráfico (marcada por defecto).
Mostrar mín/prom/máx Marque esta casilla para mostrar los valores mínimo, promedio y máximo de la métrica en la leyenda.
Mostrar función de agregación Marque esta casilla para mostrar la función de agregación en la leyenda.
Filas Seleccione el modo de visualización para las filas de la leyenda:
Fijo: el número de filas mostradas está determinado por el valor del parámetro Número de filas;
Variable: el número de filas mostradas está determinado por la cantidad de métricas configuradas sin exceder el valor del parámetro Número máximo de filas.
Número de filas/
Número máximo de filas
Si Filas está configurado como "Fijo", establezca el número de filas de la leyenda a mostrar (1-10).
Si Filas está configurado como "Variable", establezca el número máximo de filas de la leyenda a mostrar (1-10).
Número de columnas Establezca el número de columnas de la leyenda a mostrar (1-4).
Este parámetro está disponible si Mostrar mín/prom/máx está desmarcado.

Problemas

La pestaña Problemas permite personalizar la visualización de problemas:

Mostrar problemas Marque esta casilla para habilitar la visualización de problemas en el gráfico (sin marcar, es decir, deshabilitada de forma predeterminada).
Solo elementos seleccionados Marque esta casilla para incluir solo los problemas de los elementos seleccionados que se mostrarán en el gráfico.
Hosts con problemas Seleccione los hosts con problemas que se mostrarán en el gráfico.

Se pueden usar patrones comodín (por ejemplo, * devolverá resultados que coincidan con cero o más caracteres).
Para especificar un patrón comodín, solo introduzca la cadena manualmente y pulse Enter.
Mientras escribe, observe cómo todos los hosts coincidentes se muestran en la lista desplegable.

Este parámetro no está disponible al configurar el widget en un template dashboard.
Severidad Marque las severidades de los problemas para filtrar los problemas que se mostrarán en el gráfico.
Si no se marca ninguna severidad, se mostrarán todos los problemas.
Problema Especifique el nombre del problema que se mostrará en el gráfico.
Etiquetas de problema Especifique etiquetas de problema para limitar el número de problemas mostrados en el widget.
Es posible incluir y excluir etiquetas y valores de etiqueta específicos. Se pueden establecer varias condiciones. La coincidencia del nombre de la etiqueta siempre distingue entre mayúsculas y minúsculas.

Hay varios operadores disponibles para cada condición:
Exists - incluye los nombres de etiqueta especificados;
Equals - incluye los nombres y valores de etiqueta especificados (distingue entre mayúsculas y minúsculas);
Contains - incluye los nombres de etiqueta especificados cuyos valores de etiqueta contienen la cadena introducida (coincidencia de subcadena, sin distinguir entre mayúsculas y minúsculas);
Does not exist - excluye los nombres de etiqueta especificados;
Does not equal - excluye los nombres y valores de etiqueta especificados (distingue entre mayúsculas y minúsculas);
Does not contain - excluye los nombres de etiqueta especificados cuyos valores de etiqueta contienen la cadena introducida (coincidencia de subcadena, sin distinguir entre mayúsculas y minúsculas).

Hay dos tipos de cálculo para las condiciones:
And/Or - deben cumplirse todas las condiciones; las condiciones que tengan el mismo nombre de etiqueta se agruparán mediante la condición Or;
Or - basta con que se cumpla una condición.

Overrides

La pestaña Overrides permite añadir overrides personalizados para conjuntos de datos:

Los overrides son útiles cuando se seleccionan varios items para un conjunto de datos usando el comodín * y desea cambiar la forma en que los items se muestran de forma predeterminada (por ejemplo, el color base predeterminado o cualquier otra propiedad).

Los overrides existentes, si los hay, se muestran en una lista. Para añadir un nuevo override:

  • Haga clic en el botón
  • Seleccione hosts e items para el override. Como alternativa, puede introducir patrones de host e item. Se pueden usar patrones con comodines (por ejemplo, * devolverá resultados que coincidan con cero o más caracteres). Para especificar un patrón con comodín, simplemente introduzca la cadena manualmente y pulse Enter. Mientras escribe, observe cómo se muestran todos los hosts coincidentes en el desplegable. El símbolo de comodín se interpreta siempre, por lo tanto no es posible añadir, por ejemplo, un item llamado "item*" de forma individual si hay otros items coincidentes (por ejemplo, item2, item3). Los parámetros de patrón de host y patrón de item son obligatorios. El parámetro para especificar patrones de host no está disponible al configurar el widget en un template dashboard. El parámetro para especificar una lista de items permite seleccionar solo items configurados en el template al configurar el widget en un template dashboard.
  • Haga clic en , para seleccionar los parámetros del override. Debe seleccionarse al menos un parámetro de override. Para las descripciones de los parámetros, consulte la pestaña Data set anterior.

La información mostrada por el widget de gráfico se puede descargar como una imagen .png mediante el menú del widget:

Se guardará una captura de pantalla del widget en la carpeta Descargas.