18 Valore dell'item
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Item value nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono validate durante la creazione o l'aggiornamento di una dashboard.
Ciò consente agli utenti di modificare i widget integrati e creare widget personalizzati, ma introduce anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o il corretto aggiornamento del widget Item value, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Valore item.
| Parametro | type | name | value | |
|---|---|---|---|---|
| Intervallo di aggiornamento | 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. |
|
| Item | 4 | itemid.0 | ID Item. Comportamento del parametro: - obbligatorio se Item (Widget) non è impostato |
|
| Item (Widget) | 1 | itemid._reference | Invece dell'ID Item:ABCDE._itemid - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli item.Comportamento del parametro: - obbligatorio se Item non è impostato |
|
| Mostra | 0 | show.0 | 1 - Descrizione; 2 - Valore; 3 - Ora; 4 - Indicatore di variazione; 5 - Sparkline. Predefinito: 1, 2, 3, 4. Nota: per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementato nel nome della proprietà. |
|
| Sostituisci host | 1 | override_hostid._reference | ABCDE._hostid - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli host;DASHBOARD._hostid - imposta il selettore host della dashboard come origine dati per gli host.Questo parametro non è supportato se si configura il widget in una dashboard template. |
|
Configurazione avanzata
I seguenti parametri di configurazione avanzata sono supportati per il widget Valore item.
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").
| Parametro | type | name | value | |
|---|---|---|---|---|
| Colore di sfondo | 1 | bg_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
|
| Thresholds | ||||
| Colore | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio FF0000). |
|
| Soglia | 1 | thresholds.0.threshold | Qualsiasi valore stringa. | |
| Funzione di aggregazione | 0 | aggregate_function | 0 - (predefinito) non utilizzata; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
| Periodo di tempo | 1 | time_period._reference | DASHBOARD._timeperiod - imposta il selettore del periodo di tempo della dashboard come origine dati;ABCDE._timeperiod - imposta un widget compatibile (con il parametro reference uguale a ABCDE) come origine dati.Predefinito: DASHBOARD._timeperiodIn alternativa, è possibile impostare il periodo di tempo solo nei parametri Da e A. Comportamento del parametro: - supportato se Funzione di aggregazione è impostata su "min", "max", "avg", "count", "sum", "first", "last" |
|
| Da | 1 | time_period.from | Stringa temporale valida nella sintassi temporale assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Periodo di tempo non è impostato e Funzione di aggregazione è impostata su "min", "max", "avg", "count", "sum", "first", "last" - obbligatorio se time_period.to è impostato |
|
| A | 1 | time_period.to | Stringa temporale valida nella sintassi temporale assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Periodo di tempo non è impostato e Funzione di aggregazione è impostata su "min", "max", "avg", "count", "sum", "first", "last" - obbligatorio se time_period.from è impostato |
|
| Dati storici | 0 | history | 0 - (predefinito) Auto; 1 - History; 2 - Trends. |
|
Descrizione
I seguenti parametri di configurazione avanzata sono supportati se Mostra è impostato su "Descrizione".
| Parametro | type | name | value |
|---|---|---|---|
| Descrizione | 1 | description | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {ITEM.*}, {INVENTORY.*}, macro utente. Predefinito: {ITEM.NAME}. |
| Posizione orizzontale | 0 | desc_h_pos | 0 - Sinistra; 1 - (predefinito) Centro; 2 - Destra. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
| Posizione verticale | 0 | desc_v_pos | 0 - In alto; 1 - Al centro; 2 - (predefinito) In basso. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
| Dimensione | 0 | desc_size | I valori possibili vanno da 1 a 100. Predefinito: 15. |
| Grassetto | 0 | desc_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | desc_color | Codice colore esadecimale (ad es. FF0000).Predefinito: "" (vuoto). |
Valore
I seguenti parametri di configurazione avanzata sono supportati se Mostra è impostato su "Valore".
| Parametro | type | name | value | |
|---|---|---|---|---|
| Posizioni decimali | ||||
| Posizioni decimali | 0 | decimal_places | I valori possibili vanno da 1 a 10. Predefinito: 2. |
|
| Dimensione | 0 | decimal_size | I valori possibili vanno da 1 a 100. Predefinito: 35. |
|
| Posizione | ||||
| Posizione orizzontale | 0 | value_h_pos | 0 - Sinistra; 1 - (predefinito) Centro; 2 - Destra. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
|
| Posizione verticale | 0 | value_v_pos | 0 - Alto; 1 - (predefinito) Centro; 2 - Basso. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
|
| Dimensione | 0 | value_size | I valori possibili vanno da 1 a 100. Predefinito: 45. |
|
| Grassetto | 0 | value_bold | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
|
| Colore | 1 | value_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
|
| Unità | ||||
| Unità (casella di controllo) | 0 | units_show | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
|
| Unità (valore) | 1 | units | Qualsiasi valore stringa. | |
| Posizione | 0 | units_pos | 0 - Prima del valore; 1 - Sopra il valore; 2 - (predefinito) Dopo il valore; 3 - Sotto il valore. |
|
| Dimensione | 0 | units_size | I valori possibili vanno da 1 a 100. Predefinito: 35. |
|
| Grassetto | 0 | units_bold | 0 - Disabilitato; 1 - (predefinito) Abilitato. |
|
| Colore | 1 | units_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
|
Ora
I seguenti parametri di configurazione avanzata sono supportati se Mostra è impostato su "Time".
| Parametro | type | name | value |
|---|---|---|---|
| Posizione orizzontale | 0 | time_h_pos | 0 - Sinistra; 1 - (predefinito) Centro; 2 - Destra. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
| Posizione verticale | 0 | time_v_pos | 0 - (predefinito) Alto; 1 - Centro; 2 - Basso. Due o più elementi (Descrizione, Valore, Ora) non possono condividere la stessa Posizione orizzontale e Posizione verticale. |
| Dimensione | 0 | time_size | I valori possibili vanno da 1 a 100. Predefinito: 15. |
| Grassetto | 0 | time_bold | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Colore | 1 | time_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
Indicatore di variazione
I seguenti parametri di configurazione avanzata sono supportati se Mostra è impostato su "Indicatore di variazione".
| Parametro | type | name | value |
|---|---|---|---|
| Colore indicatore di variazione ↑ | 1 | up_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
| Colore indicatore di variazione ↓ | 1 | down_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
| Colore indicatore di variazione ↕ | 1 | updown_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
Sparkline
I seguenti parametri di configurazione avanzata sono supportati se Mostra è impostato su "Sparkline".
| Parametro | type | name | value | |
|---|---|---|---|---|
| Larghezza | 0 | sparkline.width | I valori possibili vanno da 0 a 10. Predefinito: 1. |
|
| Riempimento | 0 | sparkline.fill | I valori possibili vanno da 0 a 10. Predefinito: 3. |
|
| Colore | 1 | sparkline.color | Codice colore esadecimale (ad esempio FF0000).Predefinito: 42A5F5. |
|
| Periodo di tempo | 1 | sparkline.time_period._reference | DASHBOARD._timeperiod - imposta il selettore del periodo di tempo della dashboard come origine dati;ABCDE._timeperiod - imposta un widget compatibile (con il relativo parametro reference uguale a ABCDE) come origine dati.Predefinito: DASHBOARD._timeperiodIn alternativa, è possibile impostare il periodo di tempo solo nei parametri Da e A. |
|
| Da | 1 | sparkline.time_period.from | Stringa temporale valida nella sintassi temporale assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - obbligatorio se sparkline.time_period.to è impostato |
|
| A | 1 | sparkline.time_period.to | Stringa temporale valida nella sintassi temporale assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - obbligatorio se sparkline.time_period.from è impostato |
|
| Dati storici | 0 | sparkline.history | 0 - (predefinito) Auto; 1 - Storico; 2 - Trend. |
|
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Item value.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Valore item
Configurare un widget Valore item che visualizzi il valore dell'item per l'item "42266" (disponibilità di Zabbix agent). Inoltre, personalizzare visivamente il widget con più opzioni avanzate, incluso un colore di sfondo dinamico che cambia in base allo stato di disponibilità di Zabbix agent.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "item",
"name": "Item value",
"x": 0,
"y": 0,
"width": 12,
"height": 3,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 42266
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 1,
"name": "description",
"value": "Agent status"
},
{
"type": 0,
"name": "desc_h_pos",
"value": 0
},
{
"type": 0,
"name": "desc_v_pos",
"value": 0
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 1,
"name": "desc_color",
"value": "F06291"
},
{
"type": 0,
"name": "value_h_pos",
"value": 0
},
{
"type": 0,
"name": "value_size",
"value": 25
},
{
"type": 1,
"name": "value_color",
"value": "FFFF00"
},
{
"type": 0,
"name": "units_show",
"value": 0
},
{
"type": 0,
"name": "time_h_pos",
"value": 2
},
{
"type": 0,
"name": "time_v_pos",
"value": 2
},
{
"type": 0,
"name": "time_size",
"value": 10
},
{
"type": 0,
"name": "time_bold",
"value": 1
},
{
"type": 1,
"name": "time_color",
"value": "9FA8DA"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "E1E1E1"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D1C4E9"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "1"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}