13 Host-Karte

Beschreibung

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

Die Eigenschaften von Widget-fields werden bei 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 Host card sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.

Parameter

Die folgenden Parameter werden für das Widget Host card 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.
Host 3 hostid.0 ID des Hosts.

Parameterverhalten:
- erforderlich, wenn Host (Widget/Dashboard) nicht gesetzt ist

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host (Widget/Dashboard) 1 hostid._reference Anstelle der ID des Hosts:
DASHBOARD.hostid - den Host-Selektor des Dashboards als Datenquelle für den Host festlegen;
ABCDE._hostid - ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE" gesetzt) als Datenquelle für den Host festlegen.

Parameterverhalten:
- erforderlich, wenn Host nicht gesetzt ist

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Unterdrückte Probleme anzeigen 0 show_suppressed 0 - (Standard) Deaktiviert;
1 - Aktiviert.
Anzeigen 0 sections.0 0 - Host-Gruppen;
1 - Beschreibung;
2 - Überwachung;
3 - Verfügbarkeit;
4 - Überwacht von;
5 - Vorlagen;
6 - Inventar;
7 - 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.

Die folgenden Parameter werden unterstützt, wenn Anzeigen auf "Inventar" gesetzt ist.

Parameter type name value
Inventarfelder 0 inventory.0 ID des Inventars.

Hinweis: Um mehrere Inventarfelder zu konfigurieren, erstellen Sie für jedes Inventarfeld ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Zahl im Eigenschaftsnamen.

Beispiele

Die folgenden Beispiele beschreiben nur die Konfiguration der Feldobjekte des Dashboard-Widgets für das Host card Widget. Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.

Konfigurieren eines Host card-Widgets

Konfigurieren Sie ein Host card-Widget, das die folgenden Abschnitte anzeigt: „Monitoring“, „Availability“, „Monitored by“, „Inventory“ und „Tags“.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostcard",
                        "name": "Host card",
                        "x": 0,
                        "y": 0,
                        "width": 14,
                        "height": 7,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostid.0",
                                "value": 10084
                            },
                            {
                                "type": 0,
                                "name": "show_suppressed",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "sections.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "sections.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "sections.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "sections.3",
                                "value": 6
                            },
                            {
                                "type": 0,
                                "name": "sections.4",
                                "value": 7
                            },
                            {
                                "type": 0,
                                "name": "inventory.0",
                                "value": 25
                            },
                            {
                                "type": 0,
                                "name": "inventory.1",
                                "value": 26
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch