Documentation
Table of Contents
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.
Configuring a Graph widget
Configure a Graph widget in the following way:
- 4 data sets for a total of 9 items on 1 host.
- Each data set consists of a line that has a custom color, width, transparency, and fill.
- Data set 4 has a configured aggregation.
- Data in the graph are displayed for a time period of the last 3 hours.
- Problems in the graph are displayed only for the configured items.
- Graph has two Y axes of which the right Y axis displays values only for Data set 4.
- Graph legend displays configured items in 2 rows.
Request:
{
"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
}Response: