Table of Contents
25 Gráfico de dispersión
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de dashboard permiten configurar el widget Gráfico de dispersión 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 dashboard. 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 de dispersión, consulte el comportamiento de los parámetros que se describe en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Gráfico de dispersión.
| 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 dashboard 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 host o item configurado.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Tipo de conjunto de datos | 0 | ds.0.dataset_type | 0 - Lista de items; 1 - (por defecto) Patrones de items. |
|
| Conjunto de datos: Lista de items | ||||
| Color | 1 | ds.0.color.0 | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Lista de items" |
|
| Eje X | 4 | ds.0.x_axis_itemids.0 | ID del item. Al configurar el widget en un dashboard de template, solo se deben establecer los items configurados en el template. Nota: Para configurar varios items, cree un objeto de campo de widget de dashboard para cada item con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Lista de items" y Eje X (Widget) no está configurado |
|
| Eje X (Widget) | 1 | ds.0.x_axis_itemids.0._reference | En lugar del ID del item:ABCDE._itemid - establezca un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos para los items.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: - requerido si Tipo de conjunto de datos está configurado como "Lista de items" y Eje X no está configurado |
|
| Eje Y | 4 | ds.0.y_axis_itemids.0 | ID del item. Al configurar el widget en un dashboard de template, solo se deben establecer los items configurados en el template. Nota: Para configurar varios items, cree un objeto de campo de widget de dashboard para cada item con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Lista de items" y Eje Y (Widget) no está configurado |
|
| Eje Y (Widget) | 1 | ds.0.y_axis_itemids.0._reference | En lugar del ID del item:ABCDE._itemid - establezca un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos para los items.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: - requerido si Tipo de conjunto de datos está configurado como "Lista de items" y Eje Y no está configurado |
|
| Sobrescribir host | 1 | ds.0.override_hostid._reference | ABCDE._hostid- establezca un widget compatible (con su parámetro "Referencia" configurado como "ABCDE") como fuente de datos para los hosts;DASHBOARD._hostid - establezca el selector de host del dashboard como fuente de datos para los hosts.Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Conjunto de datos: Patrones de items | ||||
| Color | 1 | ds.0.color | Código de color hexadecimal (por ejemplo, FF0000).Comportamiento del parámetro: - soportado si Tipo de conjunto de datos está configurado como "Patrones de items" y Paleta de colores no está configurada |
|
| Paleta de colores | 0 | ds.0.color_palette | Índice de la paleta de colores. Valores posibles: 0-11. Por defecto: 0. Comportamiento del parámetro: - soportado si Tipo de conjunto de datos está configurado como "Patrones de items" y Color no está configurado |
|
| Patrones de host | 1 | ds.0.hosts.0 | Nombre o patrón del host (por ejemplo, "Zabbix*"). Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Patrones de items" Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Patrones de items del eje X | 1 | ds.0.x_axis_items.0 | Nombre o patrón del item (por ejemplo, "*: Número de valores procesados por segundo"). Al configurar el widget en un dashboard de template, solo se deben establecer los patrones para los items configurados en el template. Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Patrones de items" |
|
| Patrones de items del eje Y | 1 | ds.0.y_axis_items.0 | Nombre o patrón del item (por ejemplo, "*: Número de valores procesados por segundo"). Al configurar el widget en un dashboard de template, solo se deben establecer los patrones para los items configurados en el template. Comportamiento del parámetro: - requerido si Tipo de conjunto de datos está configurado como "Patrones de items" |
|
| Grupos de hosts | 2 | groupids.0 | ID del grupo de hosts. Nota: Para configurar varios grupos de hosts, cree un objeto de campo de widget de dashboard para cada grupo de hosts con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Grupos de hosts (Widget) | 1 | groupids._reference | En lugar del ID del grupo de hosts:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Referencia configurado como "ABCDE") como fuente de datos para los grupos de hosts.Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Sobrescribir host | 1 | ds.0.override_hostid._reference | ABCDE._hostid- establezca un widget compatible (con su parámetro "Referencia" configurado como "ABCDE") como fuente de datos para los hosts;DASHBOARD._hostid - establezca el selector de host del dashboard como fuente de datos para los hosts.Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Etiquetas de host | ||||
| Tipo de evaluación | 0 | evaltype_host | 0 - (por defecto) Y/O; 2 - O. Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Nombre de etiqueta | 1 | host_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: - requerido si se configuran Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Operador | 0 | host_tags.0.operator | 0 - Contiene; 1 - Igual; 2 - No contiene; 3 - No igual; 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: - requerido si se configuran Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Valor de etiqueta | 1 | host_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: - requerido si se configuran Etiquetas de host Este parámetro no es compatible si se configura el widget en un dashboard de template. |
|
| Marcador | 0 | ds.0.marker | 0 - (por defecto) Elipse; 1 - Cuadrado; 2 - Triángulo; 3 - Diamante; 4 - Estrella; 5 - Cruz. |
|
| Tamaño del marcador | 0 | ds.0.marker_size | 0 - (por defecto) Pequeño (6px); 1 - Mediano (9px); 2 - Grande (15px). |
|
| Desplazamiento de tiempo | 1 | ds.0.timeshift | Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).Puede utilizar sufijos de tiempo. También se permiten valores negativos. Por defecto: "" (vacío). |
|
| Intervalo de agregación | 1 | ds.0.aggregate_interval | Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).Puede utilizar sufijos de tiempo. Por defecto: 15m. |
|
| Función de agregación | 0 | ds.0.aggregate_function | 0 - no se utiliza; 1 - min; 2 - max; 3 - (por defecto) avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
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. |
Periodo de tiempo
Se admiten los siguientes parámetros para configurar el Periodo de tiempo.
| Parámetro | tipo | nombre | valor | |
|---|---|---|---|---|
| Periodo de tiempo | 1 | time_period._reference | DASHBOARD._timeperiod - establece el selector de periodo de tiempo del dashboard 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._timeperiodAlternativamente, puede establecer el periodo 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 Periodo 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 Periodo de tiempo no está establecido |
|
Ejes
Se admiten los siguientes parámetros para configurar los Ejes.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Eje X | 0 | x_axis | 0 - Deshabilitado; 1 - (por defecto) Habilitado. |
| Eje Y | 0 | y_axis | 0 - (por defecto) Deshabilitado; 1 - Habilitado. |
| Mín | 1 | x_axis_min | Cualquier valor numérico. Por defecto: "" (vacío). |
| y_axis_min | |||
| Máx | 1 | x_axis_max | Cualquier valor numérico. Por defecto: "" (vacío). |
| y_axis_max | |||
| Unidades (tipo) | 0 | x_axis_units | 0 - (por defecto) Auto; 1 - Estático. |
| y_axis_units | |||
| Unidades (valor) | 1 | x_axis_static_units | Cualquier valor de cadena. Por defecto: "" (vacío). |
| y_axis_static_units |
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. |
| 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 | Rango de valores posibles: 1-10. Por defecto: 1. Comportamiento del parámetro: - soportado si Mostrar leyenda está configurado como "Habilitado" |
| Número de columnas | 0 | legend_columns | Rango de valores posibles: 1-4. Por defecto: 4. Comportamiento del parámetro: - soportado si Mostrar leyenda está configurado como "Habilitado" |
Umbrales
Se admiten los siguientes parámetros para configurar los Umbrales.
El número en el nombre de la propiedad Thresholds (por ejemplo, thresholds.0.color) hace referencia a la posición del umbral en una lista, ordenada en orden ascendente. Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenarán en orden ascendente después de actualizar la configuración del widget en el frontend de Zabbix (por ejemplo, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Interpolación de color | 0 | interpolation | 0 - (por defecto) Deshabilitado; 1 - Habilitado. |
| Color | 1 | thresholds.0.color | Código de color hexadecimal (por ejemplo, FF0000). |
| Eje X | 1 | thresholds.0.x_axis_threshold | Cualquier valor numérico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). |
| Eje Y | 1 | thresholds.0.y_axis_threshold | Cualquier valor numérico. Se admiten Sufijos (por ejemplo, "1d", "2w", "4K", "8G"). |
Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget para el widget Gráfico de dispersión. Para obtener más información sobre la configuración de un dashboard, consulte dashboard.create.
Configuración de un widget Gráfico de dispersión
Configure un widget Gráfico de dispersión de la siguiente manera:
- 5 conjuntos de datos de tipo "Patrones de item", cada uno con la agregación predeterminada (avg, 15m) y diferentes marcadores.
- La leyenda muestra los items configurados en una sola fila y dos columnas.
- Los umbrales están configurados para colorear un marcador de rojo cuando su valor alcanza 80 en cualquier eje.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "scatterplot",
"name": "Scatter plot",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.0.color",
"value": "0C5A87"
},
{
"type": 1,
"name": "ds.0.hosts.0",
"value": "de-frankfurt*"
},
{
"type": 1,
"name": "ds.0.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.0.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.0.marker",
"value": 0
},
{
"type": 0,
"name": "ds.0.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.1.color",
"value": "66B0D9"
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "fr-paris*"
},
{
"type": 1,
"name": "ds.1.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.1.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.1.marker",
"value": 1
},
{
"type": 0,
"name": "ds.1.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.2.color",
"value": "0A466A"
},
{
"type": 1,
"name": "ds.2.hosts.0",
"value": "lv-riga*"
},
{
"type": 1,
"name": "ds.2.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.2.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.2.marker",
"value": 2
},
{
"type": 0,
"name": "ds.2.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.3.color",
"value": "3394C3"
},
{
"type": 1,
"name": "ds.3.hosts.0",
"value": "pl-warsaw*"
},
{
"type": 1,
"name": "ds.3.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.3.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.3.marker",
"value": 3
},
{
"type": 0,
"name": "ds.3.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.4.color",
"value": "1492C8"
},
{
"type": 1,
"name": "ds.4.hosts.0",
"value": "se-stockholm*"
},
{
"type": 1,
"name": "ds.4.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.4.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.4.marker",
"value": 4
},
{
"type": 0,
"name": "ds.4.marker_size",
"value": 1
},
{
"type": 0,
"name": "legend_columns",
"value": 2
},
{
"type": 0,
"name": "interpolation",
"value": 1
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.0.x_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "thresholds.0.y_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.1.x_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.y_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "reference",
"value": "JQISY"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Respuesta: