21 Equipos principales

Descripción

Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del panel permiten configurar el widget Top Hosts 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 Equipos principales, consulte el comportamiento de los parámetros que se describen en las tablas siguientes.

Parámetros

Los siguientes parámetros son compatibles con el widget Equipos principales.

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.
Grupos de hosts 2 groupids ID de grupo de equipos.

Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de tablero para cada grupo de equipos.
Equipos 3 hostids ID de equipo.

Nota: Para configurar varios equipos, cree un objeto de campo de widget de tablero para cada equipos . Para varios equipos, el parámetro Grupos de equipos no debe estar configurado en absoluto o configurarse con al menos un grupo de equipos al que pertenecen los equipos configurados.
Etiquetas de equipos (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 de parámetros:
- obligatorio si se configuran Etiquetas
Valor de etiqueta 1 tags.value.0 Cualquier valor de cadena.

Comportamiento del parámetro:
- obligatorio si configura Etiquetas
Columnas (ver más abajo)
Orden 0 order 2 - (predeterminado) N superior;
3 - N inferior.
Columna de orden 0 column Valor numérico de la columna de las columnas configuradas.
Recuento de equipos 0 count Los valores válidos oscilan entre 1 y 100.

Predeterminado: 10.

Columnas

Las columnas tienen parámetros comunes y parámetros adicionales dependiendo de la configuración del parámetro Datos.

::: nota clásica Para todos los parámetros relacionados con columnas, el número en el nombre de la propiedad (por ejemplo, columnas.nombre.0) hace referencia a una columna para la cual está configurado el parámetro. :::

Los siguientes parámetros son compatibles con todas las columnas.

Parámetro tipo nombre valor
Nombre 1 columnas.nombre.0 Cualquier valor de cadena.
Datos 0 columns.data.0 1 - Valor del elemento;
2 - Nombre del equipo;
3 - Texto.

Comportamiento del parámetro:
- obligatorio
Color base 1 columns.base_color.0 Código de color hexadecimal (por ejemplo, FF0000).

Comportamiento de parámetros:
- obligatorio
Valor de la métrica

Los siguientes parámetros son compatibles si Datos se establece en "Valor de la métrica".

El primer número en el nombre de la propiedad Thresholds (por ejemplo, columnsthresholds.color.0.0) hace referencia a la columna para la cual se configuran los umbrales. mientras que el segundo número hace referencia al lugar 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 la interfaz de Zabbix. (por ejemplo, "umbral.umbral.0":"5""umbral.umbral.0":"1"; "umbral.umbral.1":"1""umbral.umbral. 1": "5").

Parámetro tipo nombre valor
Artículo 1 columns.item.0 Nombre de métrica válida.
Timeshift 1 columns.timeshift.0 Valor numérico válido o de cadena de tiempo (por ejemplo, 3600 o 1h).
Puede usar sufijos de tiempo. Se permiten valores negativos.

Comportamiento de parámetros:
- obligatorio
Función de agregación 0 columns.aggregate_function.0 0 - (predeterminado) ninguna;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Intervalo de agregación 1 columns.aggregate_interval.0 Cadena de tiempo válida (por ejemplo, 3600, 1h, etc.).
Puede usar sufijos de tiempo.

Parámetro Intervalo de agregación no disponible si Función de agregación está configurada en ninguna.

Predeterminado: 1h.
Pantalla 0 columns.display.0 1 - (predeterminado) Tal cual;
2 - Barra;
3 - Indicadores.
Min 1 columns.min.0 Cualquier valor numérico.

El parámetro Min no está disponible si Display está configurado en "Tal cual".
Max 1 columns.max.0 Cualquier valor numérico.

El parámetro Max no está disponible si Display está configurado en "Tal cual".
Lugares decimales 0 columns.decimal_places.0 Los valores válidos oscilan entre 0 y 10.

Predeterminado: 2.
Datos del historial 0 columns.history.0 1 - (predeterminado) Automático;
2 - Historial;
3 - Tendencias.
Umbrales
Color 1 columnsthresholds.color.0.0 Código de color hexadecimal (por ejemplo, FF0000).

Predeterminado: "" (vacío).
Umbral 1 columnsthresholds.threshold.0.0 Cualquier valor de cadena.
Texto

Los siguientes parámetros son compatibles si Data está configurado en "Text".

Parámetro tipo nombre valor
Texto 1 columns.text.0 Cualquier valor de cadena, incluidas las macros.
Macros admitidas: {HOST.*}, {INVENTORY.*}.

[Comportamiento de los parámetros] (/manual/api/reference_commentary#parameter-behavior):
- obligatorio si Datos está configurado en "Texto"

Ejemplos

Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Equipos principales. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.

Configuración de un widget Host principales

Configure un widget Hosts principales que muestre los equipos principales por utilización de CPU en el grupo de equipos "4". Además, configure las siguientes columnas personalizadas: "Nombre de equipo", "Utilización de CPU en %", "1m avg", "5m avg ", "15m avg", "Procesos".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "dashboard.create",
           "params": {
               "name": "My dashboard",
               "display_period": 30,
               "auto_start": 1,
               "pages": [
                   {
                       "widgets": [
                           {
                               "type": "tophosts",
                               "name": "Top hosts",
                               "x": 0,
                               "y": 0,
                               "width": 12,
                               "height": 5,
                               "view_mode": 0,
                               "fields": [
                                   {
                                       "type": 2,
                                       "name": "groupids",
                                       "value": 4
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.0",
                                       "value": ""
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.0",
                                       "value": 2
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.0",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.0",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.1",
                                       "value": "CPU utilization in %"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.1",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.1",
                                       "value": "4CAF50"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.1",
                                       "value": "CPU utilization"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.1",
                                       "value": ""
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.display.1",
                                       "value": 3
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.min.1",
                                       "value": "0"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.max.1",
                                       "value": "100"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.0",
                                       "value": "FFFF00"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.0",
                                       "value": "50"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.1",
                                       "value": "FF8000"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.1",
                                       "value": "80"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.color.1.2",
                                       "value": "FF4000"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columnsthresholds.threshold.1.2",
                                       "value": "90"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.2",
                                       "value": "1m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.2",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.2",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.2",
                                       "value": "Load average (1m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.2",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.3",
                                       "value": "5m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.3",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.3",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.3",
                                       "value": "Load average (5m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.3",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.4",
                                       "value": "15m avg"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.4",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.4",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.4",
                                       "value": "Load average (15m avg)"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.4",
                                       "value": ""
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.name.5",
                                       "value": "Processes"
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.data.5",
                                       "value": 1
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.base_color.5",
                                       "value": "FFFFFF"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.item.5",
                                       "value": "Number of processes"
                                   },
                                   {
                                       "type": 1,
                                       "name": "columns.timeshift.5",
                                       "value": ""
                                   },
                                   {
                                       "type": 0,
                                       "name": "columns.decimal_places.5",
                                       "value": 0
                                   },
                                   {
                                       "type": 0,
                                       "name": "column",
                                       "value": 1
                                   }
                               ]
                           }
                       ]
                   }
               ],
               "userGroups": [
                   {
                       "usrgrpid": 7,
                       "permission": 2
                   }
               ],
               "users": [
                   {
                       "userid": 1,
                       "permission": 3
                   }
               ]
           },
           "id": 1
       }

Respuesta:

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

Ver también