26 host principali
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Top hosts 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 Top hosts, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Top hosts.
| 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 appartengano 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 | 0 - (predefinito) And/Or; 2 - Or. Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
| Tag name | 1 | tags.0.tag | Qualsiasi valore stringa. Nota: il numero nel nome della proprietà fa riferimento all'ordine del 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 | 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 del 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 | tags.0.value | Qualsiasi valore stringa. Nota: il numero nel nome della proprietà fa riferimento all'ordine del 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. |
|
| Show hosts in maintenance | 0 | maintenance | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
|
| Columns (see below) | ||||
| Order by | 0 | column | Valore numerico della colonna tra quelle configurate. | |
| Order | 0 | order | 2 - (predefinito) Top N; 3 - Bottom N. |
|
| Host limit | 0 | show_lines | Valori possibili compresi tra 1 e 100. Predefinito: 10. Questo parametro non è supportato se il widget viene configurato su una template dashboard. |
|
Colonne
Le colonne hanno parametri comuni e parametri aggiuntivi a seconda della configurazione del parametro Data.
Per tutti i parametri relativi alle colonne, il numero nel nome della proprietà (ad esempio columns.0.name) fa riferimento a una colonna per la quale il parametro è configurato.
I seguenti parametri sono supportati per tutte le colonne.
| Parametro | type | name | value |
|---|---|---|---|
| Nome | 1 | columns.0.name | Qualsiasi valore stringa. Comportamento del parametro: - obbligatorio |
| Dati | 0 | columns.0.data | 1 - Valore dell'item; 2 - Nome dell'host; 3 - Testo. Comportamento del parametro: - obbligatorio |
| Colore di base | 1 | columns.0.base_color | Codice colore esadecimale (ad esempio FF0000).Comportamento del parametro: - obbligatorio |
Valore dell'item
I seguenti parametri sono supportati se Data è impostato su "Item value".
Il primo numero nel nome della proprietà Thresholds (ad esempio columnsthresholds.0.color.0) fa riferimento alla colonna per cui sono configurate le soglie, mentre il secondo numero 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, "threshold.0.threshold":"5" → "threshold.0.threshold":"1"; "threshold.1.threshold":"1" → "threshold.1.threshold": "5").
| Parameter | type | name | value | |
|---|---|---|---|---|
| Item | 1 | columns.0.item | Nome valido dell'item. Quando si configura il widget su un template dashboard, devono essere impostati solo gli item configurati sul template. |
|
| Display | 0 | columns.0.display | 1 - (default) Come è; 2 - Barra; 3 - Indicatori. |
|
| Min | 1 | columns.0.min | Qualsiasi valore numerico. Parameter behavior: - supported se Display è impostato su "Bar" o "Indicators" |
|
| Max | 1 | columns.0.max | Qualsiasi valore numerico. Parameter behavior: - supported se Display è impostato su "Bar" o "Indicators" |
|
| Decimal places | 0 | columns.0.decimal_places | Valori possibili compresi tra 0 e 10. Predefinito: 2. |
|
| Thresholds | ||||
| Color | 1 | columnsthresholds.0.color.0 | Codice colore esadecimale (ad esempio FF0000).Predefinito: "" (vuoto). |
|
| Threshold | 1 | columnsthresholds.0.threshold.0 | Qualsiasi valore stringa. | |
| Aggregation function | 0 | columns.0.aggregate_function | 0 - (default) non usato; 1 - min; 2 - max; 3 - avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
| Time period | 1 | columns.0.time_period._reference | DASHBOARD._timeperiod - imposta il selettore Time period 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, è possibile impostare il periodo di tempo solo nei parametri From e To. Parameter behavior: - supported se Aggregation function è impostato su "min", "max", "avg", "count", "sum", "first", "last" |
|
| From | 1 | columns.0.time_period.from | Stringa temporale valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Parameter behavior: - supported se Time period non è impostato e Aggregation function è impostato su "min", "max", "avg", "count", "sum", "first", "last" - required se columns.0.time_period.to è impostato |
|
| To | 1 | columns.0.time_period.to | Stringa temporale valida in sintassi assoluta (YYYY-MM-DD hh:mm:ss) o relativa (now, now/d, now/w-1w, ecc.).Parameter behavior: - supported se Time period non è impostato e Aggregation function è impostato su "min", "max", "avg", "count", "sum", "first", "last" - required se columns.0.time_period.from è impostato |
|
| History data | 0 | columns.0.history | 0 - (default) Auto; 1 - History; 2 - Trends. |
|
| Reference | 1 | reference | Qualsiasi valore stringa composto da 5 caratteri (ad esempio ABCDE o JBPNL). Questo valore deve essere univoco all'interno del dashboard a cui appartiene il widget.Parameter behavior: - required |
|
Testo
I seguenti parametri sono supportati se Data è impostato su "Text".
| Parametro | type | name | value |
|---|---|---|---|
| Testo | 1 | columns.0.text | Qualsiasi valore stringa, incluse le macro. Macro supportate: {HOST.*}, {INVENTORY.*}. Comportamento del parametro: - obbligatorio se Data è impostato su "Text" |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Top hosts.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Top hosts
Configurare un widget Top hosts che visualizzi i principali host in base all'utilizzo della CPU nel gruppo host "4". Inoltre, configurare le seguenti colonne personalizzate: "Nome host", "Utilizzo CPU in %", "Media 1m", "Media 5m", "Media 15m", "Processi".
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "tophosts",
"name": "Top hosts",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 1,
"name": "columns.0.name",
"value": "Host"
},
{
"type": 0,
"name": "columns.0.data",
"value": 2
},
{
"type": 1,
"name": "columns.0.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.1.name",
"value": "CPU utilization in %"
},
{
"type": 0,
"name": "columns.1.data",
"value": 1
},
{
"type": 1,
"name": "columns.1.base_color",
"value": "4CAF50"
},
{
"type": 1,
"name": "columns.1.item",
"value": "CPU utilization"
},
{
"type": 0,
"name": "columns.1.display",
"value": 3
},
{
"type": 1,
"name": "columns.1.min",
"value": "0"
},
{
"type": 1,
"name": "columns.1.max",
"value": "100"
},
{
"type": 1,
"name": "columnsthresholds.1.color.0",
"value": "FFFF00"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.0",
"value": "50"
},
{
"type": 1,
"name": "columnsthresholds.1.color.1",
"value": "FF8000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.1",
"value": "80"
},
{
"type": 1,
"name": "columnsthresholds.1.color.2",
"value": "FF4000"
},
{
"type": 1,
"name": "columnsthresholds.1.threshold.2",
"value": "90"
},
{
"type": 1,
"name": "columns.2.name",
"value": "1m avg"
},
{
"type": 0,
"name": "columns.2.data",
"value": 1
},
{
"type": 1,
"name": "columns.2.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.2.item",
"value": "Load average (1m avg)"
},
{
"type": 1,
"name": "columns.3.name",
"value": "5m avg"
},
{
"type": 0,
"name": "columns.3.data",
"value": 1
},
{
"type": 1,
"name": "columns.3.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.3.item",
"value": "Load average (5m avg)"
},
{
"type": 1,
"name": "columns.4.name",
"value": "15m avg"
},
{
"type": 0,
"name": "columns.4.data",
"value": 1
},
{
"type": 1,
"name": "columns.4.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.4.item",
"value": "Load average (15m avg)"
},
{
"type": 1,
"name": "columns.5.name",
"value": "Processes"
},
{
"type": 0,
"name": "columns.5.data",
"value": 1
},
{
"type": 1,
"name": "columns.5.base_color",
"value": "FFFFFF"
},
{
"type": 1,
"name": "columns.5.item",
"value": "Number of processes"
},
{
"type": 0,
"name": "columns.5.decimal_places",
"value": 0
},
{
"type": 0,
"name": "column",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}