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 Item card 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.
Item 4 itemid.0 Datenpunkt ID.

Verhalten des Parameters:
- erforderlich, wenn 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 den Datenpunkt.

Verhalten des Parameters:
- erforderlich, wenn Item nicht gesetzt ist
Show 0 sections.0 0 - Beschreibung;
1 - Fehlermeldung;
2 - Metriken;
3 - Neueste Daten;
4 - Typ der Information;
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 jeweils um 1 erhöhten Zahl im Eigenschaftsnamen.
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 Dashboard-Host-Selektor als Datenquelle für Hosts.

Standard: "" (leer)

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

Sparkline

Die folgenden Parameter werden unterstützt, wenn Show auf "Latest data" gesetzt ist.

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

Standard: 1.
Fill 0 sparkline.fill Mögliche Werte liegen im Bereich von 0-10.

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

Standard: 42A5F5.
Time period 1 sparkline.time_period._reference DASHBOARD._timeperiod - setzt den Time period selector als Datenquelle;
ABCDE._timeperiod - setzt ein kompatibles Widget (mit dem Parameter reference gleich ABCDE) als Datenquelle.

Standard: "" (leer)

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

Standard: now-1h.

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

Standard: now.

Parameterverhalten:
- supported wenn Time period nicht gesetzt ist
- required wenn time_period.from gesetzt ist
History data 0 sparkline.history 0 - (Standard) Auto;
1 - History;
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