16 Datenpunkt-Verlauf
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Datenpunkt-Verlauf in den Methoden dashboard.create und dashboard.update.
Die Eigenschaften von Widget-fields werden bei der Erstellung oder Aktualisierung eines Dashboards nicht validiert.
Dadurch können Benutzer integrierte Widgets ändern und benutzerdefinierte Widgets erstellen, es besteht jedoch auch das Risiko, Widgets fehlerhaft zu erstellen oder zu aktualisieren.
Um die erfolgreiche Erstellung oder Aktualisierung des Widgets Datenpunkt-Verlauf sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.
Parameter
Die folgenden Parameter werden für das Widget Datenpunkthistorie 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) | |||
| Angezeigte Zeilen | 0 | show_lines | Mögliche Werte liegen im Bereich von 1 bis 100. Standard: 25. |
| Host überschreiben | 1 | override_hostid._reference | ABCDE._hostid - ein kompatibles Widget (mit dem Parameter Referenz auf "ABCDE" gesetzt) als Datenquelle für Hosts festlegen;DASHBOARD._hostid - die Host-Auswahl 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 | Beliebiger Zeichenfolgenwert, der aus 5 Zeichen besteht (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 im Bereich von 1 bis 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 Log-Datenpunkt 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
}