On this page
11 Nido d'ape
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 si configura il widget in 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 si configura il widget in 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 non configurato oppure configurato con almeno un host group a cui appartengano gli host configurati. Questo parametro non è supportato se si configura il widget in 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 si configura il widget in una template dashboard. |
|
| Host tags | ||||
| Evaluation type | 0 | evaltype_host | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato se si configura il widget in 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 si configura il widget in 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 si configura il widget in 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 si configura il widget in 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 nel frontend di Zabbix
(ad esempio, "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parameter | type | name | value |
|---|---|---|---|
| Etichetta primaria | |||
| Tipo | 0 | primary_label_type | 0 - (predefinito) Testo; 1 - Valore. |
| Testo | 1 | primary_label | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente. Predefinito: {HOST.NAME} Comportamento del parametro: - supportato se Tipo è impostato su "Testo" |
| Posizioni decimali | 0 | primary_label_decimal_places | I valori possibili vanno da 0 a 6. Predefinito: 2. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" |
| Dimensione (tipo) | 0 | primary_label_size_type | 0 - (predefinito) Automatico; 1 - Personalizzato. |
| Dimensione | 0 | primary_label_size | I valori possibili vanno da 1 a 100. Predefinito: 20. Comportamento del parametro: - supportato se Dimensione (tipo) è impostato su "Personalizzato" |
| Grassetto | 0 | primary_label_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | primary_label_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: in base al theme dell'oggetto Settings e dell'oggetto User:1F2C33 per "blue-theme" o "hc-light";EEEEEE per "dark-theme" o "hc-dark". |
| Unità (casella di controllo) | 0 | primary_label_units_show | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" |
| Unità (valore) | 1 | primary_label_units | Qualsiasi valore stringa."" (vuoto)Comportamento del parametro: - supportato se Tipo è impostato su "Valore" e Unità (casella di controllo) è impostato su "Abilitato" |
| Posizione | 0 | primary_label_units_pos | 0 - Prima del valore; 1 - (predefinito) Dopo il valore. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" e Unità (casella di controllo) è impostato su "Abilitato" Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s. |
| Etichetta secondaria | |||
| Tipo | 0 | secondary_label_type | 0 - Testo; 1 - (predefinito) Valore. |
| Testo | 1 | secondary_label | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente. Predefinito: {{ITEM.LASTVALUE}.fmtnum(2)} Comportamento del parametro: - supportato se Tipo è impostato su "Testo" |
| Posizioni decimali | 0 | secondary_label_decimal_places | I valori possibili vanno da 0 a 6. Predefinito: 2. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" |
| Dimensione (tipo) | 0 | secondary_label_size_type | 0 - (predefinito) Automatico; 1 - Personalizzato. |
| Dimensione | 0 | secondary_label_size | I valori possibili vanno da 1 a 100. Predefinito: 30. Comportamento del parametro: - supportato se Dimensione (tipo) è impostato su "Personalizzato" |
| Grassetto | 0 | secondary_label_bold | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Colore | 1 | secondary_label_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: in base al theme dell'oggetto Settings e dell'oggetto User:1F2C33 per "blue-theme" o "hc-light";EEEEEE per "dark-theme" o "hc-dark". |
| Unità (casella di controllo) | 0 | secondary_label_units_show | 0 - Disabilitato; 1 - (predefinito) Abilitato. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" |
| Unità (valore) | 1 | secondary_label_units | Qualsiasi valore stringa."" (vuoto)Comportamento del parametro: - supportato se Tipo è impostato su "Valore" e Unità (casella di controllo) è impostato su "Abilitato" |
| Posizione | 0 | secondary_label_position | 0 - Prima del valore; 1 - (predefinito) Dopo il valore. Comportamento del parametro: - supportato se Tipo è impostato su "Valore" e Unità (casella di controllo) è impostato su "Abilitato" Questo parametro viene ignorato se impostato su una delle seguenti unità relative al tempo: unixtime, uptime, s. |
| Colore di sfondo | |||
| Colore di sfondo | 1 | bg_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: in base al theme dell'oggetto Settings e dell'oggetto User:D9E7ED per "blue-theme";3D5059 per "dark-theme";AAD7E9 per "hc-light";335463 per "hc-dark". |
| Thresholds | |||
| Interpolazione del colore | 0 | interpolation | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
| Colore | 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.
{
"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
}