8 Gráficos

Descripción

Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del tablero permiten configurar el widget Gráfico en los métodos dashboard.create y dashboard.update.

Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero. Esto permite a los usuarios modificar built-in widgets y crear custom widgets, pero también introduce el riesgo de crear o actualizar widgets incorrectamente. Para garantizar la creación o actualización exitosa del widget Gráfico, consulte el comportamiento de los parámetros descritos en las tablas siguientes.

Parámetros

Los siguientes parámetros son compatibles con el widget Gráfico.

Parámetro tipo nombre valor
Intervalo de actualización 0 rf_rate 0 - Sin actualización;
10 - 10 segundos;
30 - 30 segundos;
60 - (predeterminado) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.

Conjunto de datos

Los siguientes parámetros son compatibles para configurar un conjunto de datos.

El primer número en el nombre de la propiedad (por ejemplo, ds.hosts.0.0, ds.items.0.0) representa el conjunto de datos particular, mientras que el segundo número, si está presente, representa el equipo o métrica configurada.

Parámetro tipo nombre valor
Patrón de equipo
(obligatorio)
1 ds.hosts.0.0 Nombre o patrón de equipo (por ejemplo, Zabbix*).
Patrón de métrica
(obligatorio)
1 ds.items.0.0 Nombre o patrón de métrica (por ejemplo, *: Número de *valores procesados por segundo).
Color 1 ds.color.0 Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: FF465C.
Dibujo 0 ds.type.0 0 - (predeterminado) Línea;
1 - Puntos;
2 - Escalera;
3 - Barra.
Ancho 0 ds.width.0 Los valores válidos oscilan entre 1 y 10.

Predeterminado: 1.

El parámetro Ancho no está disponible si Dibujar está configurado en "Puntos" o "Barra".
Tamaño de punto 0 ds.pointsize.0 Los valores válidos oscilan entre 1 y 10.

Predeterminado: 3.

El parámetro Tamaño de punto no está disponible si Dibujar está establezca en "Línea", "Escalera" o "Bar".
Transparencia 0 ds.transparency.0 Los valores válidos oscilan entre 1 y 10.

Predeterminado: 5.
Relleno 0 ds.fill.0 Los valores válidos oscilan entre 1 y 10.

Predeterminado: 3.

El parámetro Relleno no está disponible si Draw está configurado en "Puntos" o "Barra".
Datos faltantes 0 ds.missingdatafunc.0 0 - (predeterminado) Ninguno;
1 - Conectado;
2 - Tratar como 0.

Parámetro Datos faltantes no disponible si Dibujo está configurado en "Puntos" o "Barra".
Eje Y 0 ds.axisy.0 0 - (predeterminado) Izquierda;
1 - Derecha.
Desplazamiento de tiempo 1 ds.timeshift.0 Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo. También se permiten valores negativos.

Predeterminado: "" (vacío).
Función de agregación 0 ds.aggregate_function.0 0 - (predeterminado) ninguno;
1 - min;
2 - max;
3 - promedio;
4 - recuento ;
5 - suma;
6 - primero;
7 - último.
Intervalo de agregación 1 ds.aggregate_interval.0 Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo.

Predeterminado: 1h.
Agregación 0 ds.aggregate_grouping.0 0 - (predeterminado) Cada métrica;
1 - Conjunto de datos.

El parámetro Agregación no está disponible si la Función de agregación está configurada a "ninguno".

Opciones de visualización

Los siguientes parámetros son compatibles para configurar Opciones de visualización.

Parámetro tipo nombre valor
Selección de datos del historial 0 source 0 - (predeterminado) Automático;
1 - Historial;
2 - Tendencias.

Periodo de tiempo

Los siguientes parámetros son compatibles para configurar Período de tiempo.

Parámetro tipo nombre valor
Establecer período de tiempo personalizado 0 graph_time 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Desde 1 time_from Cadena de tiempo válida en formato AAAA-MM-DD hh:mm:ss.
Periodo de tiempo relativo (now, now/d, now/w-1w, etc.) también son compatibles.

Predeterminado: now-1h.
Hasta 1 time_to Valor de cadena de tiempo válido en formato AAAA-MM-DD hh:mm:ss.
Periodo de tiempo relativo también se admiten valores (now, now/d, now/w-1w, etc.).

Predeterminado: now.

Ejes

Los siguientes parámetros son compatibles para configurar Ejes.

Parámetro tipo nombre valor
Izquierda Y 0 lefty 0 - Deshabilitado;
1 - (predeterminado) Habilitado.

Parámetro disponible si Eje Y (en la configuración del Conjunto de datos) está configurado a "Izquierda".
Derecha Y 0 righty 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Parámetro disponible si Eje Y (en la configuración del Conjunto de datos) está configurado a "Derecha".
Min 1 lefty_min Cualquier valor numérico.

Predeterminado: "" (vacío).
righty_min
Max 1 lefty_max Cualquier valor numérico.

Predeterminado: "" (vacío).
righty_max
Unidades (tipo) 0 lefty_units 0 - (predeterminado) Automático;
1 - Estático.
righty_units
Unidades (valor) 1 lefty_static_units Cualquier valor de cadena.

Predeterminado: "" (vacío).
righty_static_units
Eje X 0 xaxis 0 - Deshabilitado;
1 - (predeterminado) Habilitado.

Leyenda

Los siguientes parámetros son compatibles para configurar Legend.

Parámetro tipo nombre valor
Mostrar leyenda 0 legend 0 - Deshabilitado;
1 - (predeterminado) Habilitado.
Número de filas 0 legend_lines Los valores válidos oscilan entre 1 y 5.

Predeterminado: 1.

Problemas

Los siguientes parámetros son compatibles para configurar Problemas.

Parámetro tipo nombre valor
Mostrar problemas 0 show_problems 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Solo métricas seleccionadas 0 graph_item_problems 0 - Deshabilitado;
1 - (predeterminado) Habilitado.
Equipos con problemas 1 problemhosts.0 Nombre de equipo.

Nota: El número en el nombre de la propiedad hace referencia al equipo configurado.
Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo.
Gravedad 0 severities 0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;
4 - Alto;
5 - Desastre .

Predeterminado: vacío (todo habilitado).

Nota: para configurar múltiples valores, cree un objeto de campo de widget de panel para cada valor.
Problema 1 problem_name Nombre del evento del problema (no distingue entre mayúsculas y minúsculas, nombre completo o parte del mismo).
Etiquetas (el número en el nombre de la propiedad (por ejemplo, tags.tag.0) hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas)
Tipo de evaluación 0 evaltype 0 - (predeterminado) Y/O;
2 - O.
Nombre de etiqueta 1 tags.tag.0 Cualquier valor de cadena.

Parámetro Nombre de etiqueta requerido si se configuran Etiquetas.
Operador 0 tags.operator.0 0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.

Parámetro Operador requerido si se configuran Etiquetas.
Valor de etiqueta 1 tags.value.0 Cualquier valor de cadena.

Parámetro Valor de etiqueta requerido si se configuran Etiquetas.

Anulaciones

Los siguientes parámetros son compatibles para configurar Anulaciones.

El primer número en el nombre de la propiedad (por ejemplo, or.hosts.0.0 or.items.0.0) representa el conjunto de datos particular, mientras que el segundo número, si está presente, representa el equipo o métrica configurada.

Parámetro tipo nombre valor
Patrón de equipo
(obligatorio)
1 or.hosts.0.0 Nombre o patrón de equipo (por ejemplo, Zabbix*).
Patrón de métrica
(obligatorio)
1 or.items.0.0 Nombre o patrón de métrica (por ejemplo, *: Número de procesados *valores por segundo).
Color base 1 or.color.0 Código de color hexadecimal (por ejemplo, FF0000).
Ancho 0 or.width.0 Los valores válidos oscilan entre 1 y 10.
Dibujo 0 or.type.0 0 - Línea;
1 - Puntos;
2 - Escalera;
3 - Barra.
Transparencia 0 or.transparency.0 Los valores válidos oscilan entre 1 y 10.
Relleno 0 or.fill.0 Los valores válidos oscilan entre 1 y 10.
Tamaño de punto 0 or.pointsize.0 Los valores válidos oscilan entre 1 y 10.
Datos faltantes 0 or.missingdatafunc.0 0 - Ninguno;
1 - Conectado;
2 - Tratar como 0.
Eje Y 0 or.axisy.0 0 - Izquierda;
1 - Derecha.
Desplazamiento 1 or.timeshift.0 Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo. Se permiten valores negativos.

Ejemplos

Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del dashboard para el widget Graph. Para obtener más información sobre la configuración de un dashboard, consulte dashboard.create.

Configuración de un widget Gráfico

Configure un widget Gráfico de la siguiente manera:

  • 4 conjuntos de datos para un total de 9 métricas en 1 equipo.
  • Cada conjunto de datos consta de una línea que tiene un color, ancho, transparencia y relleno personalizados.
  • El conjunto de datos 4 tiene una agregación configurada.
  • Los datos del gráfico se muestran durante un período de tiempo de las últimas 3 horas.
  • Los problemas en el gráfico se muestran solo para las métricas configuradas.
  • El gráfico tiene dos ejes Y, de los cuales el eje Y derecho muestra valores solo para el conjunto de datos 4.
  • La leyenda del gráfico muestra las métricas configuradas en 2 filas.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "svggraph",
                               "name": "Graph",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 1,
                                       "name": "ds.hosts.0.0",
                                       "value": "Zabbix server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.items.0.0",
                                       "value": "Zabbix server: Utilization of poller data collector processes, in %"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.color.0",
                                       "value": "FF0000"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.width.0",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.transparency.0",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.fill.0",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.hosts.1.0",
                                       "value": "Zabbix server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.items.1.0",
                                       "value": "Zabbix server: Utilization of trapper data collector processes, in %"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.color.1",
                                       "value": "BF00FF"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.width.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.transparency.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.fill.1",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.hosts.2.0",
                                       "value": "Zabbix server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.items.2.0",
                                       "value": "Zabbix server: Utilization of history syncer internal processes, in %"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.color.2",
                                       "value": "0040FF"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.width.2",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.transparency.2",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.fill.2",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.hosts.3.0",
                                       "value": "Zabbix server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.items.3.0",
                                       "value": "*: Number of processed *values per second"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.color.3",
                                       "value": "000000"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.transparency.3",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.fill.3",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.axisy.3",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.aggregate_function.3",
                                       "value": 3
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.aggregate_interval.3",
                                       "value": "1m"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.aggregate_grouping.3",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "graph_time",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "time_from",
                                       "value": "now-3h"
                                   },
                                   {
                                       "type": 0,
                                       "name": "legend_lines",
                                       "value": 2
                                   },
                                   {
                                       "type": 0,
                                       "name": "show_problems",
                                       "value": 1
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también