Table of Contents
11 Honeycomb
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 widget 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 panel. 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 Honeycomb, consulte el comportamiento de los parámetros descrito en las tablas a continuación.
Parámetros
Los siguientes parámetros son compatibles con el widget Honeycomb.
| 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. |
|
| Grupos de equipos | 2 | groupids.0 | ID del Grupo de equipos. Nota: Para configurar varios grupos de equipos, cree un objeto de campo de widget de panel para cada grupo de equipos 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. |
|
| Grupos de equipos (Widget) | 1 | groupids._reference | En lugar del ID del Grupo de equipos:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como la fuente de datos para los grupos de equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Equipos | 3 | hostids.0 | ID del Equipo. Nota: Para configurar varios equipos, cree un objeto de campo de widget de panel para cada equipo con un número incrementado en el nombre de la propiedad. Para varios equipos, el parámetro Grupos de equipos debe no estar configurado en absoluto o configurado con al menos un grupo de equipos al que pertenezcan los equipos configurados. Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Equipos (Widget/Panel) | 1 | hostids._reference | En lugar del ID del Equipo:DASHBOARD.hostids - establezca el selector de Equipo como la fuente de datos para los equipos;ABCDE._hostids - establezca un widget compatible (con su parámetro Referencia configurado en "ABCDE") como la fuente de datos para los equipos.Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Etiquetas de equipo | ||||
| 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. |
|
| 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: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Operador | 0 | host_tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No es 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: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| 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: - obligatorio si se configuran Etiquetas de equipo Este parámetro no es compatible si se configura el widget en un panel de plantilla. |
|
| Patrones de métricas | 1 | items.0 | Nombre o patrón de la Métrica. Nota: Para configurar varios patrones de métricas, cree un objeto de campo de widget de panel para cada patrón de métrica con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - obligatorio |
|
| Etiquetas de métricas | ||||
| 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: - obligatorio si se configuran Etiquetas de métricas |
|
| Operador | 0 | item_tags.0.operator | 0 - Contiene; 1 - Igual a; 2 - No contiene; 3 - No es 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: - obligatorio si se configuran Etiquetas de métricas |
|
| 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: - obligatorio si se configuran Etiquetas de métricas |
|
| Mostrar equipos en mantenimiento | 0 | maintenance | 0 - (por defecto) Deshabilitado; 1 - Habilitado. |
|
| Mostrar | 0 | show.0 | 1 - Etiqueta primaria; 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: - obligatorio |
|
Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles para el widget Honeycomb.
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 |
|---|---|---|---|
| Etiqueta primaria | |||
| Tipo | 0 | primary_label_type | 0 - (por defecto) Texto; 1 - Valor. |
| Texto | 1 | primary_label | Cualquier valor de cadena, incluidos macros. Macros soportados: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario. Por defecto: {HOST.NAME} Comportamiento del parámetro: - 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: - soportado si Tipo está establecido en "Valor" |
| Tamaño (tipo) | 0 | primary_label_size_type | 0 - (por defecto) Automático; 1 - Personalizado. |
| Tamaño | 0 | primary_label_size | Los valores posibles van de 1-100. Por defecto: 20. Comportamiento del parámetro: - 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 y el objeto User:1F2C33 para "blue-theme" o "hc-light";EEEEEE para "dark-theme" o "hc-dark". |
| Unidades (checkbox) | 0 | primary_label_units_show | 0 - Deshabilitado; 1 - (por defecto) Habilitado. Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" |
| Unidades (valor) | 1 | primary_label_units | Cualquier valor de cadena."" (vacío)Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" y Unidades (checkbox) está en "Habilitado" |
| Posición | 0 | primary_label_units_pos | 0 - Antes del valor; 1 - (por defecto) Después del valor. Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" y Unidades (checkbox) está en "Habilitado" Este parámetro se ignora si se establece en una de las siguientes unidades relacionadas con el tiempo: unixtime, uptime, s. |
| Etiqueta secundaria | |||
| Tipo | 0 | secondary_label_type | 0 - Texto; 1 - (por defecto) Valor. |
| Texto | 1 | secondary_label | Cualquier valor de cadena, incluidos macros. Macros soportados: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario. Por defecto: {{ITEM.LASTVALUE}.fmtnum(2)} Comportamiento del parámetro: - 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: - soportado si Tipo está establecido en "Valor" |
| Tamaño (tipo) | 0 | secondary_label_size_type | 0 - (por defecto) Automático; 1 - Personalizado. |
| Tamaño | 0 | secondary_label_size | Los valores posibles van de 1-100. Por defecto: 30. Comportamiento del parámetro: - 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 y el objeto User:1F2C33 para "blue-theme" o "hc-light";EEEEEE para "dark-theme" o "hc-dark". |
| Unidades (checkbox) | 0 | secondary_label_units_show | 0 - Deshabilitado; 1 - (por defecto) Habilitado. Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" |
| Unidades (valor) | 1 | secondary_label_units | Cualquier valor de cadena."" (vacío)Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" y Unidades (checkbox) está en "Habilitado" |
| Posición | 0 | secondary_label_position | 0 - Antes del valor; 1 - (por defecto) Después del valor. Comportamiento del parámetro: - soportado si Tipo está establecido en "Valor" y Unidades (checkbox) está en "Habilitado" Este parámetro se ignora si se establece en una de las siguientes unidades relacionadas con el tiempo: 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 y el objeto User:D9E7ED para "blue-theme";3D5059 para "dark-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 (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 del panel para el widget Honeycomb. Para obtener más información sobre la configuración de un panel, consulte dashboard.create.
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.
{
"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: