8 Grafico

Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget Graph 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 Graph, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.

Parametri

I seguenti parametri sono supportati per il widget Graph.

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.
Riferimento 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

Set di dati

I seguenti parametri sono supportati per la configurazione di un set di dati.

Il primo numero nel nome della proprietà (ad esempio, ds.0.hosts.0, ds.0.items.0) rappresenta il set di dati specifico, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.

Parametro type name value
Tipo di set di dati 0 ds.0.dataset_type 0 - Elenco di item;
1 - (predefinito) Pattern di item.
Item 4 ds.0.itemids.0 ID dell'item.

Quando si configura il widget in una dashboard di template, devono essere impostati solo gli item configurati nel template.

Nota: per configurare più item, creare un oggetto campo del widget dashboard per ogni item, incrementando il numero nel nome della proprietà.

Comportamento del parametro:
- obbligatorio se Tipo di set di dati è impostato su "Elenco di item" e Item (widget) non è impostato
Item (widget) 1 ds.0.itemids.0._reference Invece dell'ID dell'item:
ABCDE._itemid - impostare un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per gli item.

Nota: per configurare più widget, creare un oggetto campo del widget dashboard per ogni widget, incrementando il numero nel nome della proprietà.

Comportamento del parametro:
- obbligatorio se Tipo di set di dati è impostato su "Elenco di item" e Item non è impostato
Colore 1 ds.0.color.0 Codice colore esadecimale (ad esempio, FF0000).

Comportamento del parametro:
- obbligatorio se Tipo di set di dati è impostato su "Elenco di item"
Pattern di host 1 ds.0.hosts.0 Nome o pattern dell'host (ad esempio, "Zabbix*").

Comportamento del parametro:
- obbligatorio se Tipo di set di dati è impostato su "Pattern di item"

Questo parametro non è supportato quando si configura il widget in una dashboard di template.
Pattern di item 1 ds.0.items.0 Nome o pattern dell'item (ad esempio, "*: Numero di *valori elaborati al secondo").

Quando si configura il widget in una dashboard di template, devono essere impostati solo i pattern degli item configurati nel template.

Comportamento del parametro:
- obbligatorio se Tipo di set di dati è impostato su "Pattern di item"
Colore 1 ds.0.color Codice colore esadecimale (ad esempio, FF0000).

Comportamento del parametro:
- supportato se Tipo di set di dati è impostato su "Pattern di item" e Tavolozza dei colori non è impostata
Tavolozza dei colori 0 ds.0.color_palette Indice della tavolozza dei colori.

I valori possibili vanno da 0 a 11.

Predefinito: 0.

Comportamento del parametro:
- supportato se Tipo di set di dati è impostato su "Pattern di item" e Colore non è impostato
Disegno 0 ds.0.type 0 - (predefinito) Linea;
1 - Punti;
2 - Gradini;
3 - Barre.
In pila 0 ds.0.stacked 0 - (predefinito) Disabilitato;
1 - Abilitato.

Comportamento del parametro:
- supportato se Disegno è impostato su "Linea", "Gradini" o "Barre"
Larghezza 0 ds.0.width I valori possibili vanno da 1 a 10.

Predefinito: 1.

Comportamento del parametro:
- supportato se Disegno è impostato su "Linea" o "Gradini"
Dimensione dei punti 0 ds.0.pointsize I valori possibili vanno da 1 a 10.

Predefinito: 3.

Comportamento del parametro:
- supportato se Disegno è impostato su "Punti"
Trasparenza 0 ds.0.transparency I valori possibili vanno da 1 a 10.

Predefinito: 5.
Riempimento 0 ds.0.fill I valori possibili vanno da 1 a 10.

Predefinito: 3.

Comportamento del parametro:
- supportato se Disegno è impostato su "Linea" o "Gradini"
Dati mancanti 0 ds.0.missingdatafunc 0 - (predefinito) Nessuno;
1 - Connessi;
2 - Considera come 0;
3 - Ultimo noto.

Comportamento del parametro:
- supportato se Disegno è impostato su "Linea" o "Gradini"
Sovrascrivi host 1 ds.0.override_hostid._reference ABCDE._hostid - impostare un widget compatibile (con il parametro "Reference" impostato su "ABCDE") come origine dati per gli host;
DASHBOARD._hostid - impostare il selettore di host della dashboard come origine dati per gli host.

Questo parametro non è supportato quando si configura il widget in una dashboard di template.
Asse Y 0 ds.0.axisy 0 - (predefinito) Sinistra;
1 - Destra.
Inverti valori 0 ds.0.invert_values 0 - (predefinito) Disabilitato;
1 - Abilitato.
Spostamento temporale 1 ds.0.timeshift Stringa temporale valida (ad esempio, 3600, 1h, ecc.).
È possibile utilizzare i suffissi temporali. Sono consentiti anche valori negativi.

Predefinito: "" (vuoto).
Funzione di aggregazione 0 ds.0.aggregate_function 0 - (predefinito) non utilizzata;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.
Intervallo di aggregazione 1 ds.0.aggregate_interval Stringa temporale valida (ad esempio, 3600, 1h, ecc.).
È possibile utilizzare i suffissi temporali.

Predefinito: 1h.
Aggrega 0 ds.0.aggregate_grouping 0 - (predefinito) Ogni item;
1 - Set di dati.

Comportamento del parametro:
- supportato se Funzione di aggregazione è impostata su "min", "max", "avg", "count", "sum", "first" o "last"
Approssimazione 0 ds.0.approximation 1 - min;
2 - (predefinito) avg;
4 - max;
7 - tutti.
Etichetta del set di dati 1 ds.0.data_set_label Qualsiasi valore stringa.

Predefinito: "" (vuoto).
Tag degli item
Tipo di valutazione 0 ds.0.item_tags_evaltype 0 - (predefinito) And/Or;
2 - Or.
Nome del tag 1 ds.0.item_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 quando si configurano i Tag degli item
Operatore 0 ds.0.item_tags.0.operator 0 - Contiene;
1 - Uguale;
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 quando si configurano i Tag degli item
Valore del tag 1 ds.0.item_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 quando si configurano i Tag degli item

Opzioni di visualizzazione

I seguenti parametri sono supportati per la configurazione delle Opzioni di visualizzazione.

Parametro type name value
Selezione dei dati cronologici 0 source 0 - (predefinito) Automatico;
1 - Cronologia;
2 - Tendenze.
trigger semplici 0 simple_triggers 0 - (predefinito) Disabilitati;
1 - Abilitati.
Orario di lavoro 0 working_time 0 - (predefinito) Disabilitato;
1 - Abilitato.
Nomi degli host nelle etichette 0 show_hostnames 0 - (predefinito) Automatico;
1 - Mostra;
2 - Nascondi.

Questo parametro non è supportato se si configura il widget in una dashboard di template.
Linea del percentile (sinistra)
Stato 0 percentile_left 0 - (predefinito) Disabilitato;
1 - Abilitato.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Sinistra"
Valore 0 percentile_left_value I valori possibili sono compresi tra 1 e 100.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Sinistra"
Linea del percentile (destra)
Stato 0 percentile_right 0 - (predefinito) Disabilitato;
1 - Abilitato.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Destra"
Valore 0 percentile_right_value I valori possibili sono compresi tra 1 e 100.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Destra"

Periodo di tempo

I seguenti parametri sono supportati per la configurazione di Periodo di tempo.

Parametro type name value
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 suo parametro Reference impostato su "ABCDE") come origine dati.

Predefinito: DASHBOARD._timeperiod

In alternativa, è possibile impostare il periodo di tempo solo nei parametri Da e A.
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
- 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
- obbligatorio se time_period.from è impostato

Assi

I seguenti parametri sono supportati per la configurazione di Assi.

Parametro type name value
Y sinistro 0 lefty 0 - Disabilitato;
1 - (predefinito) Abilitato.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Sinistra"
Y destro 0 righty 0 - (predefinito) Disabilitato;
1 - Abilitato.

Comportamento del parametro:
- supportato se Asse Y (nella configurazione di Set di dati) è impostato su "Destra"
Scala 0 lefty_scale 0 - (predefinito) Lineare;
1 - Logaritmica.
righty_scale
Min 1 lefty_min Qualsiasi valore numerico.

Predefinito: "" (vuoto).
righty_min
Max 1 lefty_max Qualsiasi valore numerico.

Predefinito: "" (vuoto).
righty_max
Unità (tipo) 0 lefty_units 0 - (predefinito) Automatico;
1 - Statico.
righty_units
Unità (valore) 1 lefty_static_units Qualsiasi valore stringa.

Predefinito: "" (vuoto).
righty_static_units
Asse X 0 xaxis 0 - Disabilitato;
1 - (predefinito) Abilitato.

Legenda

I parametri seguenti sono supportati per la configurazione della Legenda.

Parametro tipo nome valore
Mostra legenda 0 legend 0 - Disabilitata;
1 - (predefinita) Abilitata.
Visualizza min/media/max 0 legend_statistic 0 - (predefinita) Disabilitata;
1 - Abilitata.

Comportamento del parametro:
- supportato se Mostra legenda è impostato su "Abilitata"
Mostra funzione di aggregazione 0 legend_aggregation 0 - (predefinita) Disabilitata;
1 - Abilitata.

Comportamento del parametro:
- supportato se Mostra legenda è impostato su "Abilitata"
Righe 0 legend_lines_mode 0 - (predefinita) Fisse;
1 - Variabili.

Comportamento del parametro:
- supportato se Mostra legenda è impostato su "Abilitata"
Numero di righe/
Numero massimo di righe
0 legend_lines I valori possibili vanno da 1 a 10.

Predefinito: 1.

Comportamento del parametro:
- supportato se Mostra legenda è impostato su "Abilitata"
Numero di colonne 0 legend_columns I valori possibili vanno da 1 a 4.

Predefinito: 4.

Comportamento del parametro:
- supportato se Mostra legenda è impostato su "Abilitata" e Visualizza min/media/max è impostato su "Disabilitata"

Problemi

I seguenti parametri sono supportati per la configurazione di Problemi.

Parametro type name value
Mostra problemi 0 show_problems 0 - (predefinito) Disabilitato;
1 - Abilitato.
Solo item selezionati 0 graph_item_problems 0 - Disabilitato;
1 - (predefinito) Abilitato.
Host dei problemi 1 problemhosts.0 Nome Host.

Nota: Il numero nel nome della proprietà fa riferimento all'host configurato.
Per configurare più host, creare un oggetto campo widget dashboard per ciascun host con un numero incrementato nel nome della proprietà.

Questo parametro non è supportato se si configura il widget su una dashboard template.
Gravità 0 severities.0 0 - Non classificato;
1 - Informazione;
2 - Avviso;
3 - Medio;
4 - Alto;
5 - Disastro.

Predefinito: vuoto (tutti abilitati).

Nota: Per configurare più valori, creare un oggetto campo widget dashboard per ciascun valore con un numero incrementato nel nome della proprietà.
Problema 1 problem_name Nome evento del problema (senza distinzione tra maiuscole e minuscole, nome completo o parte di esso).
Tag del problema
Tipo di valutazione 0 evaltype 0 - (predefinito) And/Or;
2 - Or.
Nome tag 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 configura Tag del problema
Operatore 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 configura Tag del problema
Valore tag 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 configura Tag del problema

Override

I seguenti parametri sono supportati per la configurazione degli Override.

Il primo numero nel nome della proprietà (ad esempio, or.0.hosts.0, or.0.items.0) rappresenta il set di dati specifico, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.

Parametro type name value
Pattern degli host 1 or.0.hosts.0 Nome o pattern dell'host (ad esempio, Zabbix*).

Questo parametro non è supportato quando si configura il widget in una dashboard di template.

Comportamento del parametro:
- obbligatorio quando si configurano gli Override
Pattern degli item 1 or.0.items.0 Nome o pattern dell'item (ad esempio, *: Number of processed *values per second).
Quando si configura il widget in una dashboard di template, devono essere impostati solo i pattern degli item configurati nel template.

Comportamento del parametro:
- obbligatorio quando si configurano gli Override
Colore di base 1 or.0.color Codice colore esadecimale (ad esempio, FF0000).
Larghezza 0 or.0.width I valori possibili vanno da 1 a 10.
Disegno 0 or.0.type 0 - Linea;
1 - Punti;
2 - Gradini;
3 - Barre.
Trasparenza 0 or.0.transparency I valori possibili vanno da 1 a 10.
Riempimento 0 or.0.fill I valori possibili vanno da 1 a 10.
Dimensione dei punti 0 or.0.pointsize I valori possibili vanno da 1 a 10.
Dati mancanti 0 or.0.missingdatafunc 0 - Nessuno;
1 - Connessi;
2 - Considera come 0;
3 - Ultimo valore noto.
Asse Y 0 or.0.axisy 0 - Sinistra;
1 - Destra.
Inverti valori 0 or.0.invert_values 0 - (predefinito) Disabilitato;
1 - Abilitato.
Spostamento temporale 1 or.0.timeshift Stringa temporale valida (ad esempio, 3600, 1h, ecc.).
È possibile utilizzare i suffissi temporali. Sono consentiti valori negativi.

Esempi

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

Configurazione di un widget Graph

Configurare un widget Graph nel modo seguente:

  • 2 set di dati per un totale di 9 item su 1 host.
  • Il primo set di dati è di tipo "Item list" ed è composto da 3 item rappresentati da linee con colore diverso, ma con la stessa larghezza, trasparenza e riempimento.
  • Il secondo set di dati è di tipo "Item patterns", è composto da 6 item, ha un'aggregazione configurata ed è rappresentato da una linea con colore, larghezza, trasparenza e riempimento personalizzati.
  • Il secondo set di dati ha anche un'etichetta personalizzata del set di dati.
  • I dati nel grafico vengono visualizzati per un periodo di tempo corrispondente alle ultime 3 ore.
  • I problemi nel grafico vengono visualizzati solo per gli item configurati.
  • Il grafico ha due assi Y, di cui l'asse Y destro visualizza valori solo per il secondo set di dati.
  • La legenda del grafico visualizza gli item configurati in 4 righe, nonché i valori minimo, massimo e medio dei set di dati.

Request:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "svggraph",
                        "name": "Graph",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "ds.0.dataset_type",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.0",
                                "value": 23264
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.0",
                                "value": "FF0000"
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.1",
                                "value": 23269
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.1",
                                "value": "BF00FF"
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.2",
                                "value": 23257
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.2",
                                "value": "0040FF"
                            },
                            {
                                "type": 0,
                                "name": "ds.0.width",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.0.transparency",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "ds.0.fill",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.1.hosts.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.items.0",
                                "value": "*: Number of processed *values per second"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.color",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.transparency",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.1.fill",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "ds.1.axisy",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "ds.1.aggregate_function",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.1.aggregate_interval",
                                "value": "1m"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.aggregate_grouping",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "ds.1.data_set_label",
                                "value": "Number of processed values per second"
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_period.from",
                                "value": "now-3h"
                            },
                            {
                                "type": 1,
                                "name": "time_period.to",
                                "value": "now"
                            },
                            {
                                "type": 0,
                                "name": "legend_statistic",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "show_problems",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "YZABC"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Risposta:

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

Vedi anche