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 Anzeigen auf „Letzte Daten“ gesetzt ist.

Parameter type name value
Breite 0 sparkline.width Mögliche Werte reichen von 0 bis 10.

Standard: 1.
Füllung 0 sparkline.fill Mögliche Werte reichen von 0 bis 10.

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

Standard: 42A5F5.
Zeitraum 1 sparkline.time_period._reference DASHBOARD._timeperiod – den Zeitraum-Selektor 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 Format (YYYY-MM-DD hh:mm:ss) oder in der relativen Zeitsyntax (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.to Gültige Zeitangabe im absoluten Format (YYYY-MM-DD hh:mm:ss) oder in der relativen Zeitsyntax (now, now/d, now/w-1w usw.).

Standard: now.

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist
- erforderlich, wenn time_period.from 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