[comment]: # ({11ceac39-893a57b4}) # 21 Mejores anfitriones [comment]: # ({/11ceac39-893a57b4}) [comment]: # ({cf47196c-1b9f777d}) ### Descripción Estos parámetros y los posibles valores de propiedad para los respectivos objetos de campo del widget del tablero permiten configurar el widget [*Top hosts*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) en los métodos `dashboard.create` y `dashboard.update`. ::: noteimportant 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 [widgets integrados](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) y crear [widgets personalizados](/manual/modules#developing-modules), pero también introduce el riesgo de crear o actualizando widgets incorrectamente. Para garantizar la creación o actualización exitosa del widget *Hosts principales*, consulte los requisitos de parámetros descritos en las tablas a continuación. ::: [comment]: # ({/cf47196c-1b9f777d}) [comment]: # ({65af6318-342177fd}) ### Parámetros Los siguientes parámetros son compatibles con el widget *Equipos principales*. |Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|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 equipos*|<|2|groupids|ID de [grupo de equipos](/manual/api/reference/hostgroup/get).

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](/manual/api/reference/host/get) .

Nota: Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo . 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, 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*.| |*Columnas* (ver más abajo)|<|<|<|<| |*Orden*|<|0|order|2 - *(predeterminado)* N superior;
3 - N inferior.| |*Ordenar columna*|<|0|column|Valor numérico de la columna de las columnas configuradas.| |*Recuento de hosts*|<|0|count|Los valores válidos oscilan entre 1 y 100.

Predeterminado: 10.| [comment]: # ({/65af6318-342177fd}) [comment]: # ({ebf9b848-14b55db3}) #### Columnas Las columnas tienen parámetros comunes y parámetros adicionales dependiendo de la configuración del parámetro *Data*. ::: noteclassic 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. ::: [comment]: # ({/ebf9b848-14b55db3}) [comment]: # ({4f32414f-5321700b}) Los siguientes parámetros son compatibles con todas las columnas. |Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-----|-|--- --|------------------| |*Nombre*|1|columnas.nombre.0|Cualquier valor de cadena.| |***Datos***< br>(obligatorio)|0|columns.data.0|1 - Valor del elemento;
2 - Nombre del host;
3 - Texto.| |***Color base***
(obligatorio) |1|columns.base_color.0|Código de color hexadecimal (por ejemplo, `FF0000`).| [comment]: # ({/4f32414f-5321700b}) [comment]: # ({fb080973-931aceef}) ##### Valor de la métrica Los siguientes parámetros son compatibles si *Data* se establece en "Valor de la métrica". ::: noteclassic 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 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 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](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-|--------|--|--------|-------------------------- -----| |*Mñetrica*|<|1 |columns.item.0|Nombre válido de métrica .| |***Timeshift***
(obligatorio)|<|1|columns.timeshift.0|Valor numérico o de cadena de tiempo válido (por ejemplo, `3600` o `1h`).
Puedes usar [ sufijos de tiempo](/manual/appendix/suffixes#time-suffixes). Se permiten valores negativos.| |*Función de agregación*|<|0|columns.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|columns.aggregate_interval.0|Cadena de tiempo válida (por ejemplo, `3600`, `1h`, etc.).
Puede usar [sufijos de tiempo](/manual/appendix/suffixes #time-suffixes).

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".| |*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|columnasumbrales.threshold.0.0|Cualquier valor de cadena.| [comment]: # ({/fb080973-931aceef}) [comment]: # ({9b7919cb-108ba0d5}) ##### Texto Los siguientes parámetros son compatibles si *Data* está configurado en "Text". |Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor| |-----|-|-----|-------------------| |*Text*|1|columns.text.0|Cualquier valor de cadena, incluidas las macros.
Macros admitidas: {HOST.\*}, {INVENTORY.\*}.

Parámetro *Text* requerido si *Data* está configurado en "Text".| [comment]: # ({/9b7919cb-108ba0d5}) [comment]: # ({e7eaa526-6098938f}) ### 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`](/manual/api/reference/dashboard/create). [comment]: # ({/e7eaa526-6098938f}) [comment]: # ({9dd290ec-f6735ae7}) #### 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", "Promedio de 1 m", "Promedio de 5 m", "Promedio de 15 m", "Procesos". Solicitud: ```json { "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": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "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.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "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.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "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.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "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.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Respuesta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` [comment]: # ({/9dd290ec-f6735ae7}) [comment]: # ({e9d30322-a8f0e2bb}) ### Ver también - [Campo del widget del tablero](/manual/api/reference/dashboard/object#dashboard-widget-field) - [`dashboard.create`](/manual/api/reference/dashboard/create) - [`dashboard.update`](/manual/api/reference/dashboard/update) [comment]: # ({/e9d30322-a8f0e2bb})