12 Honeycomb

Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare il widget Nido d'ape nei metodi dashboard.create e dashboard.update.

Le proprietà fields del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard. Questo consente agli utenti di modificare i widget built-in e creare widget personalizzati, ma comporta anche il rischio di creare o aggiornare i widget in modo errato. Per garantire la corretta creazione o l'aggiornamento del widget Nido d'ape, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.

Parametri

I seguenti parametri sono supportati per il widget Honeycomb.

Parameter type name value
Refresh interval 0 rf_rate 0 - Nessun aggiornamento;
10 - 10 secondi;
30 - 30 secondi;
60 - (predefinito) 1 minuto;
120 - 2 minuti;
600 - 10 minuti;
900 - 15 minuti.
Host groups 2 groupids.0 ID del Host group.

Nota: per configurare più host group, crea un oggetto campo del widget della dashboard per ogni host group con un numero incrementato nel nome della proprietà.

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Host groups (Widget) 1 groupids._reference Invece dell'ID del Host group:
ABCDE._hostgroupids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host group.

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Hosts 3 hostids.0 ID dell'Host.

Nota: per configurare più host, crea un oggetto campo del widget della dashboard per ogni host con un numero incrementato nel nome della proprietà. Per più host, il parametro Host groups deve essere configurato con almeno un host group a cui appartengono gli host configurati, oppure non deve essere configurato affatto.

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Hosts (Widget/Dashboard) 1 hostids._reference Invece dell'ID dell'Host:
DASHBOARD.hostids - imposta il selettore Host come origine dati per gli host;
ABCDE._hostids - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host.

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Host tags
Evaluation type 0 evaltype_host 0 - (predefinito) And/Or;
2 - Or.

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Tag name 1 host_tags.0.tag Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Host tags

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Operator 0 host_tags.0.operator 0 - Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Host tags

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Tag value 1 host_tags.0.value Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Host tags

Questo parametro non è supportato se il widget viene configurato su una template dashboard.
Item patterns 1 items.0 Nome o pattern dell'Item.

Nota: per configurare più pattern di item, crea un oggetto campo del widget della dashboard per ogni pattern di item con un numero incrementato nel nome della proprietà.

Comportamento del parametro:
- obbligatorio
Item tags
Evaluation type 0 evaltype_item 0 - (predefinito) And/Or;
2 - Or.
Tag name 1 item_tags.0.tag Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Item tags
Operator 0 item_tags.0.operator 0 - Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Item tags
Tag value 1 item_tags.0.value Qualsiasi valore stringa.

Nota: il numero nel nome della proprietà fa riferimento all'ordine dei tag nell'elenco di valutazione dei tag.

Comportamento del parametro:
- obbligatorio se si configurano Item tags
Show hosts in maintenance 0 maintenance 0 - (predefinito) Disabilitato;
1 - Abilitato.
Show 0 show.0 1 - Etichetta primaria;
2 - Etichetta secondaria.

Nota: per configurare più valori, crea un oggetto campo del widget della dashboard per ogni valore con un numero incrementato nel nome della proprietà.

Predefinito: 1, 2.
Reference 1 reference Qualsiasi valore stringa composto da 5 caratteri (ad esempio, ABCDE o JBPNL). Questo valore deve essere univoco all'interno della dashboard a cui appartiene il widget.

Comportamento del parametro:
- obbligatorio

Configurazione avanzata

I seguenti parametri di configurazione avanzata sono supportati per il widget Honeycomb.

Il numero nel nome della proprietà Thresholds (ad esempio thresholds.0.color) fa riferimento alla posizione della soglia in un elenco, ordinato in ordine crescente. Tuttavia, se le soglie sono configurate in un ordine diverso, i valori verranno ordinati in ordine crescente dopo l'aggiornamento della configurazione del widget in Zabbix frontend (ad esempio "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 - (predefinito) Testo;
1 - Valore.
Text 1 primary_label Qualsiasi valore stringa, incluse le macro.
Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente.

Predefinito: {HOST.NAME}

Parameter behavior:
- supportato se Type è impostato su "Text"
Decimal places 0 primary_label_decimal_places I valori possibili vanno da 0 a 6.

Predefinito: 2.

Parameter behavior:
- supportato se Type è impostato su "Value"
Size (type) 0 primary_label_size_type 0 - (predefinito) Automatico;
1 - Personalizzato.
Size 0 primary_label_size I valori possibili vanno da 1 a 100.

Predefinito: 20.

Parameter behavior:
- supportato se Size (type) è impostato su "Custom"
Bold 0 primary_label_bold 0 - (predefinito) Disabilitato;
1 - Abilitato.
Color 1 primary_label_color Codice colore esadecimale (ad esempio FF0000).

Predefinito: in base a theme di Settings object e User object:
1F2C33 per "blue-theme" o "hc-light";
EEEEEE per "dark-theme" o "hc-dark".
Units (checkbox) 0 primary_label_units_show 0 - Disabilitato;
1 - (predefinito) Abilitato.

Parameter behavior:
- supportato se Type è impostato su "Value"
Units (value) 1 primary_label_units Qualsiasi valore stringa.

"" (vuoto)

Parameter behavior:
- supportato se Type è impostato su "Value" e Units (checkbox) è impostato su "Enabled"
Position 0 primary_label_units_pos 0 - Prima del valore;
1 - (predefinito) Dopo il valore.

Parameter behavior:
- supportato se Type è impostato su "Value" e Units (checkbox) è impostato su "Enabled"

Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s.
Secondary label
Type 0 secondary_label_type 0 - Testo;
1 - (predefinito) Valore.
Text 1 secondary_label Qualsiasi valore stringa, incluse le macro.
Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente.

Predefinito: {{ITEM.LASTVALUE}.fmtnum(2)}

Parameter behavior:
- supportato se Type è impostato su "Text"
Decimal places 0 secondary_label_decimal_places I valori possibili vanno da 0 a 6.

Predefinito: 2.

Parameter behavior:
- supportato se Type è impostato su "Value"
Size (type) 0 secondary_label_size_type 0 - (predefinito) Automatico;
1 - Personalizzato.
Size 0 secondary_label_size I valori possibili vanno da 1 a 100.

Predefinito: 30.

Parameter behavior:
- supportato se Size (type) è impostato su "Custom"
Bold 0 secondary_label_bold 0 - Disabilitato;
1 - (predefinito) Abilitato.
Color 1 secondary_label_color Codice colore esadecimale (ad esempio FF0000).

Predefinito: in base a theme di Settings object e User object:
1F2C33 per "blue-theme" o "hc-light";
EEEEEE per "dark-theme" o "hc-dark".
Units (checkbox) 0 secondary_label_units_show 0 - Disabilitato;
1 - (predefinito) Abilitato.

Parameter behavior:
- supportato se Type è impostato su "Value"
Units (value) 1 secondary_label_units Qualsiasi valore stringa.

"" (vuoto)

Parameter behavior:
- supportato se Type è impostato su "Value" e Units (checkbox) è impostato su "Enabled"
Position 0 secondary_label_position 0 - Prima del valore;
1 - (predefinito) Dopo il valore.

Parameter behavior:
- supportato se Type è impostato su "Value" e Units (checkbox) è impostato su "Enabled"

Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s.
Background color
Background color 1 bg_color Codice colore esadecimale (ad esempio FF0000).

Predefinito: in base a theme di Settings object e User object:
D9E7ED per "blue-theme";
3D5059 per "dark-theme";
AAD7E9 per "hc-light";
335463 per "hc-dark".
Thresholds
Color interpolation 0 interpolation 0 - Disabilitato;
1 - (predefinito) Abilitato.
Color 1 thresholds.0.color Codice colore esadecimale (ad esempio FF0000).
Threshold 1 thresholds.0.threshold Qualsiasi valore numerico. Sono supportati i suffissi (ad esempio "1d", "2w", "4K", "8G").

Esempi

Gli esempi seguenti hanno lo scopo esclusivo di descrivere la configurazione degli oggetti campo del widget della dashboard per il widget Honeycomb. Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.

Configurazione di un widget Honeycomb

Configurare un widget Honeycomb che visualizza l'utilizzo dei processi del server Zabbix. Inoltre, modificare l'etichetta primaria delle celle honeycomb e ottimizzare visivamente il widget con le soglie.

Request:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "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
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "3"
        ]
    },
    "id": 1
}

Vedi anche