Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Esta página fue traducida automáticamente. Si detectas un error, selecciónalo y presiona Ctrl+Enter para informarlo a los editores.

8 Gráfico

Descripción

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

Las propiedades fields del widget no se validan durante la creación o actualización de un panel. Esto permite a los usuarios modificar 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 a continuación.

Parámetros

Los siguientes parámetros son compatibles para el widget de 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 - (por defecto) 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.
Referencia 1 reference Cualquier valor de cadena que consista en 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del panel al que pertenece el widget.

Comportamiento del parámetro:
- obligatorio

Conjunto de datos

Se admiten los siguientes parámetros 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 en particular, mientras que el segundo número, si está presente, representa el equipo o la métrica configurados.

Parámetro tipo nombre valor
Tipo de conjunto de datos 0 ds.0.dataset_type 0 - Lista de métricas;
1 - (por defecto) Patrones de métricas.
Métricas 4 ds.0.itemids.0 ID de la Métrica.

Al configurar el widget en un dashboard de plantilla, solo deben establecerse las métricas configuradas en la plantilla.

Nota: Para configurar varias métricas, cree un objeto de campo de widget de dashboard 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" y Métricas (Widget) no está establecido
Métricas (Widget) 1 ds.0.itemids.0._reference En lugar del ID de la Métrica:
ABCDE._itemid - establezca un widget compatible (con su parámetro Referencia establecido en "ABCDE") como fuente de datos para las métricas.

Nota: Para configurar varios widgets, cree un objeto de campo de widget de dashboard para cada widget 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" y Métricas no está establecido
Color 1 ds.0.color.0 Código de color hexadecimal (por ejemplo, FF0000).

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

Comportamiento del parámetro:
- obligatorio si Tipo de conjunto de datos está establecido en "Patrones de métricas"

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

Al configurar el widget en un dashboard de plantilla, solo deben establecerse los patrones para las métricas configuradas en la plantilla.

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

Por defecto: FF465C.

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

Comportamiento del parámetro:
- compatible si Dibujo está establecido en "Línea", "Escalera" o "Barra"
Ancho 0 ds.0.width Los valores posibles van de 1-10.

Por defecto: 1.

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

Por defecto: 3.

Comportamiento del parámetro:
- compatible si Dibujo está establecido en "Puntos"
Transparencia 0 ds.0.transparency Los valores posibles van de 1-10.

Por defecto: 5.
Relleno 0 ds.0.fill Los valores posibles van de 1-10.

Por defecto: 3.

Comportamiento del parámetro:
- compatible si Dibujo está establecido en "Línea" o "Escalera"
Datos faltantes 0 ds.0.missingdatafunc 0 - (por defecto) Ninguno;
1 - Conectado;
2 - Tratar como 0;
3 - Último conocido.

Comportamiento del parámetro:
- compatible si Dibujo está establecido en "Línea" o "Escalera"
Sobrescribir equipo 1 ds.0.override_hostid._reference ABCDE._hostid- establezca un widget compatible (con su parámetro "Referencia" establecido en "ABCDE") como fuente de datos para los equipos;
DASHBOARD._hostid - establezca el selector de Equipo del dashboard como fuente de datos para los equipos.

Este parámetro no es compatible si se configura el widget en un dashboard de plantilla.
Eje Y 0 ds.0.axisy 0 - (por defecto) Izquierda;
1 - Derecha.
Desplazamiento de tiempo 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.

Por defecto: "" (vacío).
Función de agregación 0 ds.0.aggregate_function 0 - (por defecto) no usado;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Intervalo de agregación 1 ds.0.aggregate_interval Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo.

Por defecto: 1h.
Agrupar 0 ds.0.aggregate_grouping 0 - (por defecto) Cada métrica;
1 - Conjunto de datos.

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

Por defecto: "" (vacío).

Opciones de visualización

Se admiten los siguientes parámetros para configurar las Opciones de visualización.

Parámetro tipo nombre valor
Selección de datos históricos 0 source 0 - (por defecto) Automático;
1 - Historial;
2 - Tendencias.
Disparadores simples 0 simple_triggers 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Tiempo de trabajo 0 working_time 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Línea percentil (izquierda)
Estado 0 percentile_left 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si el Eje Y (en la configuración del Conjunto de datos) está establecido en "Izquierda"
Valor 0 percentile_left_value El rango de valores posibles es de 1-100.

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

Comportamiento del parámetro:
- soportado si el Eje Y (en la configuración del Conjunto de datos) está establecido en "Derecha"
Valor 0 percentile_right_value El rango de valores posibles es de 1-100.

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

Período de tiempo

Se admiten los siguientes parámetros para configurar el 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 (con su parámetro Referencia configurado en "ABCDE") como fuente de datos.

Por defecto: 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 absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento del parámetro:
- admitido si Período de tiempo no está establecido
Hasta 1 time_period.to Cadena de tiempo válida en sintaxis absoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, etc.).

Comportamiento del parámetro:
- admitido si Período de tiempo no está establecido

Ejes

Se admiten los siguientes parámetros para configurar los Ejes.

Parámetro tipo nombre valor
Y izquierdo 0 lefty 0 - Deshabilitado;
1 - (por defecto) Habilitado.

Comportamiento del parámetro:
- soportado si el Eje Y (en la configuración del Conjunto de datos) está establecido en "Izquierda"
Y derecho 0 righty 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si el Eje Y (en la configuración del Conjunto de datos) está establecido en "Derecha"
Escala 0 lefty_scale 0 - (por defecto) Lineal;
1 - Logarítmica.
righty_scale
Mín 1 lefty_min Cualquier valor numérico.

Por defecto: "" (vacío).
righty_min
Máx 1 lefty_max Cualquier valor numérico.

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

Por defecto: "" (vacío).
righty_static_units
Eje X 0 xaxis 0 - Deshabilitado;
1 - (por defecto) Habilitado.

Leyenda

Los siguientes parámetros son compatibles para configurar la Leyenda.

Parámetro tipo nombre valor
Mostrar leyenda 0 legend 0 - Deshabilitado;
1 - (por defecto) Habilitado.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado"
Mostrar min/prom/max 0 legend_statistic 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado"
Mostrar función de agregación 0 legend_aggregation 0 - (por defecto) Deshabilitado;
1 - Habilitado.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado"
Filas 0 legend_lines_mode 0 - (por defecto) Fijo;
1 - Variable.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado"
Número de filas/
Número máximo de filas
0 legend_lines Los valores posibles van de 1-10.

Por defecto: 1.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado"
Número de columnas 0 legend_columns Los valores posibles van de 1-4.

Por defecto: 4.

Comportamiento del parámetro:
- soportado si Mostrar leyenda está configurado como "Habilitado" y Mostrar min/prom/max está configurado como "Deshabilitado"

Problemas

Los siguientes parámetros son compatibles para configurar Problemas.

Parámetro tipo nombre valor
Mostrar problemas 0 show_problems 0 - (por defecto) Deshabilitado;
1 - Habilitado.
Solo métricas seleccionadas 0 graph_item_problems 0 - Deshabilitado;
1 - (por defecto) Habilitado.
Equipos con problemas 1 problemhosts.0 Nombre del 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 con un número incrementado en el nombre de la propiedad.

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Severidad 0 severities.0 0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Media;
4 - Alta;
5 - Desastre.

Por defecto: vacío (todas habilitadas).

Nota: Para configurar varios valores, cree un objeto de campo de widget de panel para cada valor con un número incrementado en el nombre de la propiedad.
Problema 1 problem_name Nombre del evento del problema (no distingue mayúsculas/minúsculas, nombre completo o parte de él).
Etiquetas de problema
Tipo de evaluación 0 evaltype 0 - (por defecto) 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 la etiqueta en la lista de evaluación de etiquetas.

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

Nota: El número en el nombre de la propiedad hace referencia al orden de la etiqueta 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 la etiqueta en la lista de evaluación de etiquetas.

Comportamiento del parámetro:
- 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, or.0.items.0) representa el conjunto de datos particular, mientras que el segundo número, si está presente, representa el equipo o la métrica configurados.

Parámetro tipo nombre valor
Patrones de equipo 1 or.0.hosts.0 Nombre o patrón de equipo (por ejemplo, Zabbix*).

Este parámetro no es compatible si se configura el widget en un panel de plantilla.

Comportamiento del parámetro:
- obligatorio si se configuran Anulaciones
Patrones de métrica 1 or.0.items.0 Nombre o patrón de métrica (por ejemplo, *: Número de valores procesados por segundo).
Al configurar el widget en un panel de plantilla, solo deben establecerse los patrones para las métricas configuradas en la plantilla.

Comportamiento del parámetro:
- 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 van de 1-10.
Dibujar 0 or.0.type 0 - Línea;
1 - Puntos;
2 - Escalera;
3 - Barra.
Transparencia 0 or.0.transparency Los valores posibles van de 1-10.
Relleno 0 or.0.fill Los valores posibles van de 1-10.
Tamaño del punto 0 or.0.pointsize Los valores posibles van de 1-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.
Desplazamiento de tiempo 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 tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget Gráfico. Para obtener más información sobre la configuración de un panel, 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 de tipo "Lista de métricas" y consta de 3 métricas que se representan mediante líneas con diferente color, pero con el mismo grosor, transparencia y relleno.
  • El segundo conjunto de datos es de tipo "Patrones de métricas", consta de 6 métricas, tiene una agregación configurada y se representa mediante una línea con color, grosor, transparencia y relleno personalizados.
  • El segundo conjunto de datos también tiene una etiqueta de conjunto de datos personalizada.
  • Los datos en el gráfico se muestran para 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
       }

Véase también