17 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 Item value.
| Parametro | type | nome | valore | |
|---|---|---|---|---|
| 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. |
|
| 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 |
|
| Show | 0 | show.0 | 1 - Descrizione; 2 - Valore; 3 - Ora; 4 - Indicatore di variazione. Predefinito: 1, 2, 3, 4 (tutti abilitati). Nota: per configurare più valori, crea un oggetto campo del widget della dashboard per ogni valore con un numero incrementato nel nome della proprietà. |
|
| Override 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 su una template dashboard. |
|
Configurazione avanzata
I seguenti parametri di configurazione avanzata sono supportati per il widget Item value.
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 | |
|---|---|---|---|---|
| Background color | 1 | bg_color | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
|
| Thresholds | ||||
| Color | 1 | thresholds.0.color | Codice colore esadecimale (ad esempio FF0000). |
|
| Threshold | 1 | thresholds.0.threshold | Qualsiasi valore stringa. | |
| Aggregation function | 0 | aggregate_function | 0 - (predefinito) non usato; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
| Time period | 1 | time_period._reference | DASHBOARD._timeperiod - imposta il Time period selector come origine dei dati;ABCDE._timeperiod - imposta un widget compatibile (con il parametro reference uguale a ABCDE) come origine dei dati.Predefinito: DASHBOARD._timeperiodIn alternativa, puoi impostare il periodo di tempo solo nei parametri From e To. Comportamento del parametro: - supportato se Aggregation function è impostata su "min", "max", "avg", "count", "sum", "first", "last" |
|
| From | 1 | time_period.from | Stringa temporale valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Time period non è impostato e Aggregation function è impostata su "min", "max", "avg", "count", "sum", "first", "last" - obbligatorio se time_period.to è impostato |
|
| To | 1 | time_period.to | Stringa temporale valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Comportamento del parametro: - supportato se Time period non è impostato e Aggregation function è impostata su "min", "max", "avg", "count", "sum", "first", "last" - obbligatorio se time_period.from è impostato |
|
| History data | 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). |
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
}