[comment]: # ({95e690e3-978cbb20})
# 26 hosts principales
[comment]: # ({/95e690e3-978cbb20})
[comment]: # ({4e99026f-c5138763})
### 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 [*Top hosts*](/manual/web_interface/frontend_sections/dashboards/widgets/top_hosts) en los métodos `dashboard.create` y `dashboard.update`.
::: noteimportant
Las propiedades `fields` del widget no se validan durante la creación o actualización de un dashboard.
Esto permite a los usuarios modificar los [widgets integrados](/manual/web_interface/frontend_sections/dashboards/widgets) y crear [widgets personalizados](/devel/modules/tutorials/widget), pero también introduce el riesgo de crear o actualizar widgets incorrectamente.
Para garantizar la creación o actualización exitosa del widget *Top hosts*, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
:::
[comment]: # ({/4e99026f-c5138763})
[comment]: # ({b9d84b38-a3febace})
### 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 hosts*|<|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 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](/manual/api/reference_commentary#parameter-behavior):
- *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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas*|
|^|*Valor de etiqueta*|1|tags.value.0|Cualquier valor de cadena.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *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.|
[comment]: # ({/b9d84b38-a3febace})
[comment]: # ({e8e68707-8266fc04})
#### Columnas
Las columnas tienen parámetros comunes y parámetros adicionales dependiendo de la configuración del parámetro *Datos*.
::: noteclassic
Para todos los parámetros relacionados con las columnas, el número en el nombre de la propiedad (por ejemplo, columns.0.name) hace referencia a una columna para la que se configura el parámetro.
:::
[comment]: # ({/e8e68707-8266fc04})
[comment]: # ({e35e7f37-bba2be85})
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|columns.0.name|Cualquier valor de cadena.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*|
|*Datos*|0|columns.0.data|1 - Valor de la métrica;
2 - Nombre del equipo;
3 - Texto.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*|
|*Color base*|1|columns.0.base_color|Código de color hexadecimal (por ejemplo, `FF0000`).
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*|
[comment]: # ({/e35e7f37-bba2be85})
[comment]: # ({38f4a90e-e8b395eb})
##### Valor del item
Se admiten los siguientes parámetros si *Datos* está configurado como "Valor del item".
::: noteclassic
El primer número en el nombre de la propiedad *Umbrales* (por ejemplo, columnsthresholds.0.color.0) hace referencia a la columna para la que se configuran los umbrales, mientras que el segundo número 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, `"threshold.0.threshold":"5"` → `"threshold.0.threshold":"1"`; `"threshold.1.threshold":"1"` → `"threshold.1.threshold": "5"`).
:::
|Parámetro|<|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-|--------|--|--------|-------------------------------|
|*Item*|<|1 |columns.0.item|Nombre de item válido.
Al configurar el widget en un [dashboard de template](/manual/api/reference/templatedashboard/object), solo se deben establecer los items configurados en el template.|
|*Mostrar*|<|0|columns.0.display|1 - *(por defecto)* Como está;
2 - Barra;
3 - Indicadores.|
|*Mínimo*|<|1|columns.0.min|Cualquier valor numérico.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *admitido* si *Mostrar* está configurado como "Barra" o "Indicadores"|
|*Máximo*|<|1|columns.0.max|Cualquier valor numérico.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *admitido* si *Mostrar* está configurado como "Barra" o "Indicadores"|
|*Decimales*|<|0|columns.0.decimal_places|Los valores posibles van de 0 a 10.
Por defecto: 2.|
|*Umbrales*|<|<|<|<|
|<|*Color*|1|columnsthresholds.0.color.0|Código de color hexadecimal (por ejemplo, `FF0000`).
Por defecto: `""` (vacío).|
|^|*Umbral*|1|columnsthresholds.0.threshold.0|Cualquier valor de cadena.|
|*Función de agregación*|<|0|columns.0.aggregate_function|0 - *(por defecto)* no se usa;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.|
|*Periodo de tiempo*|<|1|columns.0.time_period.\_reference|`DASHBOARD._timeperiod` - establecer el [selector de *Periodo de tiempo*](/manual/web_interface/time_period_selector) como fuente de datos;
`ABCDE._timeperiod` - establecer un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro `reference` igual a `ABCDE`) como fuente de datos.
Por defecto: `DASHBOARD._timeperiod`
Alternativamente, puede establecer el periodo de tiempo solo en los parámetros *Desde* y *Hasta*.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *admitido* si *Función de agregación* está configurada como "min", "max", "avg", "count", "sum", "first", "last"|
|<|*Desde*|1|columns.0.time_period.from|Cadena de tiempo válida en sintaxis absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *admitido* si *Periodo de tiempo* no está establecido y *Función de agregación* está configurada como "min", "max", "avg", "count", "sum", "first", "last"
- *requerido* si se establece `columns.0.time_period.to`|
|^|*Hasta*|1|columns.0.time_period.to|Cadena de tiempo válida en sintaxis absoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.).
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *admitido* si *Periodo de tiempo* no está establecido y *Función de agregación* está configurada como "min", "max", "avg", "count", "sum", "first", "last"
- *requerido* si se establece `columns.0.time_period.from`|
|*Datos históricos*|<|0|columns.0.history|0 - *(por defecto)* Auto;
1 - History;
2 - Trends.|
|*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](/manual/api/reference_commentary#parameter-behavior):
- *requerido*|
[comment]: # ({/38f4a90e-e8b395eb})
[comment]: # ({55d0acdb-18fd738d})
##### Texto
Se admiten los siguientes parámetros si *Datos* está establecido en "Texto".
|Parámetro|[tipo](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|*Texto*|1|columns.0.text|Cualquier valor de cadena, incluidas macros.
Macros admitidas: {HOST.\*}, {INVENTORY.\*}.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si *Datos* está establecido en "Texto"|
[comment]: # ({/55d0acdb-18fd738d})
[comment]: # ({e7eaa526-c274247c})
### Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget de panel para el widget *Equipos principales*.
Para obtener más información sobre la configuración de un panel, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/e7eaa526-c274247c})
[comment]: # ({ec72cf7d-2e9b79c3})
#### Configuración de un widget *Top hosts*
Configure un widget *Top hosts* que muestre los equipos principales por utilización de CPU en el grupo de equipos "4".
Además, configure las siguientes columnas personalizadas: "Nombre del equipo", "Utilización de CPU en %", "1m avg", "5m avg", "15m avg", "Procesos".
[Petición](/manual/api#performing-requests):
```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": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/ec72cf7d-2e9b79c3})
[comment]: # ({e9d30322-d8c32fe2})
### Véase también
- [Campo de widget de panel](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-d8c32fe2})