On this page
17 Datenpunkt-Navigator
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Datenpunkt-Navigator 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 Datenpunkt-Navigator sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
Parameter
Die folgenden Parameter werden für das Widget Datenpunkt-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 fortlaufenden 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 auf "ABCDE" gesetzt) als Datenquelle für Host-Gruppen fest.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 fortlaufenden Nummer im Eigenschaftsnamen. Bei mehreren Hosts muss der Parameter Host-Gruppen entweder überhaupt nicht konfiguriert sein oder mindestens eine Host-Gruppe enthalten, 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.hostid - legen Sie den Host-Auswahlschalter des Dashboards als Datenquelle für Hosts fest;ABCDE._hostid - legen Sie ein kompatibles Widget (mit dem Parameter Referenz auf "ABCDE" gesetzt) als Datenquelle für Hosts fest.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 Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags 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 - Ist vorhanden; 5 - Ist nicht vorhanden. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags 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 Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags 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. |
|
| Datenpunktmuster | 1 | items.0 | Name oder Muster des Datenpunkts. Hinweis: Um mehrere Datenpunktmuster zu konfigurieren, erstellen Sie für jedes Datenpunktmuster ein Dashboard-Widget-Feldobjekt mit einer fortlaufenden Nummer im Eigenschaftsnamen. |
|
| Datenpunkt-Tags | ||||
| Auswertungstyp | 0 | item_tags_evaltype | 0 - (Standard) Und/Oder; 2 - Oder. |
|
| Tag-Name | 1 | item_tags.0.tag | Beliebiger Zeichenfolgenwert. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste. Parameterverhalten: - erforderlich, wenn Datenpunkt-Tags konfiguriert werden |
|
| Operator | 0 | item_tags.0.operator | 0 - Enthält; 1 - Ist gleich; 2 - Enthält nicht; 3 - Ist nicht gleich; 4 - Ist vorhanden; 5 - Ist nicht vorhanden. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste. Parameterverhalten: - erforderlich, wenn Datenpunkt-Tags konfiguriert werden |
|
| Tag-Wert | 1 | item_tags.0.value | Beliebiger Zeichenfolgenwert. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste. Parameterverhalten: - erforderlich, wenn Datenpunkt-Tags konfiguriert werden |
|
| Status | 0 | state | -1 - (Standard) Alle; 0 - Normal; 1 - Nicht unterstützt. |
|
| 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 - Host-Name; 2 - Host-Tag-Wert; 3 - Datenpunkt-Tag-Wert. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Attributs in der Liste der Gruppierungsattribute. Parameterverhalten: - erforderlich, wenn Gruppieren nach konfiguriert wird |
|
| Wert | 1 | group_by.0.tag_name | Beliebiger Zeichenfolgenwert. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf das im Parameter Attribut festgelegte Gruppierungsattribut. Parameterverhalten: - erforderlich, wenn Gruppieren nach konfiguriert wird und Attribut auf „Host-Tag-Wert“ oder „Datenpunkt-Tag-Wert“ gesetzt ist |
|
| Datenpunktlimit | 0 | show_lines | Mögliche Werte liegen zwischen 1 und 9999. Standard: 100. |
|
| 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 Item navigator Widget.
Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.
Konfiguration eines Datenpunkt-Navigator-Widgets
Konfigurieren Sie ein Datenpunkt-Navigator-Widget, das bis zu 1000 Datenpunkte anzeigt, gruppiert nach ihrem Host und anschließend nach dem Wert des Datenpunkt-Tags „component“.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "itemnavigator",
"name": "Item navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 3
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "component"
},
{
"type": 0,
"name": "show_lines",
"value": 1000
},
{
"type": 1,
"name": "reference",
"value": "DFNLK"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}