[comment]: # ({7a3d2bf9-70237fe9})
# 11 Honeycomb
[comment]: # ({/7a3d2bf9-70237fe9})
[comment]: # ({19fe6913-24cd2015})
### Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget de panel permiten configurar el [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb) widget 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 panel.
Esto permite a los usuarios modificar [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 *Honeycomb*, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
:::
[comment]: # ({/19fe6913-24cd2015})
[comment]: # ({082a0ee8-7a40ed57})
### Parámetros
Se admiten los siguientes parámetros para el widget *Honeycomb*.
|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 - *(por defecto)* 1 minuto;
120 - 2 minutos;
600 - 10 minutos;
900 - 15 minutos.|
|*Grupos de hosts*|<|2|groupids.0|ID de [Grupo de hosts](/manual/api/reference/hostgroup/get).
Nota: Para configurar varios grupos de hosts, cree un objeto de campo de widget de panel 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 [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|<|*Grupos de hosts (Widget)*|1|groupids.\_reference|En lugar del ID de [Grupo de hosts](/manual/api/reference/hostgroup/get):
`ABCDE._hostgroupids` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Referencia* configurado en "`ABCDE`") como fuente de datos para los grupos de hosts.
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|*Hosts*|<|3|hostids.0|ID de [Host](/manual/api/reference/host/get).
Nota: Para configurar varios hosts, cree un objeto de campo de widget de panel para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro *Grupos de hosts* debe no estar configurado en absoluto o configurado con al menos un grupo de hosts al que pertenezcan los hosts configurados.
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|<|*Hosts (Widget/Panel)*|1|hostids.\_reference|En lugar del ID de [Host](/manual/api/reference/host/get):
`DASHBOARD.hostids` - establezca el [selector de hosts](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) del panel como fuente de datos para los hosts;
`ABCDE._hostids` - establezca un [widget compatible](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con su parámetro *Referencia* configurado en "`ABCDE`") como fuente de datos para los hosts.
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|*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 [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|^|*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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de host*
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|^|*Operador*|0|host_tags.0.operator|0 - Contiene;
1 - Igual a;
2 - No contiene;
3 - No igual a;
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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de host*
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|^|*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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de host*
Este parámetro no es compatible si se configura el widget en un [panel de plantilla](/manual/api/reference/templatedashboard/object).|
|*Patrones de ítem*|<|1|items.0|Nombre o patrón de [Ítem](/manual/api/reference/item/get).
Nota: Para configurar varios patrones de ítem, cree un objeto de campo de widget de panel para cada patrón de ítem con un número incrementado en el nombre de la propiedad.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*|
|*Etiquetas de ítem*|<|<|<|<|
|<|*Tipo de evaluación*|0|evaltype_item|0 - *(por defecto)* Y/O;
2 - O.|
|^|*Nombre de etiqueta*|1|item_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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de ítem*|
|^|*Operador*|0|item_tags.0.operator|0 - Contiene;
1 - Igual a;
2 - No contiene;
3 - No igual a;
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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de ítem*|
|^|*Valor de etiqueta*|1|item_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](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio* si se configuran *Etiquetas de ítem*|
|*Mostrar hosts en mantenimiento*|<|0|maintenance|0 - *(por defecto)* Deshabilitado;
1 - Habilitado.|
|*Mostrar*|<|0|show.0|1 - Etiqueta principal;
2 - Etiqueta secundaria.
Nota: Para configurar varios valores, cree un objeto de campo de widget de panel para cada valor con un número incrementado en el nombre de la propiedad.
Por defecto: 1, 2.|
|*Referencia*|<|1|reference|Cualquier valor de cadena que consista en 5 caracteres (por ejemplo, `ABCDE` o `JBPNL`). Este valor debe ser único dentro del panel al que pertenece el widget.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*|
[comment]: # ({/082a0ee8-7a40ed57})
[comment]: # ({aaafe403-d25c8205})
#### Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles para el widget *Honeycomb*.
::: noteclassic
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 de forma ascendente.
Sin embargo, si los umbrales se configuran en un orden diferente, los valores se ordenarán de forma 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](/manual/api/reference/dashboard/object#dashboard-widget-field)|nombre|valor|
|-----|-|-----|-------------------|
|***Etiqueta primaria***|<|<|<|
|*Tipo*|0|primary_label_type|0 - *(por defecto)* Texto;
1 - Valor.|
|*Texto*|1|primary_label|Cualquier valor de cadena, incluyendo macros.
Macros soportadas: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros de usuario.
Por defecto: {HOST.NAME}
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Texto"|
|*Decimales*|0|primary_label_decimal_places|Los valores posibles van de 0-6.
Por defecto: 2.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor"|
|*Tamaño* (tipo)|0|primary_label_size_type|0 - *(por defecto)* Auto;
1 - Personalizado.|
|*Tamaño*|0|primary_label_size|Los valores posibles van de 1-100.
Por defecto: 20.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tamaño* (tipo) está establecido en "Personalizado"|
|*Negrita*|0|primary_label_bold|0 - *(por defecto)* Deshabilitado;
1 - Habilitado.|
|*Color*|1|primary_label_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Por defecto: basado en el `theme` del [objeto Settings](/manual/api/reference/settings/object#settings) y el [objeto User](/manual/api/reference/user/object#user):
`1F2C33` para "blue-theme", "blue-classic-theme" o "hc-light";
`EEEEEE` para "dark-theme", "dark-classic-theme" o "hc-dark".|
|*Unidades* (checkbox)|0|primary_label_units_show|0 - Deshabilitado;
1 - *(por defecto)* Habilitado.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor"|
|*Unidades* (valor)|1|primary_label_units|Cualquier valor de cadena.
`""` (vacío)
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor" y *Unidades* (checkbox) está establecido en "Habilitado"|
|*Posición*|0|primary_label_units_pos|0 - Antes del valor;
1 - *(por defecto)* Después del valor.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor" y *Unidades* (checkbox) está establecido en "Habilitado"
Este parámetro se ignora si se establece en una de las siguientes [unidades relacionadas con el tiempo](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Etiqueta secundaria***|<|<|<|
|*Tipo*|0|secondary_label_type|0 - Texto;
1 - *(por defecto)* Valor.|
|*Texto*|1|secondary_label|Cualquier valor de cadena, incluyendo macros.
Macros soportadas: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros de usuario.
Por defecto: {{ITEM.LASTVALUE}.fmtnum(2)}
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Texto"|
|*Decimales*|0|secondary_label_decimal_places|Los valores posibles van de 0-6.
Por defecto: 2.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor"|
|*Tamaño* (tipo)|0|secondary_label_size_type|0 - *(por defecto)* Auto;
1 - Personalizado.|
|*Tamaño*|0|secondary_label_size|Los valores posibles van de 1-100.
Por defecto: 30.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tamaño* (tipo) está establecido en "Personalizado"|
|*Negrita*|0|secondary_label_bold|0 - Deshabilitado;
1 - *(por defecto)* Habilitado.|
|*Color*|1|secondary_label_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Por defecto: basado en el `theme` del [objeto Settings](/manual/api/reference/settings/object#settings) y el [objeto User](/manual/api/reference/user/object#user):
`1F2C33` para "blue-theme", "blue-classic-theme" o "hc-light";
`EEEEEE` para "dark-theme", "dark-classic-theme" o "hc-dark".|
|*Unidades* (checkbox)|0|secondary_label_units_show|0 - Deshabilitado;
1 - *(por defecto)* Habilitado.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor"|
|*Unidades* (valor)|1|secondary_label_units|Cualquier valor de cadena.
`""` (vacío)
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor" y *Unidades* (checkbox) está establecido en "Habilitado"|
|*Posición*|0|secondary_label_position|0 - Antes del valor;
1 - *(por defecto)* Después del valor.
[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *soportado* si *Tipo* está establecido en "Valor" y *Unidades* (checkbox) está establecido en "Habilitado"
Este parámetro se ignora si se establece en una de las siguientes [unidades relacionadas con el tiempo](/manual/config/items/item#configuration): unixtime, uptime, s.|
|***Color de fondo***|<|<|<|
|*Color de fondo*|1|bg_color|Código de color hexadecimal (por ejemplo, `FF0000`).
Por defecto: basado en el `theme` del [objeto Settings](/manual/api/reference/settings/object#settings) y el [objeto User](/manual/api/reference/user/object#user):
`D9E7ED` para "blue-theme" y "blue-classic-theme";
`3D5059` para "dark-theme" y "dark-classic-theme";
`AAD7E9` para "hc-light";
`335463` para "hc-dark".|
|***Umbrales***|<|<|<|
|*Interpolación de color*|0|interpolation|0 - Deshabilitado;
1 - *(por defecto)* Habilitado.|
|*Color*|1|thresholds.0.color|Código de color hexadecimal (por ejemplo, `FF0000`).|
|*Umbral*|1|thresholds.0.threshold|Cualquier valor numérico. Se admiten [sufijos](/manual/appendix/suffixes) (por ejemplo, "1d", "2w", "4K", "8G").|
[comment]: # ({/aaafe403-d25c8205})
[comment]: # ({05e301d7-c6f49883})
### Ejemplos
Los siguientes ejemplos tienen como objetivo describir únicamente la configuración de los objetos de campo del widget del panel para el widget *Honeycomb*.
Para obtener más información sobre la configuración de un panel, consulte [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/05e301d7-c6f49883})
[comment]: # ({18033898-0cace4a6})
#### Configuración de un widget *Honeycomb*
Configure un widget *Honeycomb* que muestre la utilización de los procesos del servidor Zabbix.
Además, cambie la etiqueta principal de las celdas del honeycomb y ajuste visualmente el widget con umbrales.
[Petición](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "Mi panel",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "honeycomb",
"name": "Honeycomb",
"x": "0",
"y": "0",
"width": "24",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "items.0",
"value": "Zabbix server: Utilization*"
},
{
"type": 1,
"name": "primary_label",
"value": "{ITEM.NAME}"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "70"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "90"
},
{
"type": 1,
"name": "reference",
"value": "KSTMQ"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Respuesta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/18033898-0cace4a6})
[comment]: # ({e9d30322-b52eec61})
### 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-b52eec61})