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 Item navigator unterstützt.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Refresh interval | 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 groups | 2 | groupids.0 | Host group ID. Hinweis: Um mehrere Host groups zu konfigurieren, erstellen Sie für jede Host group ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-Dashboard konfiguriert wird. |
|
| Host groups (Widget) | 1 | groupids._reference | Anstelle der Host group-ID:ABCDE._hostgroupids - setzen Sie ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE") als Datenquelle für Host groups.Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-Dashboard konfiguriert wird. |
|
| Hosts | 3 | hostids.0 | Host-ID. Hinweis: Um mehrere Hosts zu konfigurieren, erstellen Sie für jeden Host ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Bei mehreren Hosts muss der Parameter Host groups entweder gar nicht konfiguriert sein oder mit mindestens einer Host group konfiguriert sein, zu der die konfigurierten Hosts gehören. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-Dashboard konfiguriert wird. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Anstelle der Host-ID:DASHBOARD.hostid - setzen Sie den Host-Selektor als Datenquelle für Hosts;ABCDE._hostid - setzen Sie ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE") als Datenquelle für Hosts.Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-Dashboard konfiguriert wird. |
|
| Host tags | ||||
| Evaluation type | 0 | host_tags_evaltype | 0 - (Standard) And/Or; 2 - Or. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlage-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 Vorlage-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 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 Vorlage-Dashboard konfiguriert wird. |
|
| Tag value | 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 Vorlage-Dashboard konfiguriert wird. |
|
| Item patterns | 1 | items.0 | Datenpunkt-Name oder -Muster. Hinweis: Um mehrere Datenpunktmuster zu konfigurieren, erstellen Sie für jedes Datenpunktmuster ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. |
|
| Item tags | ||||
| Evaluation type | 0 | item_tags_evaltype | 0 - (Standard) And/Or; 2 - Or. |
|
| 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 Item tags konfiguriert werden |
|
| Operator | 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 Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Tags in der Tag-Auswertungsliste. Parameterverhalten: - erforderlich, wenn Item tags konfiguriert werden |
|
| Tag value | 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 Item tags konfiguriert werden |
|
| State | 0 | state | -1 - (Standard) Alle; 0 - Normal; 1 - Nicht unterstützt. |
|
| Show problems | 0 | show_problems | 0 - Alle; 1 - (Standard) Nicht unterdrückt; 2 - Keine. |
|
| Group by | ||||
| Attribute | 0 | group_by.0.attribute | 0 - Host group; 1 - Host name; 2 - Host tag value; 3 - Item tag value. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf die Reihenfolge des Attributs in der Liste der Gruppierungsattribute. Parameterverhalten: - erforderlich, wenn Group by konfiguriert wird |
|
| Value | 1 | group_by.0.tag_name | Beliebiger Zeichenfolgenwert. Hinweis: Die Zahl im Eigenschaftsnamen verweist auf das Gruppierungsattribut, das im Parameter Attribute festgelegt ist. Parameterverhalten: - erforderlich, wenn Group by konfiguriert wird und Attribute auf "Host tag value" oder "Item tag value" gesetzt ist |
|
| Item limit | 0 | show_lines | Mögliche Werte liegen im Bereich von 1-9999. Standard: 100. |
|
| Reference | 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
}