29 Top-Datenpunkte

Beschreibung

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

Parameter

Die folgenden Parameter werden für das Widget Top items 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 inkrementierten Nummer im Eigenschaftsnamen.

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

Dieser Parameter wird nicht unterstützt, wenn das Widget in 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 inkrementierten Nummer im Eigenschaftsnamen. Bei mehreren Hosts darf der Parameter Host-Gruppen entweder gar nicht konfiguriert sein oder muss mit mindestens einer Host-Gruppe konfiguriert sein, zu der die konfigurierten Hosts gehören.

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

Dieser Parameter wird nicht unterstützt, wenn das Widget in 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 in einem Vorlagen-Dashboard konfiguriert wird.
Tag-Name 1 host_tags.0.tag Beliebiger Zeichenfolgenwert.

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

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

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

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

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

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

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

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird.
Layout 0 layout 0 - (Standard) Horizontal;
1 - Vertikal.
Probleme anzeigen 0 show_problems 0 - Alle;
1 - (Standard) Nicht unterdrückt;
2 - Keine.
Datenpunkte (siehe unten)

Erweiterte Konfiguration

Die folgenden erweiterten Konfigurationsparameter werden für das Widget Top-Datenpunkte unterstützt.

Parameter type name value
Host-Reihenfolge
Sortieren nach 0 host_ordering_order_by 0 - (Standard) Host-Name;
3 - Datenpunktwert.
Datenpunktmuster 1 host_ordering_item.0 Name oder Muster des Datenpunkts (z. B. "*: Anzahl der verarbeiteten *Werte pro Sekunde").

Hinweis: Um mehrere Datenpunktmuster zu konfigurieren, erstellen Sie für jedes Datenpunktmuster ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen.

Bei der Konfiguration des Widgets auf einem Vorlagen-Dashboard sollten nur die Muster für Datenpunkte festgelegt werden, die auf der Vorlage konfiguriert sind.

Parameterverhalten:
- erforderlich, wenn Sortieren nach auf „Datenpunktwert“ gesetzt ist
Reihenfolge 0 host_ordering_order 2 - (Standard) Top N;
3 - Bottom N.
Limit 0 host_ordering_limit Mögliche Werte liegen zwischen 1 und 100.

Standard: 10.
Datenpunkt-Reihenfolge
Sortieren nach 0 item_ordering_order_by 1 - Host;
2 - Datenpunktname;
3 - (Standard) Datenpunktwert.
Host-Muster 1 item_ordering_host.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 fortlaufenden Nummer im Eigenschaftsnamen.

Parameterverhalten:
- erforderlich, wenn Sortieren nach auf „Host“ gesetzt ist
Reihenfolge 0 item_ordering_order 2 - (Standard) Top N;
3 - Bottom N.
Limit 0 item_ordering_limit Mögliche Werte liegen zwischen 1 und 100.

Standard: 10.

Spalten

Die erste Zahl im Eigenschaftsnamen (z. B. columns.0.items.0, columns.0.item_tags_evaltype) bezeichnet die jeweilige Spalte, während die zweite Zahl, sofern vorhanden, die konfigurierte Entität (z. B. Datenpunktmuster, Tag) bezeichnet.

Parameter type name value
Datenpunktmuster 1 columns.0.items.0 Name oder Muster des Datenpunkts (z. B. "*: Anzahl der verarbeiteten *Werte pro Sekunde").

Hinweis: Um mehrere Datenpunktmuster zu konfigurieren, erstellen Sie für jedes Datenpunktmuster ein Dashboard-Widget-Feldobjekt mit einer um eins erhöhten zweiten Zahl im Eigenschaftsnamen.

Beim Konfigurieren des Widgets auf einem Vorlagen-Dashboard sollten nur die Muster für Datenpunkte festgelegt werden, die auf der Vorlage konfiguriert sind.

Parameterverhalten:
- erforderlich
Datenpunkt-Tags
Auswertungstyp 0 columns.0.item_tags_evaltype 0 - (Standard) Und/Oder;
2 - Oder.
Tag-Name 1 columns.0.item_tags.0.tag Beliebiger Zeichenfolgenwert.

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

Parameterverhalten:
- erforderlich, wenn Datenpunkt-Tags konfiguriert werden
Operator 0 columns.0.item_tags.0.operator 0 - Enthält;
1 - Ist gleich;
2 - Enthält nicht;
3 - Ist nicht gleich;
4 - Existiert;
5 - Existiert nicht.

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

Parameterverhalten:
- erforderlich, wenn Datenpunkt-Tags konfiguriert werden
Tag-Wert 1 columns.0.item_tags.0.value Beliebiger Zeichenfolgenwert.

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

Parameterverhalten:
- erforderlich, wenn Datenpunkt-Tags konfiguriert werden
Grundfarbe 1 columns.0.base_color Hexadezimaler Farbcode (z. B. FF0000).
Wert anzeigen als 0 columns.0.display_value_as 1 - (Standard) Numerisch;
2 - Text.
Anzeige 0 columns.0.display 1 - (Standard) Wie angegeben;
2 - Balken;
3 - Indikatoren;
6 - Sparkline.
Min. 1 columns.0.min Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" und Anzeige auf "Balken" oder "Indikatoren" gesetzt ist
Max. 1 columns.0.max Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" und Anzeige auf "Balken" oder "Indikatoren" gesetzt ist
Sparkline
Breite 0 columns.0.sparkline.width Mögliche Werte liegen zwischen 0 und 10.

Standard: 1.

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
Füllung 0 columns.0.sparkline.fill Mögliche Werte liegen zwischen 0 und 10.

Standard: 3.

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
Farbe 1 columns.0.sparkline.color Hexadezimaler Farbcode (z. B. FF0000).

Standard: 42A5F5.

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
Zeitraum 1 columns.0.sparkline.time_period._reference DASHBOARD._timeperiod - den Zeitraumauswahlschalter des Dashboards als Datenquelle festlegen;
ABCDE._timeperiod - ein kompatibles Widget (dessen reference-Parameter auf ABCDE gesetzt ist) als Datenquelle festlegen.

Standard: DASHBOARD._timeperiod

Alternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen.

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
Von 1 columns.0.sparkline.time_period.from Gültige Zeitangabe in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
- erforderlich, wenn columns.0.sparkline.time_period.to festgelegt ist
Bis 1 columns.0.sparkline.time_period.to Gültige Zeitangabe in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
- erforderlich, wenn columns.0.sparkline.time_period.from festgelegt ist
Verlaufsdaten 0 columns.0.sparkline.history 0 - (Standard) Automatisch;
1 - Verlauf;
2 - Trends.

Parameterverhalten:
- unterstützt, wenn Anzeige auf "Sparkline" gesetzt ist
Schwellenwerte
Farbe 1 columns.0.thresholds.0.color Hexadezimaler Farbcode (z. B. FF0000).

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" gesetzt ist
Schwellenwert 1 columns.0.thresholds.0.threshold Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" gesetzt ist
Hervorhebungen
Hervorhebung 1 columns.0.highlights.0.color Hexadezimaler Farbcode (z. B. FF0000).

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Text" gesetzt ist
Schwellenwert 1 columns.0.highlights.0.pattern Beliebiger regulärer Ausdruck.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Text" gesetzt ist
Dezimalstellen 0 columns.0.decimal_places Mögliche Werte liegen zwischen 0 und 10.

Standard: 2.
Erweiterte Konfiguration
Aggregationsfunktion 0 columns.0.aggregate_function Wenn Wert anzeigen als auf "Numerisch" gesetzt ist:
0 - (Standard) nicht verwendet;
1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum;
6 - first;
7 - last.

Wenn Wert anzeigen als auf "Text" gesetzt ist:
0 - (Standard) nicht verwendet;
4 - count;
6 - first;
7 - last.
Zeitraum 1 columns.0.time_period._reference DASHBOARD._timeperiod - den Zeitraumauswahlschalter des Dashboards als Datenquelle festlegen;
ABCDE._timeperiod - ein kompatibles Widget (dessen reference-Parameter auf ABCDE gesetzt ist) als Datenquelle festlegen.

Standard: DASHBOARD._timeperiod

Alternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen.

Parameterverhalten:
- unterstützt, wenn Aggregationsfunktion auf "min", "max", "avg", "count", "sum", "first" oder "last" gesetzt ist
Von 1 columns.0.time_period.from Gültige Zeitangabe in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist und Aggregationsfunktion auf "min", "max", "avg", "count", "sum", "first" oder "last" gesetzt ist
- erforderlich, wenn columns.0.time_period.to festgelegt ist
Bis 1 columns.0.time_period.to Gültige Zeitangabe in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).

Parameterverhalten:
- unterstützt, wenn Zeitraum nicht festgelegt ist und Aggregationsfunktion auf "min", "max", "avg", "count", "sum", "first" oder "last" gesetzt ist
- erforderlich, wenn columns.0.time_period.from festgelegt ist
Verlaufsdaten 0 columns.0.history 0 - (Standard) Automatisch;
1 - Verlauf;
2 - Trends.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" gesetzt ist
Aggregieren 0 columns.0.aggregate_columns 0 - (Standard) Jeder Datenpunkt
1 - Kombiniert.

Parameterverhalten:
- unterstützt, wenn Wert anzeigen als auf "Numerisch" und Anzeige auf "Wie angegeben", "Balken" oder "Indikatoren" gesetzt ist.
Kombinierte Aggregationsfunktion 0 columns.0.column_aggregate_function 1 - min;
2 - max;
3 - avg;
4 - count;
5 - sum (Standard).

Parameterverhalten:
- erforderlich, wenn Aggregieren konfiguriert wird.
Name der kombinierten Spalte 1 columns.0.combined_column_name Beliebiger Zeichenfolgenwert.

Parameterverhalten:
- erforderlich, wenn Aggregieren konfiguriert wird.

Beispiele

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

Konfiguration eines Widgets Top items

Konfigurieren Sie ein Widget Top items, das Daten für den Host „10084“ anzeigt und nur für Datenpunkte, bei denen das Tag mit dem Namen „component“ den Wert „cpu“ enthält. Zeigen Sie außerdem die Daten so an, dass sich die Hosts oben befinden, und verwenden Sie für die Zellendarstellung einen farbigen Balken als Messanzeige.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "My dashboard",
        "display_period": 30,
        "auto_start": 1,
        "pages": [
            {
                "widgets": [
                    {
                        "type": "topitems",
                        "name": "Top items",
                        "x": 0,
                        "y": 0,
                        "width": 36,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 3,
                                "name": "hostids.0",
                                "value": 10084
                            },
                            {
                                "type": 1,
                                "name": "columns.0.items.0",
                                "value": "*"
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.tag",
                                "value": "component"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.item_tags.0.operator",
                                "value": 0
                            },
                            {
                                "type": 1,
                                "name": "columns.0.item_tags.0.value",
                                "value": "cpu"
                            },
                            {
                                "type": 0,
                                "name": "columns.0.display",
                                "value": 2
                            },
                            {
                                "type": 0,
                                "name": "layout",
                                "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