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

Se admiten los siguientes parámetros para 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 hosts 2 groupids.0 ID de Grupo de hosts.

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.
Grupos de hosts (Widget) 1 groupids._reference En lugar del ID de Grupo de hosts:
ABCDE._hostgroupids - establezca un widget compatible (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.
Hosts 3 hostids.0 ID de Host.

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.
Hosts (Widget/Panel) 1 hostids._reference En lugar del ID de Host:
DASHBOARD.hostids - establezca el selector de hosts del panel como fuente de datos para los hosts;
ABCDE._hostids - establezca un widget compatible (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.
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.
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 host

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 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 host

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 host

Este parámetro no es compatible si se configura el widget en un panel de plantilla.
Patrones de ítem 1 items.0 Nombre o patrón de Ítem.

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:
- 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:
- 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:
- 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:
- 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:
- 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) Text;
1 - Value.
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á establecido en "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á establecido en "Value"
Size (type) 0 primary_label_size_type 0 - (predeterminado) Auto;
1 - Custom.
Size 0 primary_label_size Los valores posibles van de 1 a 100.

Predeterminado: 20.

Comportamiento del parámetro:
- compatible si Size (type) está establecido en "Custom"
Bold 0 primary_label_bold 0 - (predeterminado) Disabled;
1 - Enabled.
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", "blue-classic-theme" o "hc-light";
EEEEEE para "dark-theme", "dark-classic-theme" o "hc-dark".
Units (checkbox) 0 primary_label_units_show 0 - Disabled;
1 - (predeterminado) Enabled.

Comportamiento del parámetro:
- compatible si Type está establecido en "Value"
Units (value) 1 primary_label_units Cualquier valor de cadena.

"" (vacío)

Comportamiento del parámetro:
- compatible si Type está establecido en "Value" y Units (checkbox) está establecido en "Enabled"
Position 0 primary_label_units_pos 0 - Before value;
1 - (predeterminado) After value.

Comportamiento del parámetro:
- compatible si Type está establecido en "Value" y Units (checkbox) está establecido en "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 - Text;
1 - (predeterminado) Value.
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á establecido en "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á establecido en "Value"
Size (type) 0 secondary_label_size_type 0 - (predeterminado) Auto;
1 - Custom.
Size 0 secondary_label_size Los valores posibles van de 1 a 100.

Predeterminado: 30.

Comportamiento del parámetro:
- compatible si Size (type) está establecido en "Custom"
Bold 0 secondary_label_bold 0 - Disabled;
1 - (predeterminado) Enabled.
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", "blue-classic-theme" o "hc-light";
EEEEEE para "dark-theme", "dark-classic-theme" o "hc-dark".
Units (checkbox) 0 secondary_label_units_show 0 - Disabled;
1 - (predeterminado) Enabled.

Comportamiento del parámetro:
- compatible si Type está establecido en "Value"
Units (value) 1 secondary_label_units Cualquier valor de cadena.

"" (vacío)

Comportamiento del parámetro:
- compatible si Type está establecido en "Value" y Units (checkbox) está establecido en "Enabled"
Position 0 secondary_label_position 0 - Before value;
1 - (predeterminado) After value.

Comportamiento del parámetro:
- compatible si Type está establecido en "Value" y Units (checkbox) está establecido en "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" y "blue-classic-theme";
3D5059 para "dark-theme" y "dark-classic-theme";
AAD7E9 para "hc-light";
335463 para "hc-dark".
Thresholds
Color interpolation 0 interpolation 0 - Disabled;
1 - (predeterminado) Enabled.
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.

Petición:

{
    "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
}

Véase también