10 Diagramm (klassisch)

Beschreibung

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Graph (classic) in den Methoden dashboard.create und dashboard.update.

Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert. Dadurch können Benutzer integrierte Widgets ändern und benutzerdefinierte Widgets erstellen, es besteht jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren. Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Graph (classic) sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.

Parameter

Die folgenden Parameter werden für das Widget Graph (classic) unterstützt.

Parameter type name value
Refresh interval 0 rf_rate 0 - Keine Aktualisierung;
10 - 10 Sekunden;
30 - 30 Sekunden;
60 - (Standard) 1 Minute;
120 - 2 Minuten;
600 - 10 Minuten;
900 - 15 Minuten.
Source 0 source_type 0 - (Standard) Graph;
1 - Einfaches Diagramm.
Graph 6 graphid.0 Graph-ID.

Parameterverhalten:
- erforderlich, wenn Source auf "Graph" gesetzt ist
Graph (Widget) 1 graphid._reference Anstelle der Graph-ID:
ABCDE._graphid - setze ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für Diagramme.

Parameterverhalten:
- erforderlich, wenn Source auf "Simple graph" gesetzt ist und Graph nicht gesetzt ist
Item 4 itemid.0 Datenpunkt-ID.

Parameterverhalten:
- erforderlich, wenn Source auf "Simple graph" gesetzt ist und Item (Widget) nicht gesetzt ist
Item (Widget) 1 itemid._reference Anstelle der Datenpunkt-ID:
ABCDE._itemid - setze ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für Datenpunkte.

Parameterverhalten:
- erforderlich, wenn Source auf "Simple graph" gesetzt ist und Item nicht gesetzt ist
Time period 1 time_period._reference DASHBOARD._timeperiod - setze den [Time period]-Selektor(/manual/web_interface/time_period_selector) als Datenquelle;
ABCDE._timeperiod - setze ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle.

Standard: DASHBOARD._timeperiod

Alternativ können Sie den Zeitraum nur in den Parametern From und To festlegen.
From 1 time_period.from Gültiger Zeitstring in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w, usw.).

Parameterverhalten:
- unterstützt, wenn Time period nicht gesetzt ist
- erforderlich, wenn time_period.to gesetzt ist
To 1 time_period.to Gültiger Zeitstring in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w, usw.).

Parameterverhalten:
- unterstützt, wenn Time period nicht gesetzt ist
- erforderlich, wenn time_period.from gesetzt ist
Show legend 0 show_legend 0 - Deaktiviert;
1 - (Standard) Aktiviert.
Override host 1 override_hostid._reference ABCDE._hostid - setze ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für Hosts;
DASHBOARD._hostid - setze den [Host]-Selektor des Dashboards(/manual/web_interface/frontend_sections/dashboards/widgets#override-host) als Datenquelle für Hosts.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-Dashboard konfiguriert wird.
Reference 1 reference Beliebiger Zeichenfolgenwert mit 5 Zeichen (z. B. ABCDE oder JBPNL). Dieser Wert muss innerhalb des Dashboards, zu dem das Widget gehört, eindeutig sein.

Parameterverhalten:
- erforderlich

Beispiele

Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das Graph (classic) Widget. Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.

Konfigurieren eines Widgets Graph (classic)

Konfigurieren Sie ein Widget Graph (classic), das ein einfaches Diagramm für den Datenpunkt „42269“ anzeigt.

Anfrage:

{
    "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
}

Antwort:

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

Siehe auch