3 Datenübersicht

Dieses Widget ist veraltet und wird in der nächsten Hauptversion entfernt. Erwägen Sie stattdessen die Verwendung des Widgets Top hosts.

Beschreibung

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

Die Eigenschaften fields des Widgets werden während der Erstellung oder Aktualisierung eines Dashboards nicht validiert. Dadurch können Benutzer integrierte Widgets ändern und benutzerdefinierte Widgets erstellen, es besteht jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren. Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Data overview sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.

Parameter

Die folgenden Parameter werden für das Widget Data overview unterstützt.

Parameter type name value
Refresh interval 0 rf_rate 0 - Keine Aktualisierung;
10 - 10 Sekunden;
30 - 30 Sekunden;
60 - (default) 1 Minute;
120 - 2 Minuten;
600 - 10 Minuten;
900 - 15 Minuten.
Host groups 2 groupids.0 Host group ID.

Hinweis: Um mehrere Host groups zu konfigurieren, erstellen Sie für jede Host group ein Dashboard-Widget-Feldobjekt mit einer erhöhten Nummer im Eigenschaftsnamen.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem template dashboard konfiguriert wird.
Host groups (Widget) 1 groupids._reference Anstelle der Host group ID:
ABCDE._hostgroupids - setzen Sie ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für Host groups.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem template dashboard konfiguriert wird.
Hosts 3 hostids.0 Host ID.

Hinweis: Um mehrere Hosts zu konfigurieren, erstellen Sie für jeden Host ein Dashboard-Widget-Feldobjekt mit einer erhöhten Nummer im Eigenschaftsnamen. Für mehrere Hosts muss der Parameter Host groups entweder gar nicht konfiguriert sein oder mit mindestens einer Host group konfiguriert sein, zu der die konfigurierten Hosts gehören.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem template dashboard konfiguriert wird.
Hosts (Widget/Dashboard) 1 hostids._reference Anstelle der Host ID:
DASHBOARD.hostids - setzen Sie den Host selector als Datenquelle für Hosts;
ABCDE._hostids - setzen Sie ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für Hosts.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem template dashboard konfiguriert wird.
Item tags
Evaluation type 0 evaltype 0 - (default) Und/Oder;
2 - Oder.
Tag name 1 tags.0.tag Beliebiger Zeichenfolgenwert.

Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste.

Parameter behavior:
- required wenn Item tags konfiguriert werden
Operator 0 tags.0.operator 0 - Enthält;
1 - Ist gleich;
2 - Enthält nicht;
3 - Ist nicht gleich;
4 - Existiert;
5 - Existiert nicht.

Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste.

Parameter behavior:
- required wenn Item tags konfiguriert werden
Tag value 1 tags.0.value Beliebiger Zeichenfolgenwert.

Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste.

Parameter behavior:
- required wenn Item tags konfiguriert werden
Show suppressed problems 0 show_suppressed 0 - (default) Deaktiviert;
1 - Aktiviert.
Hosts location 0 style 0 - (default) Links;
1 - Oben.

Beispiele

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

Konfigurieren eines Data overview-Widgets

Konfigurieren Sie ein Data overview-Widget, das Daten für den Host "10084" und nur für Datenpunkte anzeigt, für die das Tag mit dem Namen "component" den Wert "cpu" enthält. Zeigen Sie außerdem die Daten mit Hosts oben an.

Request:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "dataover",
                        "name": "Data overview",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "cpu"
                            },
                            {
                                "type": 0,
                                "name": "style",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Response:

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

Siehe auch