En esta página
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.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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. |
|
| Host groups | 2 | groupids.0 | ID del Host group. Nota: Para configurar varios host groups, cree un objeto de campo de widget del dashboard para cada host group con un número incrementado en el nombre de la propiedad. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Host groups (Widget) | 1 | groupids._reference | En lugar del ID del Host group:ABCDE._hostgroupids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los host groups.Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Hosts | 3 | hostids.0 | ID del Host. Nota: Para configurar varios hosts, cree un objeto de campo de widget del dashboard para cada host con un número incrementado en el nombre de la propiedad. Para varios hosts, el parámetro Host groups debe no estar configurado en absoluto o debe estar configurado con al menos un host group al que pertenezcan los hosts configurados. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | En lugar del ID del Host:DASHBOARD.hostids - establezca el selector Host como fuente de datos para los hosts;ABCDE._hostids - establezca un widget compatible (con su parámetro Reference establecido en "ABCDE") como fuente de datos para los hosts.Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Host tags | ||||
| Evaluation type | 0 | evaltype_host | 0 - (predeterminado) And/Or; 2 - Or. Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Tag name | 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 Host tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Operator | 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 Host tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Tag value | 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 Host tags Este parámetro no es compatible si se configura el widget en un template dashboard. |
|
| Item patterns | 1 | items.0 | Nombre o patrón del Item. Nota: Para configurar varios patrones de item, cree un objeto de campo de widget del dashboard para cada patrón de item con un número incrementado en el nombre de la propiedad. Comportamiento del parámetro: - obligatorio |
|
| Item tags | ||||
| Evaluation type | 0 | evaltype_item | 0 - (predeterminado) And/Or; 2 - Or. |
|
| Tag name | 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 Item tags |
|
| Operator | 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 Item tags |
|
| Tag value | 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 Item tags |
|
| Show hosts in maintenance | 0 | maintenance | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
|
| Show | 0 | show.0 | 1 - Etiqueta principal; 2 - Etiqueta secundaria. Nota: Para configurar varios valores, cree un objeto de campo de widget del dashboard para cada valor con un número incrementado en el nombre de la propiedad. Predeterminado: 1, 2. |
|
| Reference | 1 | reference | Cualquier valor de cadena de 5 caracteres (por ejemplo, ABCDE o JBPNL). Este valor debe ser único dentro del dashboard al que pertenece el widget.Comportamiento del parámetro: - obligatorio |
|
Configuración avanzada
Los siguientes parámetros de configuración avanzada son compatibles con 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 threshold en una lista, ordenada de forma ascendente.
Sin embargo, si los thresholds 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").
| Parameter | type | name | value |
|---|---|---|---|
| Primary label | |||
| Type | 0 | primary_label_type | 0 - (predeterminado) Texto; 1 - Valor. |
| Text | 1 | primary_label | Cualquier valor de cadena, incluidas macros. Macros compatibles: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario. Predeterminado: {HOST.NAME} Comportamiento del parámetro: - compatible si Type está configurado como "Text" |
| Decimal places | 0 | primary_label_decimal_places | Los valores posibles van de 0 a 6. Predeterminado: 2. Comportamiento del parámetro: - compatible si Type está configurado como "Value" |
| Size (type) | 0 | primary_label_size_type | 0 - (predeterminado) Automático; 1 - Personalizado. |
| Size | 0 | primary_label_size | Los valores posibles van de 1 a 100. Predeterminado: 20. Comportamiento del parámetro: - compatible si Size (type) está configurado como "Custom" |
| Bold | 0 | primary_label_bold | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Color | 1 | primary_label_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: según el theme del Settings object y del User object:1F2C33 para "blue-theme" o "hc-light";EEEEEE para "dark-theme" o "hc-dark". |
| Units (checkbox) | 0 | primary_label_units_show | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. Comportamiento del parámetro: - compatible si Type está configurado como "Value" |
| Units (value) | 1 | primary_label_units | Cualquier valor de cadena."" (vacío)Comportamiento del parámetro: - compatible si Type está configurado como "Value" y Units (checkbox) está configurado como "Enabled" |
| Position | 0 | primary_label_units_pos | 0 - Antes del valor; 1 - (predeterminado) Después del valor. Comportamiento del parámetro: - compatible si Type está configurado como "Value" y Units (checkbox) está configurado como "Enabled" Este parámetro se ignora si se establece en una de las siguientes unidades relacionadas con el tiempo: unixtime, uptime, s. |
| Secondary label | |||
| Type | 0 | secondary_label_type | 0 - Texto; 1 - (predeterminado) Valor. |
| Text | 1 | secondary_label | Cualquier valor de cadena, incluidas macros. Macros compatibles: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macros de usuario. Predeterminado: {{ITEM.LASTVALUE}.fmtnum(2)} Comportamiento del parámetro: - compatible si Type está configurado como "Text" |
| Decimal places | 0 | secondary_label_decimal_places | Los valores posibles van de 0 a 6. Predeterminado: 2. Comportamiento del parámetro: - compatible si Type está configurado como "Value" |
| Size (type) | 0 | secondary_label_size_type | 0 - (predeterminado) Automático; 1 - Personalizado. |
| Size | 0 | secondary_label_size | Los valores posibles van de 1 a 100. Predeterminado: 30. Comportamiento del parámetro: - compatible si Size (type) está configurado como "Custom" |
| Bold | 0 | secondary_label_bold | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
| Color | 1 | secondary_label_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: según el theme del Settings object y del User object:1F2C33 para "blue-theme" o "hc-light";EEEEEE para "dark-theme" o "hc-dark". |
| Units (checkbox) | 0 | secondary_label_units_show | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. Comportamiento del parámetro: - compatible si Type está configurado como "Value" |
| Units (value) | 1 | secondary_label_units | Cualquier valor de cadena."" (vacío)Comportamiento del parámetro: - compatible si Type está configurado como "Value" y Units (checkbox) está configurado como "Enabled" |
| Position | 0 | secondary_label_position | 0 - Antes del valor; 1 - (predeterminado) Después del valor. Comportamiento del parámetro: - compatible si Type está configurado como "Value" y Units (checkbox) está configurado como "Enabled" Este parámetro se ignora si se establece en una de las siguientes unidades relacionadas con el tiempo: unixtime, uptime, s. |
| Background color | |||
| Background color | 1 | bg_color | Código de color hexadecimal (por ejemplo, FF0000).Predeterminado: según el theme del Settings object y del User object:D9E7ED para "blue-theme";3D5059 para "dark-theme";AAD7E9 para "hc-light";335463 para "hc-dark". |
| Thresholds | |||
| Color interpolation | 0 | interpolation | 0 - Deshabilitado; 1 - (predeterminado) Habilitado. |
| Color | 1 | thresholds.0.color | Código de color hexadecimal (por ejemplo, FF0000). |
| Threshold | 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:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}