9 Grafico (classico)

Descrizione

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

Parametri

I seguenti parametri sono supportati per il widget Graph (classic).

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.
Source 0 source_type 0 - (predefinito) Graph;
1 - Simple graph.
Graph 6 graphid.0 ID del Graph.

Comportamento del parametro:
- obbligatorio se Source è impostato su "Graph"
Graph (Widget) 1 graphid._reference Invece dell'ID del Graph:
ABCDE._graphid - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati per i graph.

Comportamento del parametro:
- obbligatorio se Source è impostato su "Simple graph" e Graph non è impostato
Item 4 itemid.0 ID dell'Item.

Comportamento del parametro:
- obbligatorio se Source è impostato su "Simple graph" e Item (Widget) non è impostato
Item (Widget) 1 itemid._reference Invece dell'ID dell'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 Source è impostato su "Simple graph" e Item non è impostato
Time period 1 time_period._reference DASHBOARD._timeperiod - imposta il selettore Time period come origine dati;
ABCDE._timeperiod - imposta un widget compatibile (con il parametro Reference impostato su "ABCDE") come origine dati.

Predefinito: DASHBOARD._timeperiod

In alternativa, puoi impostare il periodo di tempo solo nei parametri From e To.
From 1 time_period.from Stringa di tempo 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
- obbligatorio se time_period.to è impostato
To 1 time_period.to Stringa di tempo 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
- obbligatorio se time_period.from è impostato
Show legend 0 show_legend 0 - Disabilitato;
1 - (predefinito) Abilitato.
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.
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

Esempi

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

Configurazione di un widget Graph (classic)

Configurare un widget Graph (classic) che visualizza un grafico semplice per l'item "42269".

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "graph",
                        "name": "Graph (classic)",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "source_type",
                                "value": 1
                            },
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42269
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "RSTUV"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Risposta:

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

Vedi anche