23 Probleme

Beschreibung

Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Probleme 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 es 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 Probleme sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.

Parameter

Die folgenden Parameter werden für das Widget Probleme 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.
Anzeigen 0 show 1 - (Standard) Aktuelle Probleme;
2 - Verlauf;
3 - Probleme.
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 fortlaufend 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 (dessen Parameter Referenz 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-Gruppen ausschließen 2 exclude_groupids.0 ID der Host-Gruppe.

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

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Hosts 3 hostids.0 ID des Hosts.

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

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Hosts (Widget/Dashboard) 1 hostids._reference Anstelle der ID des Hosts:
DASHBOARD.hostids - legen Sie den Host-Auswahlschalter des Dashboards als Datenquelle für Hosts fest;
ABCDE._hostids - legen Sie ein kompatibles Widget (dessen Parameter Referenz auf "ABCDE" gesetzt ist) als Datenquelle für Hosts fest.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Problem 1 problem Problem-Ereignisname (Groß-/Kleinschreibung wird nicht berücksichtigt, vollständiger Name oder Teil davon).
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 fortlaufend erhöhten Nummer im Eigenschaftsnamen.
Problem-Tags
Auswertungstyp 0 evaltype 0 - (Standard) Und/Oder;
2 - Oder.
Tag-Name 1 tags.0.tag Beliebiger Zeichenfolgenwert.

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

Parameterverhalten:
- erforderlich, wenn Problem-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 Nummer im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich, wenn Problem-Tags konfiguriert werden
Tag-Wert 1 tags.0.value Beliebiger Zeichenfolgenwert.

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

Parameterverhalten:
- erforderlich, wenn Problem-Tags konfiguriert werden
Tags anzeigen 0 show_tags 0 - (Standard) Keine;
1 - 1;
2 - 2;
3 - 3.
Tag-Name (Format) 0 tag_name_format 0 - (Standard) Vollständig;
1 - Gekürzt;
2 - Keine.

Parameterverhalten:
- unterstützt, wenn Tags anzeigen auf "1", "2" oder "3" gesetzt ist
Priorität der Tag-Anzeige 1 tag_priority Kommagetrennte Liste von Tags.

Parameterverhalten:
- unterstützt, wenn Tags anzeigen auf "1", "2" oder "3" gesetzt ist
Betriebsdaten anzeigen 0 show_opdata 0 - (Standard) Keine;
1 - Separat;
2 - Mit Problemname.
Unterdrückte Probleme anzeigen 0 show_suppressed 0 - (Standard) Deaktiviert;
1 - Aktiviert.
Bestätigungsstatus 0 acknowledgement_status 0 - (Standard) Alle;
1 - Nicht bestätigt;
2 - Bestätigt.
Von mir 0 acknowledged_by_me 0 - (Standard) Deaktiviert;
1 - Aktiviert.
Einträge sortieren nach 0 sort_triggers 1 - Schweregrad (absteigend);
2 - Host (aufsteigend);
3 - Zeit (aufsteigend);
4 - (Standard) Zeit (absteigend);
13 - Schweregrad (aufsteigend);
14 - Host (absteigend);
15 - Problem (aufsteigend);
16 - Problem (absteigend).

Für alle Werte außer "Zeit (absteigend)" und "Zeit (aufsteigend)" muss der Parameter Zeitachse anzeigen auf "Deaktiviert" gesetzt sein.

Die Werte "Host (aufsteigend)" und "Host (absteigend)" werden nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Zeitachse anzeigen 0 show_timeline 0 - Deaktiviert;
1 - (Standard) Aktiviert.

Parameterverhalten:
- unterstützt, wenn Einträge sortieren nach auf "Zeit (absteigend)" oder "Zeit (aufsteigend)" gesetzt ist
Ganze Zeile hervorheben 0 highlight_row 0 - (Standard) Deaktiviert;
1 - Aktiviert.

Dieser Parameter wird in kontrastreichen Designs nicht unterstützt.
Zeilen anzeigen 0 show_lines Mögliche Werte reichen von 1 bis 100.

Standard: 25.
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 Feldobjekte des Dashboard-Widgets für das Probleme Widget. Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.

Konfigurieren eines Probleme-Widgets

Konfigurieren Sie ein Probleme-Widget, das Probleme für die Host-Gruppe „4“ anzeigt, die die folgenden Bedingungen erfüllen:

  • Probleme, die ein Tag mit dem Namen „scope“ haben, das die Werte „performance“ oder „availability“ oder „capacity“ enthält.
  • Probleme mit den folgenden Schweregraden: „Warning“, „Average“, „High“, „Disaster“.

Konfigurieren Sie das Widget außerdem so, dass Tags und Betriebsdaten angezeigt werden.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "problems",
                        "name": "Problems",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 2,
                                "name": "groupids.0",
                                "value": 4
                            },
                            {
                                "type": 1,
                                "name": "tags.0.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.0.value",
                                "value": "performance"
                            },
                            {
                                "type": 1,
                                "name": "tags.1.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.1.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.1.value",
                                "value": "availability"
                            },
                            {
                                "type": 1,
                                "name": "tags.2.tag",
                                "value": "scope"
                            },
                            {
                                "type": 0,
                                "name": "tags.2.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "tags.2.value",
                                "value": "capacity"
                            },
                            {
                                "type": 0,
                                "name": "severities.0",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "severities.1",
                                "value": 3
                            },
                            {
                                "type": 0,
                                "name": "severities.2",
                                "value": 4
                            },
                            {
                                "type": 0,
                                "name": "severities.3",
                                "value": 5
                            },
                            {
                                "type": 0,
                                "name": "show_tags",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "show_opdata",
                                "value": 1
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}

Antwort:

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

Siehe auch