Documentation
Table of Contents
8 Gráficos
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 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 | |
|---|---|---|---|---|
| Tipo de conjunto de datos | 0 | ds.dataset_type.0 | 0 - Lista de elementos; 1 - (predeterminado) Patrón de elementos. |
|
| Parámetros si Tipo de conjunto de datos está establecido en "Lista de elementos" | ||||
| Items | 4 | ds.itemids.0.0 | Métrica ID. Nota: Para configurar varias métricas, cree un campo de widget de panel objeto para cada métrica. Comportamiento del parámetro: - obligatorio |
|
| Color | 1 | ds.color.0.0 | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento de parámetros:<br >- obligatorio |
|
| Parámetros si Tipo de conjunto de datos está establecido en "Patrón de elemento" | ||||
| Patrón de equipo | 1 | ds.hosts.0.0 | Nombre de equipo o patrón (por ejemplo, "Zabbix*"). Comportamiento de parámetros: - obligatorio |
|
| Patrón de métrica | 1 | ds.items.0.0 | Nombre de métrica o patrón (por ejemplo, "*: Número de *valores procesados por segundo" ). Comportamiento de parámetros: - obligatorio |
|
| Color | 1 | ds.color.0 | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: FF465C. |
|
| Dibujar | 0 | ds.type.0 | 0 - (predeterminado) Línea; 1 - Puntos; 2 - Escalera; 3 - Barra. |
|
| Apilado | 0 | ds.stacked.0 | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. El parámetro Apilado no está disponible si Dibujar está configurado en "Puntos". |
|
| Ancho | 0 | ds.width.0 | Los valores válidos oscilan entre 1 y 10. Predeterminado: 1. El parámetro Ancho no está disponible si Dibujo está establecido 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 Dibuja está configurado 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 Fill no está disponible si Dibujar está establecido en "Puntos" o "Barra". |
|
| Datos faltantes | 0 | ds.missingdatafunc.0 | 0 - (predeterminado) Ninguno; 1 - Conectado; 2 - Tratar como 0; 3 - Último conocido.< br> El parámetro Falta datos no está disponible si Dibujo está configurado en "Puntos" o "Barra". |
|
| Eje Y | 0 | ds.axisy.0 | 0 - (predeterminado) Izquierda; 1 - Derecha. |
|
| Timeshift | 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 - contar; 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. |
|
| Agregar | 0 | ds.aggregate_grouping.0 | 0 - (predeterminado) Cada elemento; 1 - Conjunto de datos. Parámetro Agregar no disponible si Función de agregación está configurado en "ninguno". |
|
| Aproximación | 0 | ds.approximation.0 | 1 - min; 2 - (predeterminado) promedio; 4 - máx; 7 - todos. |
|
| Etiqueta del conjunto de datos | 1 | ds.data_set_label.0 | Cualquier valor de cadena. Predeterminado: "" (vacío). |
|
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. |
|
| Iniciadores simples | 0 | simple_triggers | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Tiempo de trabajo | 0 | working_time | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Línea percentil (izquierda) (parámetro disponible si eje Y (en la configuración del conjunto de datos) está establecido en "Izquierda") | ||||
| Estado | 0 | percentile_left | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Valor | 0 | percentile_left_value | Los valores válidos oscilan entre 1 y 100. | |
| Línea percentil (derecha) (parámetro disponible si eje Y (en la configuración del conjunto de datos) está establecido en "Derecha") | ||||
| Estado | 0 | percentile_right | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Valor | 0 | percentile_right_value | Los valores válidos oscilan entre 1 y 100. | |
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. |
| unidades_derechas | |||
| 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 Leyenda.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Mostrar leyenda | 0 | legend | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
| Mostrar mínimo/máximo/promedio | 0 | legend_statistic | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Número de filas | 0 | legend_lines | Los valores válidos oscilan entre 1 y 10. Predeterminado: 1. |
| Número de columnas | 0 | legend_columns | Los valores válidos oscilan entre 1 y 4. Predeterminado: 4. |
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 probemas | 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 tablero para cada equipo. |
|
| Gravedad | 0 | severities | 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Promedio; 4 - Alto; 5 - Desastre . Predeterminado: vacio (todos habilitados). 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, etiquetas.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. Comportamiento del parámetro: - obligatorio si configura Etiquetas |
|
| Operador | 0 | tags.operator.0 | 0 - Contiene; 1 - Es igual; 2 - No contiene; 3 - No es igual; 4 - Existe ; 5 - No existe. Comportamiento del parámetro: - obligatorio si se configuran Etiquetas |
|
| Valor de etiqueta | 1 | tags.value.0 | Cualquier valor de cadena. Comportamiento del parámetro: - obligatorio si configura 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 o.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 | 1 | or.hosts.0.0 | Nombre de equipo o patrón (por ejemplo, Zabbix*).[Comportamiento de parámetros] (/manual/api/reference_commentary#parameter-behavior): - obligatorio |
| Patrón de métrica | 1 | or.items.0.0 | Nombre de métrica o patrón (por ejemplo, *: Número de *valores procesados por segundo).Comportamiento de parámetros: - obligatorio |
| Color base | 1 | o.color.0 | Código de color hexadecimal (por ejemplo, FF0000). |
| Ancho | 0 | o.width.0 | Los valores válidos oscilan entre 1 y 10. |
| Dibujar | 0 | o.type.0 | 0 - Línea; 1 - Puntos; 2 - Escalera; 3 - Barra. |
| Transparencia | 0 | o.transparency.0 | Los valores válidos oscilan entre 1 y 10. |
| Relleno | 0 | o.fill.0 | Los valores válidos oscilan entre 1 y 10. |
| Tamaño de punto | 0 | o.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; 3 - Último conocido. |
| Eje Y | 0 | o.axisy.0 | 0 - Izquierda; 1 - Derecha. |
| Timeshift | 1 | o.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:
- 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.
{
"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": 0,
"name": "ds.dataset_type.0",
"value": 0
},
{
"type": 4,
"name": "ds.itemids.0.1",
"value": 23264
},
{
"type": 1,
"name": "ds.color.0.1",
"value": "FF0000"
},
{
"type": 4,
"name": "ds.itemids.0.2",
"value": 23269
},
{
"type": 1,
"name": "ds.color.0.2",
"value": "BF00FF"
},
{
"type": 4,
"name": "ds.itemids.0.3",
"value": 23257
},
{
"type": 1,
"name": "ds.color.0.3",
"value": "0040FF"
},
{
"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": "*: Number of processed *values per second"
},
{
"type": 1,
"name": "ds.color.1",
"value": "000000"
},
{
"type": 0,
"name": "ds.transparency.1",
"value": 0
},
{
"type": 0,
"name": "ds.fill.1",
"value": 0
},
{
"type": 0,
"name": "ds.axisy.1",
"value": 1
},
{
"type": 0,
"name": "ds.aggregate_function.1",
"value": 3
},
{
"type": 1,
"name": "ds.aggregate_interval.1",
"value": "1m"
},
{
"type": 0,
"name": "ds.aggregate_grouping.1",
"value": 1
},
{
"type": 1,
"name": "ds.data_set_label.1",
"value": "Number of processed values per second"
},
{
"type": 0,
"name": "graph_time",
"value": 1
},
{
"type": 1,
"name": "time_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
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta:
Ver también
-Campo de widget de dashboard -dashboard.create -dashboard.update