15 Datenpunkt-Karte

Beschreibung

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

Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert. Dies ermöglicht Benutzern, integrierte Widgets zu ändern und benutzerdefinierte Widgets zu erstellen, birgt jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren. Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Datenpunktkarte sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.

Parameter

Die folgenden Parameter werden für das Widget Datenpunkt-Karte 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.
Datenpunkt 4 itemid.0 Datenpunkt-ID.

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

Parameterverhalten:
- erforderlich, wenn Datenpunkt nicht gesetzt ist
Anzeigen 0 sections.0 0 - Beschreibung;
1 - Fehlertext;
2 - Metriken;
3 - Letzte Daten;
4 - Informationstyp;
5 - Auslöser;
6 - Host-Schnittstelle;
7 - Typ;
8 - Host-Inventar;
9 - Tags.

Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Abschnitts in der Abschnittsliste. Um mehrere Abschnitte zu konfigurieren, erstellen Sie für jeden Abschnitt ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Zahl im Eigenschaftsnamen.
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.

Standard: "" (leer)

Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird.

Sparkline

Die folgenden Parameter werden unterstützt, wenn Anzeigen auf „Letzte Daten“ gesetzt ist.

Parameter type name value
Breite 0 sparkline.width Mögliche Werte liegen im Bereich von 0–10.

Standard: 1.
Füllung 0 sparkline.fill Mögliche Werte liegen im Bereich von 0–10.

Standard: 3.
Farbe 1 sparkline.color Hexadezimaler Farbcode (z. B. FF0000).

Standard: 42A5F5.
Zeitperiode 1 sparkline.time_period._reference DASHBOARD._timeperiod – den Zeitperiodenwähler des Dashboards als Datenquelle festlegen;
ABCDE._timeperiod – ein kompatibles Widget (mit dem Parameter reference gleich ABCDE) als Datenquelle festlegen.

Standard: "" (leer)

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

Standard: now-1h.

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

Standard: now.

Parameterverhalten:
- unterstützt, wenn Zeitperiode nicht gesetzt ist
- erforderlich, wenn time_period.to gesetzt ist
Verlaufsdaten 0 sparkline.history 0 – (Standard) Auto;
1 – Verlauf;
2 – Trends.

Beispiele

Die folgenden Beispiele sollen ausschließlich die Konfiguration der Dashboard-Widget-Feldobjekte für das Widget Datenpunktkarte beschreiben. Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.

Konfiguration eines Datenpunkt-Karten-Widgets

Konfigurieren Sie ein Datenpunkt-Karten-Widget, das diese Abschnitte anzeigt: „Beschreibung“, „Neueste Daten“, „Auslöser“ und „Tags“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "itemcard",
                        "name": "Item card",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 4,
                                "name": "itemid.0",
                                "value": 42257
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 9
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch