16 Datenpunkt-Verlauf
Beschreibung
Mit diesen Parametern und den möglichen Eigenschaftswerten für die jeweiligen Feldobjekte des Dashboard-Widgets können Sie das Widget Datenpunktverlauf 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 Datenpunktverlauf sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.
Parameter
Die folgenden Parameter werden für das Widget Datenpunktverlauf 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. |
| Layout | 0 | layout | 0 - (Standard) Horizontal; 1 - Vertikal. |
| Spalten (siehe unten) | |||
| Zeilen anzeigen | 0 | show_lines | Mögliche Werte liegen zwischen 1 und 100. Standard: 25. |
| Host überschreiben | 1 | override_hostid._reference | ABCDE._hostid - ein kompatibles Widget (mit dem Parameter Referenz, der auf "ABCDE" gesetzt ist) als Datenquelle für Hosts festlegen;DASHBOARD._hostid - die Hostauswahl des Dashboards als Datenquelle für Hosts festlegen.Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird. |
| Erweiterte Konfiguration (siehe unten) | |||
| Referenz | 1 | reference | Ein 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 |
Spalten
Spalten haben gemeinsame Parameter und zusätzliche Parameter, abhängig von der Konfiguration des Parameters Datenpunkt.
Bei allen Parametern, die sich auf Spalten beziehen, verweist die Zahl im Eigenschaftsnamen (z. B. columns.0.name) auf eine Spalte, für die der Parameter konfiguriert ist.
Die folgenden Parameter werden für alle Spalten unterstützt.
| Parameter | type | name | value |
|---|---|---|---|
| Name | 1 | columns.0.name | Beliebiger Zeichenfolgenwert. Parameterverhalten: - erforderlich |
| Datenpunkt | 4 | columns.0.itemid | ID des Datenpunkts. Beim Konfigurieren des Widgets in einem Vorlagen-Dashboard sollten nur Datenpunkte festgelegt werden, die in der Vorlage konfiguriert sind. Parameterverhalten: - erforderlich |
| Basisfarbe | 1 | columns.0.base_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
Die folgenden Spaltenparameter werden unterstützt, wenn der konfigurierte Datenpunkt ein Datenpunkt vom numerischen Typ ist.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Anzeige | 0 | columns.0.display | 1 - (Standard) Wie vorhanden; 2 - Balken; 3 - Indikatoren. |
|
| Min | 1 | columns.0.min | Beliebiger numerischer Wert. Parameterverhalten: - unterstützt, wenn Anzeige auf „Balken“ oder „Indikatoren“ gesetzt ist |
|
| Max | 1 | columns.0.max | Beliebiger numerischer Wert. Parameterverhalten: - unterstützt, wenn Anzeige auf „Balken“ oder „Indikatoren“ gesetzt ist |
|
| Schwellenwerte | ||||
| Farbe | 1 | columns.0.thresholds.0.color | Hexadezimaler Farbcode (z. B. FF0000). |
|
| Schwellenwert | 1 | columns.0.thresholds.0.threshold | Beliebiger numerischer Wert. Suffixe (z. B. „1d“, „2w“, „4K“, „8G“) werden unterstützt. | |
| Verlaufsdaten | 0 | columns.0.history | 0 - (Standard) Automatisch; 1 - Verlauf; 2 - Trends. |
|
Die folgenden Spaltenparameter werden unterstützt, wenn der konfigurierte Datenpunkt vom Typ Zeichen, Text oder Log ist.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Hervorhebungen | ||||
| Hervorhebung | 1 | columns.0.highlights.0.color | Hexadezimaler Farbcode (z. B. FF0000). |
|
| Schwellenwert | 1 | columns.0.highlights.0.pattern | Beliebiger regulärer Ausdruck. | |
| Anzeige | 0 | columns.0.display | 1 - (Standard) Wie vorhanden; 4 - HTML; 5 - Einzeilig. |
|
| Einzeilig | 0 | columns.0.max_length | Mögliche Werte liegen zwischen 1 und 500. Standard: 100. Parameterverhalten: - unterstützt, wenn Anzeige auf „Einzeilig“ gesetzt ist |
|
| Monospace-Schriftart verwenden | 0 | columns.0.monospace_font | 0 - (Standard) Standardschriftart verwenden; 1 - Monospace-Schriftart verwenden. |
|
| Lokale Zeit anzeigen | 0 | columns.0.local_time | 0 - (Standard) Zeitstempel anzeigen; 1 - Lokale Zeit anzeigen. Parameterverhalten: - unterstützt, wenn Datenpunkt auf einen Datenpunkt vom Typ Log gesetzt ist und Zeitstempel anzeigen auf „Aktiviert“ gesetzt ist |
|
Die folgenden Spaltenparameter werden unterstützt, wenn der konfigurierte Datenpunkt ein Datenpunkt vom Binärtyp ist.
| Parameter | type | name | value |
|---|---|---|---|
| Miniaturansicht anzeigen | 1 | columns.0.show_thumbnail | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
Erweiterte Konfiguration
Die folgenden erweiterten Konfigurationsparameter werden für das Widget Datenpunkthistorie unterstützt.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Neue Werte | 0 | sortorder | 0 - (Standard) Oben; 1 - Unten. |
|
| Zeitstempel anzeigen | 0 | show_timestamp | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
|
| Spaltenüberschrift anzeigen | 0 | show_column_header | 0 - Aus; 1 - Horizontal; 2 - (Standard) Vertikal. |
|
| Zeitraum | 1 | time_period._reference | DASHBOARD._timeperiod - den Zeitraumauswahl des Dashboards als Datenquelle festlegen;ABCDE._timeperiod - ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle festlegen.Standard: DASHBOARD._timeperiodAlternativ können Sie den Zeitraum nur in den Parametern Von und Bis festlegen. |
|
| Von | 1 | time_period.from | Gültige Zeitzeichenfolge in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).Parameterverhalten: - unterstützt, wenn Zeitraum nicht gesetzt ist - erforderlich, wenn time_period.to gesetzt ist |
|
| Bis | 1 | time_period.to | Gültige Zeitzeichenfolge in absoluter (YYYY-MM-DD hh:mm:ss) oder relativer Zeitsyntax (now, now/d, now/w-1w usw.).Parameterverhalten: - unterstützt, wenn Zeitraum nicht gesetzt ist - erforderlich, wenn time_period.from gesetzt ist |
|
Beispiele
Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das Elementverlauf Widget.
Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.
Konfiguration eines Widgets Datenpunkthistorie
Konfigurieren Sie ein Widget Datenpunkthistorie, das die neuesten Daten für zwei numerische Datenpunkte „42269“ und „42270“ anzeigt. Konfigurieren Sie außerdem die Datenpunktspalten so, dass sie vertikal angezeigt werden, wobei die Spaltennamen horizontal dargestellt werden; begrenzen Sie die Anzeige auf 15 Datenzeilen und fügen Sie eine separate Zeitstempelspalte hinzu.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "itemhistory",
"name": "Item history",
"x": "0",
"y": "0",
"width": "18",
"height": "6",
"view_mode": "0",
"fields": [
{
"type": "0",
"name": "layout",
"value": "1"
},
{
"type": "1",
"name": "columns.0.name",
"value": "CPU utilization"
},
{
"type": "4",
"name": "columns.0.itemid",
"value": "42269"
},
{
"type": "1",
"name": "columns.1.name",
"value": "Memory utilization"
},
{
"type": "4",
"name": "columns.1.itemid",
"value": "42270"
},
{
"type": "0",
"name": "show_lines",
"value": "15"
},
{
"type": "0",
"name": "show_timestamp",
"value": "1"
},
{
"type": "0",
"name": "show_column_header",
"value": "1"
},
{
"type": "1",
"name": "reference",
"value": "KIVKD"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}