14 Host-Navigator

Beschreibung

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

Parameter

Die folgenden Parameter werden für das Widget Host navigator 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-Gruppen 2 groupids.0 ID der Host-Gruppe.

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

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host-Gruppen (Widget) 1 groupids._reference Anstelle der ID der Host-Gruppe:
ABCDE._hostgroupids - Legen Sie ein kompatibles Widget (mit dem Parameter Referenz, der auf "ABCDE" gesetzt ist) als Datenquelle für Host-Gruppen fest.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host-Muster 1 hosts.0 Name oder Muster des Hosts.

Hinweis: Um mehrere Host-Muster zu konfigurieren, erstellen Sie für jedes Host-Muster ein Dashboard-Widget-Feldobjekt mit einer erhöhten Nummer im Eigenschaftsnamen. Bei mehreren Host-Mustern muss der Parameter Host-Gruppen entweder überhaupt nicht konfiguriert oder mit mindestens einer Host-Gruppe konfiguriert werden, zu der die Hosts gehören, die den konfigurierten Host-Mustern entsprechen.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host-Status 0 status -1 - (Standard) Beliebig;
0 - Aktiviert;
1 - Deaktiviert.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host-Tags
Auswertungstyp 0 host_tags_evaltype 0 - (Standard) Und/Oder;
2 - Oder.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Tag-Name 1 host_tags.0.tag Beliebiger Zeichenfolgenwert.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich, wenn Host-Tags konfiguriert werden

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Operator 0 host_tags.0.operator 0 - Enthält;
1 - Ist gleich;
2 - Enthält nicht;
3 - Ist nicht gleich;
4 - Existiert;
5 - Existiert nicht.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich, wenn Host-Tags konfiguriert werden

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Tag-Wert 1 host_tags.0.value Beliebiger Zeichenfolgenwert.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich, wenn Host-Tags konfiguriert werden

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Schweregrad 0 severities.0 0 - Nicht klassifiziert;
1 - Information;
2 - Warnung;
3 - Durchschnittlich;
4 - Hoch;
5 - Katastrophe.

Standard: leer (alle aktiviert).

Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer erhöhten Nummer im Eigenschaftsnamen.
Hosts in Wartung anzeigen 0 maintenance 0 - (Standard) Deaktiviert;
1 - Aktiviert.
Probleme anzeigen 0 show_problems 0 - Alle;
1 - (Standard) Nicht unterdrückte;
2 - Keine.
Gruppieren nach
Attribut 0 group_by.0.attribute 0 - Host-Gruppe;
1 - Tag-Wert;
2 - Schweregrad.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Attributreihenfolge in der Liste der Gruppierungsattribute.

Parameterverhalten:
- erforderlich, wenn Gruppieren nach konfiguriert wird
Wert 1 group_by.0.tag_name Beliebiger Zeichenfolgenwert.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf das im Parameter Attribut festgelegte Gruppierungsattribut.

Parameterverhalten:
- erforderlich, wenn Gruppieren nach konfiguriert wird und Attribut auf "Tag-Wert" gesetzt ist
Host-Limit 0 show_lines Mögliche Werte liegen zwischen 1 und 9999.

Standard: 100.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Referenz 1 reference Beliebiger Zeichenfolgenwert aus 5 Zeichen (z. B. ABCDE oder JBPNL). Dieser Wert muss innerhalb des Dashboards, zu dem das Widget gehört, eindeutig sein.

Parameterverhalten:
- erforderlich

Beispiele

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

Konfiguration eines Host navigator-Widgets

Konfigurieren Sie ein Host navigator-Widget, das Hosts anzeigt, die nach ihrer Host-Gruppe und anschließend nach dem Wert des Tags „city“ gruppiert sind.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": "30",
        "auto_start": "1",
        "pages": [
            {
                "widgets": [
                    {
                        "type": "hostnavigator",
                        "name": "Host navigator",
                        "x": "0",
                        "y": "0",
                        "width": "12",
                        "height": "5",
                        "view_mode": "0",
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 2
                            },
                            {
                                "type": 2,
                                "name": "groupids.1",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "group_by.0.attribute",
                                "value": 0
                            },
                            {
                                "type": 0,
                                "name": "group_by.1.attribute",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "group_by.1.tag_name",
                                "value": "city"
                            },
                            {
                                "type": 1,
                                "name": "reference",
                                "value": "SWKLB"
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch