15 Datenpunkt-Karte

Beschreibung

Mit diesen Parametern und den möglichen Eigenschaftswerten für die jeweiligen Feldobjekte des Dashboard-Widgets können Sie das Widget Datenpunktkarte 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 Datenpunktkarte sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.

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 zwischen 0 und 10.

Standard: 1.
Füllung 0 sparkline.fill Mögliche Werte liegen zwischen 0 und 10.

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

Standard: 42A5F5.
Zeitraum 1 sparkline.time_period._reference DASHBOARD._timeperiod – den Zeitraumauswahlschalter des Dashboards als Datenquelle festlegen;
ABCDE._timeperiod – ein kompatibles Widget (mit dem Parameter reference, der auf ABCDE gesetzt ist) als Datenquelle festlegen.

Standard: "" (leer)

Alternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen.
Von 1 sparkline.time_period.from Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).

Standard: now-1h.

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist
- erforderlich, wenn sparkline.time_period.to festgelegt ist
Bis 1 sparkline.time_period.from Gültige Zeitangabe im absoluten (YYYY-MM-DD hh:mm:ss) oder relativen Zeitformat (now, now/d, now/w-1w usw.).

Standard: now.

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist
- erforderlich, wenn time_period.to festgelegt ist
Verlaufsdaten 0 sparkline.history 0 - (Standard) Automatisch;
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