9 Diagramm (klassisch)

Beschreibung

Mit diesen Parametern und den möglichen Eigenschaftswerten für die jeweiligen Feldobjekte des Dashboard-Widgets können Sie das Widget Graph (klassisch) in den Methoden dashboard.create und dashboard.update konfigurieren.

Die Eigenschaften von fields des Widgets werden während der Erstellung oder Aktualisierung eines Dashboards nicht validiert. Dies ermöglicht es Benutzern, integrierte Widgets zu ändern und benutzerdefinierte Widgets zu erstellen, birgt jedoch auch das Risiko, Widgets falsch zu erstellen oder zu aktualisieren. Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Graph (klassisch) sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.

Parameter

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

Parameter type name value
Aktualisierungsintervall 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.
Quelle 0 source_type 0 - (Standard) Graph;
1 - Einfacher Graph.
Graph 6 graphid.0 Graph-ID.

Parameterverhalten:
- erforderlich, wenn Quelle auf „Graph“ gesetzt ist
Graph (Widget) 1 graphid._reference Anstelle der Graph-ID:
ABCDE._graphid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Graphen fest.

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

Parameterverhalten:
- erforderlich, wenn Quelle auf „Simple graph“ gesetzt ist und Datenpunkt (Widget) nicht gesetzt ist
Datenpunkt (Widget) 1 itemid._reference Anstelle der Item-ID:
ABCDE._itemid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Datenpunkte fest.

Parameterverhalten:
- erforderlich, wenn Quelle auf „Simple graph“ gesetzt ist und Datenpunkt nicht gesetzt ist
Zeitperiode 1 time_period._reference DASHBOARD._timeperiod - legt die Zeitperiodenauswahl des Dashboards als Datenquelle fest;
ABCDE._timeperiod - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle fest.

Standard: DASHBOARD._timeperiod

Alternativ können Sie die Zeitperiode nur in den Parametern Von und Bis festlegen.
Von 1 time_period.from Gültige Zeitzeichenfolge in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitperiode nicht gesetzt ist
- erforderlich, wenn time_period.to gesetzt ist
Bis 1 time_period.to Gültige Zeitzeichenfolge in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitperiode nicht gesetzt ist
- erforderlich, wenn time_period.from gesetzt ist
Legende anzeigen 0 show_legend 0 - Deaktiviert;
1 - (Standard) Aktiviert.
Host überschreiben 1 override_hostid._reference ABCDE._hostid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Hosts fest;
DASHBOARD._hostid - legt die Host-Auswahl des Dashboards als Datenquelle für Hosts fest.

Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird.
Referenz 1 reference Beliebiger Zeichenfolgenwert, der aus 5 Zeichen besteht (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