Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

9 Gráfico

Descripción

Estos parámetros y los valores posibles de propiedad para los objetos de campo del widget del tablero respectivo 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 los widgets integrados y crear widgets personalizados, 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 descrito en las tablas siguientes.

Parámetros

Los siguientes parámetros son compatibles con el widget Graph.

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.
Referencia 1 reference Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del tablero al que pertenece el widget.

Comportamiento del parámetro:
- requerido

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.0.hosts.0, ds.0.items.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
Tipo de conjunto de datos 0 ds.0.dataset_type 0 - Lista de métricas;
1 - (predeterminado) Patrones de métricas.
Items 4 ds.0.itemids.0 ID de métrica.

Al configurar el widget en una plantilla de tablero, solo se deben configurar las métricas configuradas en la plantilla.

Nota: Para configurar varias métricas, cree un objeto de campo de widget de tablero para cada métrica con un número incrementado en el nombre de la propiedad.

Comportamiento del parámetro:
- obligatorio si Tipo de conjunto de datos está establecido en "Lista de métricas"
Color 1 ds.0.color.0 Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento de parámetros:
- obligatorio si Tipo de conjunto de datos está configurado en "Lista de métricas"
Patrones de equipo 1 ds.0.hosts.0 Nombre o patrón de equipo (por ejemplo, "Zabbix*").
< br>Comportamiento del parámetro:
- obligatorio si Tipo de conjunto de datos está configurado en "Patrones de métricas"

Este parámetro no es compatible si configura el widget en una plantilla de tablero.
Patrones de métricas 1 ds.0.items.0 Nombre o patrón de métrica (por ejemplo, "*: Número de *valores procesados por second").

Al configurar el widget en una plantilla de tablero, solo se deben configurar los patrones para las métricas configuradas en la plantilla.
< br>Comportamiento de parámetros:
- obligatorio si Tipo de conjunto de datos está configurado en "Patrones de métricas"
Color 1 ds.0.color Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: FF465C.

Comportamiento de parámetros:
- compatible si Tipo de conjunto de datos está establecido en "Patrones de métricas"
Dibujar 0 ds.0.type 0 - (predeterminado) Línea;
1 - Puntos;
2 - Escalera;
3 - Barra.
Apilado 0 ds.0.stacked 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Dibujo está configurado en "Línea", "Escalera" o "Bar"
Ancho 0 ds.0.width Los valores posibles oscilan entre 1 y 10.

Predeterminado: 1.

Comportamiento del parámetro:
- compatible si Dibujo está configurado en "Línea" o "Escalera"
Tamaño de punto 0 ds.0.pointsize Los valores posibles oscilan entre 1 y 10.

Predeterminado: 3.

Comportamiento del parámetro:
- compatible si Dibujo está configurado en "Puntos"
Transparencia 0 ds.0.transparency Los valores posibles oscilan entre 1 y 10.

Predeterminado: 5.
Fill 0 ds.0.fill Los valores posibles oscilan entre 1 y 10.

Predeterminado: 3.

Comportamiento de parámetros:
- compatible si Dibujo está configurado en "Línea" o "Escalera"
Datos faltantes 0 ds.0.missingdatafunc 0 - (predeterminado) Ninguno;
1 - Conectado;
2 - Tratar como 0;
3 - Último conocido.< br>
Comportamiento de parámetros:
- compatible si Dibujo está configurado en "Línea" o "Escalera"
Eje Y 0 ds.0.axisy 0 - (predeterminado) Izquierda;
1 - Derecha.
Timeshift 1 ds.0.timeshift 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.0.aggregate_function 0 - (predeterminado) no utilizado;
1 - min;
2 - max;
3 - avg;
4 - contar;
5 - suma;
6 - primero;
7 - último.
Intervalo de agregación 1 ds.0.aggregate_interval Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo.

Predeterminado: 1h.
Agregado 0 ds.0.aggregate_grouping 0 - (predeterminado) Cada elemento;
1 - Conjunto de datos.

Comportamiento de parámetros:
- compatible si la Función de agregación está configurada en "min", "max", "avg", "count", "sum", "first" o "last"
Aproximación 0 ds.0.approximation 1 - min;
2 - (predeterminado) avg;
4 - max;
7 - todos.
Etiqueta del conjunto de datos 1 ds.0.data_set_label Cualquier valor de cadena.

Predeterminado: "" (vacío).

Opciones de pantalla

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.
Disparadores simples 0 simple_triggers 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Tiempo de trabajo 0 working_time 0 - (predeterminado) Deshabilitado;
1 - Habilitado.
Línea percentil (izquierda)
Estado 0 percentile_left 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si el eje Y (en la configuración de conjunto de datos) está configurado en "Izquierda"
Valor 0 percentile_left_value Los valores posibles oscilan entre 1 y 100.

Comportamiento del parámetro:
- compatible si Eje Y (en la configuración Conjunto de datos) está establecido en "Izquierda"
Línea percentil (derecha)
Estado 0 percentile_right 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si el eje Y (en la configuración de conjunto de datos) está configurado en "Derecha"
Valor 0 percentile_right_value Los valores posibles oscilan entre 1 y 100.

Comportamiento del parámetro:
- compatible si Eje Y (en la configuración Conjunto de datos) está establecido en "Derecha"

Periodo de tiempo

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

Parámetro tipo nombre valor
Período de tiempo 1 time_period._reference DASHBOARD._timeperiod - establece el selector de período de tiempo como fuente de datos.
ABCDE._timeperiod - establece un widget compatible (Gráfico, Gráfico (classic) o Prototipo de Gráfico con su parámetro Reference establecido en "ABCDE") como fuente de datos.

Predeterminado: DASHBOARD._timeperiod

Alternativamente, puede establecer el período de tiempo solo en los parámetros Desde y Hasta.
Desde 1 time_period.from Cadena de tiempo válida en sintaxis de tiempo absoluta (AAAA-MM-DD hh:mm:ss) o relativa (ahora, now/d, now/w-1w, etc.).

Comportamiento de parámetros:
- compatible si Hora período no está establecido
Hasta 1 time_period.to Cadena de hora válida en sintaxis de hora absoluta (AAAA-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento de parámetros:
- compatible si Hora período no está establecido

Ejes

Los siguientes parámetros son compatibles para configurar Ejes.

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

Comportamiento de parámetros:< br>- compatible si el eje Y (en la configuración de conjunto de datos) está configurado en "Izquierda"
Derecha Y 0 righty 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:< br>- compatible si el eje Y (en la configuración de conjunto de datos) está configurado en "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.

Comportamiento del parámetro:< br>- compatible si Mostrar leyenda está configurado en "Activado"
Mostrar min/avg/max 0 legend_statistic 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Mostrar leyenda está configurado en "Habilitado"
Mostrar función de agregación 0 legend_aggregation 0 - (predeterminado) Deshabilitado;
1 - Habilitado.

Comportamiento de parámetros:
- compatible si Mostrar leyenda está configurado en "Activado"
Filas 0 legend_lines_mode 0 - (predeterminado) Fijo;
1 - Variable.

Comportamiento del parámetro:<br >- compatible si Mostrar leyenda está configurado en "Activado"
Número de filas/
Número máximo de filas
0 legend_lines Los valores posibles oscilan entre 1 y 10.

Predeterminado: 1.

Comportamiento del parámetro:
- compatible si Mostrar leyenda está configurado en "Habilitado"
Número de columnas 0 legend_columns Los valores posibles oscilan entre 1 y 4.

Predeterminado: 4.

Comportamiento de parámetros:
- compatible si Mostrar leyenda está configurado en "Activado" y Mostrar min/avg/max está configurado en "Desactivado"

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 problemáticos 1 problemhosts.0 Host nombre.

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 tablero para cada equipo con un número incrementado en el nombre de la propiedad.

Este parámetro no se admite si se configura el widget en una plantilla de tablero.
Gravedad 0 severities.0 0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;
4 - Alto;
5 - Desastre.

Valor predeterminado: vacío (todo habilitado).

Nota: para configurar varios valores, cree un objeto de campo del widget del tablero para cada valor con un número incrementado en el nombre de la propiedad.
Problema 1 problem_name Problema nombre del evento (no distingue entre mayúsculas y minúsculas, nombre completo o parte del mismo).
Etiquetas de problema
Tipo de evaluación 0 evaltype 0 - (predeterminado) Y/O;
2 - O.
Nombre de etiqueta 1 tags.0.tag Cualquier valor de cadena.

Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.

Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de problema
Operador 0 tags.0.operator 0 - Contiene;
1 - Es igual;
2 - No contiene;
3 - No es igual;
4 - Existe ;
5 - No existe.

Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.

Comportamiento del parámetro:
- obligatorio si se configuran Etiquetas de problema
Valor de etiqueta 1 tags.0.value Cualquier valor de cadena.

Nota: El número en el nombre de la propiedad hace referencia al orden de las etiquetas en la lista de evaluación de etiquetas.

Comportamiento de parámetros:
- obligatorio si se configuran Etiquetas de problema

Anulaciones

Los siguientes parámetros son compatibles para configurar Anulaciones.

El primer número en el nombre de la propiedad (por ejemplo, or.0.hosts.0 o.0.items.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
Patrones de equipo 1 or.0.hosts.0 Nombre o patrón de equipo (por ejemplo, Zabbix*).

Parámetro * Patrones de equipo* no disponibles al configurar el widget en una plantilla de tablero.

Comportamiento de parámetros :
- obligatorio si se configuran Anulaciones
Patrones de métricas 1 or.0.items.0 Nombre o patrón de métrica (por ejemplo, *: Número de *valores procesados por segundo).< br>Al configurar el widget en una plantilla de tablero, solo se deben configurar los patrones para los elementos configurados en la plantilla.

Comportamiento de parámetros:
- obligatorio si se configuran Anulaciones
Color base 1 or.0.color Código de color hexadecimal (por ejemplo, FF0000).
Ancho 0 or.0.width Los valores posibles oscilan entre 1 y 10.
Dibujar 0 or.0.type 0 - Línea;
1 - Puntos;
2 - Escalera;
3 - Barra.
Transparencia 0 or.0.transparency Los valores posibles oscilan entre 1 y 10.
Relleno 0 or.0.fill Los valores posibles oscilan entre 1 y 10.
Tamaño de punto 0 or.0.pointsize Los valores posibles oscilan entre 1 y 10.
Datos faltantes 0 or.0.missingdatafunc 0 - Ninguno;
1 - Conectado;
2 - Tratar como 0;
3 - Último conocido.
Eje Y 0 or.0.axisy 0 - Izquierda;
1 - Derecha.
Timeshift 1 or.0.timeshift 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:

  • 2 conjuntos de datos para un total de 9 métricas en 1 equipo.
  • El primer conjunto de datos es del tipo "Lista de métricas" y consta de 3 métricas que están representadas por líneas de diferente color, pero del mismo ancho, transparencia y relleno.
  • El segundo conjunto de datos es del tipo "Patrón de métricas", consta de 6 métricas, tiene una agregación configurada y está representado por una línea con un color, ancho, transparencia y relleno personalizados.
  • El segundo conjunto de datos también tiene una etiqueta de conjunto de datos personalizada.
  • 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 segundo conjunto de datos.
  • La leyenda del gráfico muestra las métricas configuradas en 4 filas, así como los valores mínimo, máximo y promedio de los conjuntos de datos.

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": 36,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 0,
                                       "name": "ds.0.dataset_type",
                                       "value": 0
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.1",
                                       "value": 23264
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.1",
                                       "value": "FF0000"
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.2",
                                       "value": 23269
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.2",
                                       "value": "BF00FF"
                                   },
                                   {
                                       "type": 4,
                                       "name": "ds.0.itemids.3",
                                       "value": 23257
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.0.color.3",
                                       "value": "0040FF"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.width",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.transparency",
                                       "value": 3
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.0.fill",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.hosts.0",
                                       "value": "Zabbix server"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.items.0",
                                       "value": "*: Number of processed *values per second"
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.color",
                                       "value": "000000"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.transparency",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.fill",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.axisy",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.aggregate_function",
                                       "value": 3
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.aggregate_interval",
                                       "value": "1m"
                                   },
                                   {
                                       "type": 0,
                                       "name": "ds.1.aggregate_grouping",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "ds.1.data_set_label",
                                       "value": "Number of processed values per second"
                                   },
                                   {
                                       "type": 0,
                                       "name": "graph_time",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "time_period.from",
                                       "value": "now-3h"
                                   },
                                   {
                                       "type": 0,
                                       "name": "legend_statistic",
                                       "value": 1
                                   },
                                   {
                                       "type": 0,
                                       "name": "legend_lines",
                                       "value": 4
                                   },
                                   {
                                       "type": 0,
                                       "name": "show_problems",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "reference",
                                       "value": "YZABC"
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Ver también

-Campo de widget de dashboard -dashboard.create -dashboard.update