On this page
25 Streudiagramm
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Streudiagramm 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 Streudiagramm sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.
Parameter
Die folgenden Parameter werden für das Widget Streudiagramm 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. |
| 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 |
Datensatz
Die folgenden Parameter werden für die Konfiguration eines Datensatzes unterstützt.
Die erste Zahl im Eigenschaftsnamen (z. B. ds.0.hosts.0, ds.0.items.0) steht für den jeweiligen Datensatz, während die zweite Zahl, falls vorhanden, für den konfigurierten Host oder Datenpunkt steht.
| Parameter | < | type | name | value | |
|---|---|---|---|---|---|
| Datensatztyp | < | 0 | ds.0.dataset_type | 0 - Datenpunktliste; 1 - (Standard) Datenpunktmuster. |
|
| Datensatz: Datenpunktliste | < | < | < | ||
| Farbe | < | 1 | ds.0.color.0 | Hexadezimaler Farbcode (z. B. FF0000).Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktliste“ gesetzt ist |
|
| X-Achse | < | 4 | ds.0.x_axis_itemids.0 | Datenpunkt-ID. Wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird, sollten nur in der Vorlage konfigurierte Datenpunkte gesetzt werden. Hinweis: Um mehrere Datenpunkte zu konfigurieren, erstellen Sie für jeden Datenpunkt ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktliste“ gesetzt ist und X-Achse (Widget) nicht gesetzt ist |
|
| X-Achse (Widget) | < | 1 | ds.0.x_axis_itemids.0._reference | Anstelle einer Datenpunkt-ID:ABCDE._itemid - ein kompatibles Widget (mit dem auf „ABCDE“ gesetzten Parameter Referenz) als Datenquelle für Datenpunkte festlegen.Hinweis: Um mehrere Widgets zu konfigurieren, erstellen Sie für jedes Widget ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktliste“ gesetzt ist und X-Achse nicht gesetzt ist |
|
| Y-Achse | < | 4 | ds.0.y_axis_itemids.0 | Datenpunkt-ID. Wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird, sollten nur in der Vorlage konfigurierte Datenpunkte gesetzt werden. Hinweis: Um mehrere Datenpunkte zu konfigurieren, erstellen Sie für jeden Datenpunkt ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktliste“ gesetzt ist und Y-Achse (Widget) nicht gesetzt ist |
|
| Y-Achse (Widget) | < | 1 | ds.0.y_axis_itemids.0._reference | Anstelle einer Datenpunkt-ID:ABCDE._itemid - ein kompatibles Widget (mit dem auf „ABCDE“ gesetzten Parameter Referenz) als Datenquelle für Datenpunkte festlegen.Hinweis: Um mehrere Widgets zu konfigurieren, erstellen Sie für jedes Widget ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktliste“ gesetzt ist und Y-Achse nicht gesetzt ist |
|
| Host überschreiben | < | 1 | ds.0.override_hostid._reference | ABCDE._hostid- ein kompatibles Widget (mit dem auf „ABCDE“ gesetzten Parameter „Reference“) 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 in einem Vorlagen-Dashboard konfiguriert wird. |
|
| Datensatz: Datenpunktmuster | < | < | < | ||
| Farbe | < | 1 | ds.0.color | Hexadezimaler Farbcode (z. B. FF0000).Parameterverhalten: - unterstützt, wenn Datensatztyp auf „Datenpunktmuster“ gesetzt ist und Farbpalette nicht gesetzt ist |
|
| Farbpalette | < | 0 | ds.0.color_palette | Index der Farbpalette. Möglicher Wertebereich: 0-11. Standard: 0. Parameterverhalten: - unterstützt, wenn Datensatztyp auf „Datenpunktmuster“ gesetzt ist und Farbe nicht gesetzt ist |
|
| Host-Muster | < | 1 | ds.0.hosts.0 | Host-Name oder -Muster (z. B. "Zabbix*"). Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktmuster“ gesetzt ist Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird. |
|
| X-Achsen-Datenpunktmuster | < | 1 | ds.0.x_axis_items.0 | Datenpunkt-Name oder -Muster (z. B. "*: Number of processed *values per second"). Wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird, sollten nur die Muster für in der Vorlage konfigurierte Datenpunkte gesetzt werden. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktmuster“ gesetzt ist |
|
| Y-Achsen-Datenpunktmuster | < | 1 | ds.0.y_axis_items.0 | Datenpunkt-Name oder -Muster (z. B. "*: Number of processed *values per second"). Wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird, sollten nur die Muster für in der Vorlage konfigurierte Datenpunkte gesetzt werden. Parameterverhalten: - erforderlich, wenn Datensatztyp auf „Datenpunktmuster“ gesetzt ist |
|
| Host-Gruppen | < | 2 | groupids.0 | Host-Gruppe-ID. Hinweis: Um mehrere Host-Gruppen zu konfigurieren, erstellen Sie für jede Host-Gruppe ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird. |
|
| Host-Gruppen (Widget) | < | 1 | groupids._reference | Anstelle einer Host-Gruppe-ID:ABCDE._hostgroupids - ein kompatibles Widget (mit dem auf „ABCDE“ gesetzten Parameter Referenz) als Datenquelle für Host-Gruppen festlegen.Dieser Parameter wird nicht unterstützt, wenn das Widget in einem Vorlagen-Dashboard konfiguriert wird. |
|
| Host überschreiben | < | 1 | ds.0.override_hostid._reference | ABCDE._hostid- ein kompatibles Widget (mit dem auf „ABCDE“ gesetzten Parameter „Reference“) 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 in einem Vorlagen-Dashboard konfiguriert wird. |
|
| Host-Tags | < | < | < | < | |
| < | Auswertungstyp | 0 | evaltype_host | 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 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 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 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 in 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 in einem Vorlagen-Dashboard konfiguriert wird. |
|
| Markierung | < | 0 | ds.0.marker | 0 - (Standard) Ellipse; 1 - Quadrat; 2 - Dreieck; 3 - Raute; 4 - Stern; 5 - Kreuz. |
|
| Markierungsgröße | < | 0 | ds.0.marker_size | 0 - (Standard) Klein (6px); 1 - Mittel (9px); 2 - Groß (15px). |
|
| Zeitverschiebung | < | 1 | ds.0.timeshift | Gültige Zeitzeichenfolge (z. B. 3600, 1h usw.).Sie können Zeitsuffixe verwenden. Negative Werte sind ebenfalls zulässig. Standard: "" (leer). |
|
| Aggregationsintervall | < | 1 | ds.0.aggregate_interval | Gültige Zeitzeichenfolge (z. B. 3600, 1h usw.).Sie können Zeitsuffixe verwenden. Standard: 15m. |
|
| Aggregationsfunktion | < | 0 | ds.0.aggregate_function | 0 - nicht verwendet; 1 - min; 2 - max; 3 - (Standard) avg; 4 - count; 5 - sum; 6 - first; 7 - last. |
|
Anzeigeoptionen
Die folgenden Parameter werden für die Konfiguration von Anzeigeoptionen unterstützt.
| Parameter | type | name | value |
|---|---|---|---|
| Auswahl der Verlaufsdaten | 0 | source | 0 - (Standard) Auto; 1 - Verlauf; 2 - Trends. |
| Host-Namen in Beschriftungen | 0 | show_hostnames | 0 - (Standard) Auto; 1 - Anzeigen; 2 - Ausblenden. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird. |
Zeitperiode
Die folgenden Parameter werden für die Konfiguration der Zeitperiode unterstützt.
| Parameter | type | name | value | |
|---|---|---|---|---|
| Zeitperiode | 1 | time_period._reference | DASHBOARD._timeperiod - legt den Zeitperiodenwähler des Dashboards als Datenquelle fest;ABCDE._timeperiod - legt ein kompatibles Widget (dessen Parameter Referenz auf "ABCDE" gesetzt ist) als Datenquelle fest.Standard: DASHBOARD._timeperiodAlternativ können Sie die Zeitperiode 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 Zeitperiode 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 Zeitperiode nicht gesetzt ist - erforderlich, wenn time_period.from gesetzt ist |
|
Achsen
Die folgenden Parameter werden für die Konfiguration von Achsen unterstützt.
| Parameter | type | name | value |
|---|---|---|---|
| X-Achse | 0 | x_axis | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| Y-Achse | 0 | y_axis | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Min | 1 | x_axis_min | Beliebiger numerischer Wert. Standard: "" (leer). |
| y_axis_min | |||
| Max | 1 | x_axis_max | Beliebiger numerischer Wert. Standard: "" (leer). |
| y_axis_max | |||
| Einheiten (Typ) | 0 | x_axis_units | 0 - (Standard) Automatisch; 1 - Statisch. |
| y_axis_units | |||
| Einheiten (Wert) | 1 | x_axis_static_units | Beliebiger Zeichenfolgenwert. Standard: "" (leer). |
| y_axis_static_units |
Legende
Die folgenden Parameter werden für die Konfiguration der Legende unterstützt.
| Parameter | type | name | value |
|---|---|---|---|
| Legende anzeigen | 0 | legend | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| Aggregationsfunktion anzeigen | 0 | legend_aggregation | 0 - (Standard) Deaktiviert; 1 - Aktiviert. Parameterverhalten: - unterstützt, wenn Legende anzeigen auf „Aktiviert“ gesetzt ist |
| Zeilen | 0 | legend_lines_mode | 0 - (Standard) Fest; 1 - Variabel. Parameterverhalten: - unterstützt, wenn Legende anzeigen auf „Aktiviert“ gesetzt ist |
| Anzahl der Zeilen/ Maximale Anzahl der Zeilen |
0 | legend_lines | Mögliche Wertebereich: 1-10. Standard: 1. Parameterverhalten: - unterstützt, wenn Legende anzeigen auf „Aktiviert“ gesetzt ist |
| Anzahl der Spalten | 0 | legend_columns | Mögliche Wertebereich: 1-4. Standard: 4. Parameterverhalten: - unterstützt, wenn Legende anzeigen auf „Aktiviert“ gesetzt ist |
Schwellenwerte
Die folgenden Parameter werden für die Konfiguration von Schwellenwerten unterstützt.
Die Zahl im Eigenschaftsnamen Thresholds (z. B. thresholds.0.color) verweist auf die Position des Schwellenwerts in einer Liste, die in aufsteigender Reihenfolge sortiert ist.
Wenn Schwellenwerte jedoch in einer anderen Reihenfolge konfiguriert werden, werden die Werte nach der Aktualisierung der Widget-Konfiguration im Zabbix Frontend in aufsteigender Reihenfolge sortiert
(z. B. "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parameter | type | name | value |
|---|---|---|---|
| Farbinterpolation | 0 | interpolation | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | thresholds.0.color | Hexadezimaler Farbcode (z. B. FF0000). |
| X-Achse | 1 | thresholds.0.x_axis_threshold | Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt. |
| Y-Achse | 1 | thresholds.0.y_axis_threshold | Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt. |
Beispiele
Die folgenden Beispiele sollen ausschließlich die Konfiguration der Dashboard-Widget-Feldobjekte für das Widget Streudiagramm beschreiben.
Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.
Konfiguration eines Widgets vom Typ Scatter plot
Konfigurieren Sie ein Widget vom Typ Scatter plot wie folgt:
- 5 Datensätze vom Typ „Datenpunkt-Muster“, jeweils mit Standardaggregation (avg, 15m) und unterschiedlichen Markierungen.
- Die Legende zeigt konfigurierte Datenpunkte in einer einzelnen Zeile und zwei Spalten an.
- Schwellenwerte sind so konfiguriert, dass eine Markierung rot eingefärbt wird, wenn ihr Wert auf einer beliebigen Achse 80 erreicht.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "scatterplot",
"name": "Scatter plot",
"x": 0,
"y": 0,
"width": 36,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "ds.0.color",
"value": "0C5A87"
},
{
"type": 1,
"name": "ds.0.hosts.0",
"value": "de-frankfurt*"
},
{
"type": 1,
"name": "ds.0.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.0.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.0.marker",
"value": 0
},
{
"type": 0,
"name": "ds.0.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.1.color",
"value": "66B0D9"
},
{
"type": 1,
"name": "ds.1.hosts.0",
"value": "fr-paris*"
},
{
"type": 1,
"name": "ds.1.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.1.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.1.marker",
"value": 1
},
{
"type": 0,
"name": "ds.1.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.2.color",
"value": "0A466A"
},
{
"type": 1,
"name": "ds.2.hosts.0",
"value": "lv-riga*"
},
{
"type": 1,
"name": "ds.2.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.2.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.2.marker",
"value": 2
},
{
"type": 0,
"name": "ds.2.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.3.color",
"value": "3394C3"
},
{
"type": 1,
"name": "ds.3.hosts.0",
"value": "pl-warsaw*"
},
{
"type": 1,
"name": "ds.3.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.3.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.3.marker",
"value": 3
},
{
"type": 0,
"name": "ds.3.marker_size",
"value": 1
},
{
"type": 1,
"name": "ds.4.color",
"value": "1492C8"
},
{
"type": 1,
"name": "ds.4.hosts.0",
"value": "se-stockholm*"
},
{
"type": 1,
"name": "ds.4.x_axis_items.0",
"value": "Memory utilization"
},
{
"type": 1,
"name": "ds.4.y_axis_items.0",
"value": "CPU utilization"
},
{
"type": 0,
"name": "ds.4.marker",
"value": 4
},
{
"type": 0,
"name": "ds.4.marker_size",
"value": 1
},
{
"type": 0,
"name": "legend_columns",
"value": 2
},
{
"type": 0,
"name": "interpolation",
"value": 1
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.0.x_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "thresholds.0.y_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "D40000"
},
{
"type": 1,
"name": "thresholds.1.x_axis_threshold",
"value": ""
},
{
"type": 1,
"name": "thresholds.1.y_axis_threshold",
"value": "80"
},
{
"type": 1,
"name": "reference",
"value": "JQISY"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}