On this page
6 Pegel
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration
des Widgets Gauge 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 es 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 Gauge sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
Parameter
Die folgenden Parameter werden für das Gauge-Widget 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. |
|
| Datenpunkt | 4 | itemid.0 | ID des Datenpunkts. Parameterverhalten: - erforderlich, wenn Datenpunkt (Widget) nicht gesetzt ist |
|
| Datenpunkt (Widget) | 1 | itemid._reference | Anstelle der ID des Datenpunkts:ABCDE._itemid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Datenpunkte fest.Parameterverhalten: - erforderlich, wenn Datenpunkt nicht gesetzt ist |
|
| Min | 1 | min | Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt. Standard: "0". |
|
| Max | 1 | max | Beliebiger numerischer Wert. Suffixe (z. B. "1d", "2w", "4K", "8G") werden unterstützt. Standard: "100". |
|
| Wertbogen | 1 | value_arc_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
|
| Bogenhintergrund | 1 | empty_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
|
| Hintergrund | 1 | bg_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
|
| Anzeigen | 0 | show.0 | 1 - Beschreibung; 2 - Wert; 3 - Zeiger; 4 - Skala; 5 - Wertbogen. Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen. Standard: 1, 2, 4, 5. Die Werte "Zeiger" und "Skala" werden nicht unterstützt, wenn beides zutrifft: - kein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert "Wertbogen" gesetzt ist; - der Parameter Bogen anzeigen der erweiterten Konfiguration auf "Deaktiviert" gesetzt ist. Parameter der erweiterten Konfiguration für Anzeigen-Optionen werden nicht unterstützt, wenn keine Dashboard-Widget-Feldobjekte mit den jeweiligen Werten gesetzt sind. |
|
| Host überschreiben | 1 | override_hostid._reference | ABCDE._hostid - legt ein kompatibles Widget (mit dem auf "ABCDE" gesetzten Parameter Referenz) als Datenquelle für Hosts fest;DASHBOARD._hostid - legt die Host-Auswahl des Dashboards als Datenquelle für Hosts fest.Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird. |
|
Erweiterte Konfiguration
Die folgenden erweiterten Konfigurationsparameter werden für das Widget Gauge unterstützt.
Die Zahl im Namen der Eigenschaft Thresholds (z. B. thresholds.0.color) verweist auf die Position des Schwellenwerts in einer aufsteigend sortierten Liste.
Wenn die Schwellenwerte jedoch in einer anderen Reihenfolge konfiguriert werden, werden die Werte nach der Aktualisierung der Widget-Konfiguration im Zabbix Frontend aufsteigend sortiert
(z. B. "thresholds.0.threshold":"5" → "thresholds.0.threshold":"1"; "thresholds.1.threshold":"1" → "thresholds.1.threshold": "5").
| Parameter | type | name | value |
|---|---|---|---|
| Winkel | 0 | angle | Mögliche Werte: 180 (Standard) oder 270. |
| Beschreibung | |||
| Beschreibung | 1 | description | Beliebiger Zeichenfolgenwert, einschließlich Makros. Unterstützte Makros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Benutzermakros.Standard: {ITEM.NAME}. |
| Größe | 0 | desc_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 15. |
| Vertikale Position | 0 | desc_v_pos | 0 - Oben; 1 - (Standard) Unten. |
| Fett | 0 | desc_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | desc_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
| Wert | |||
| Dezimalstellen | 0 | decimal_places | Mögliche Werte liegen zwischen 1 und 10. Standard: 2. |
| Größe | 0 | value_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 25. |
| Fett | 0 | value_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | value_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
| Einheiten | |||
| Einheiten (Kontrollkästchen) | 0 | units_show | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| Einheiten (Wert) | 1 | units | Beliebiger Zeichenfolgenwert. Parameterverhalten: - unterstützt, wenn Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist |
| Größe | 0 | units_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 25. Parameterverhalten: - unterstützt, wenn Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist |
| Fett | 0 | units_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. Parameterverhalten: - unterstützt, wenn Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist |
| Position | 0 | units_pos | 0 - Vor dem Wert; 1 - Über dem Wert; 2 - (Standard) Nach dem Wert; 3 - Unter dem Wert. Parameterverhalten: - unterstützt, wenn Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist Dieser Parameter wird ignoriert, wenn eine der folgenden zeitbezogenen Einheiten festgelegt ist: unixtime, uptime, s. |
| Farbe | 1 | units_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer). |
| Wertbogen | |||
| Bogengröße | 0 | value_arc_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 20. |
| Zeiger | |||
| Farbe | 1 | needle_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: "" (leer).Parameterverhalten: - unterstützt, wenn ein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert „Wertbogen“ festgelegt ist oder Bogen anzeigen auf „Aktiviert“ gesetzt ist |
| Skala | |||
| Einheiten anzeigen | 0 | scale_show_units | 0 - Deaktiviert; 1 - (Standard) Aktiviert. Parameterverhalten: - unterstützt, wenn Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist und entweder ein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert „Wertbogen“ festgelegt ist oder Bogen anzeigen auf „Aktiviert“ gesetzt ist |
| Größe | 0 | scale_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 15. Parameterverhalten: - unterstützt, wenn ein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert „Wertbogen“ festgelegt ist oder Bogen anzeigen auf „Aktiviert“ gesetzt ist |
| Dezimalstellen | 0 | scale_decimal_places | Mögliche Werte liegen zwischen 1 und 10. Standard: 0. Parameterverhalten: - unterstützt, wenn ein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert „Wertbogen“ festgelegt ist oder Bogen anzeigen auf „Aktiviert“ gesetzt ist |
| Schwellenwerte | |||
| Farbe | 1 | thresholds.0.color | Hexadezimaler Farbcode (z. B. FF0000). |
| Schwellenwert | 1 | thresholds.0.threshold | Beliebiger numerischer Wert. Suffixe (z. B. „1d“, „2w“, „4K“, „8G“) werden unterstützt. |
| Beschriftungen anzeigen | 0 | th_show_labels | 0 - (Standard) Deaktiviert; 1 - Aktiviert. Parameterverhalten: - unterstützt, wenn Schwellenwerte festgelegt sind und entweder ein Dashboard-Widget-Feldobjekt für Anzeigen mit dem Wert „Wertbogen“ festgelegt ist oder Bogen anzeigen auf „Aktiviert“ gesetzt ist |
| Bogen anzeigen | 0 | th_show_arc | 0 - (Standard) Deaktiviert; 1 - Aktiviert. Parameterverhalten: - unterstützt, wenn Schwellenwerte festgelegt sind |
| Bogengröße | 0 | th_arc_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 5. Parameterverhalten: - unterstützt, wenn Bogen anzeigen auf „Aktiviert“ gesetzt ist |
Beispiele
Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das Gauge-Widget.
Weitere Informationen zur Konfiguration eines Dashboards finden Sie unter dashboard.create.
Konfigurieren eines Gauge-Widgets
Konfigurieren Sie ein Gauge-Widget, das den Datenpunktwert für den Datenpunkt „44474“ (Schnittstelle enp0s3: Gesendete Bits) anzeigt. Zusätzlich können Sie das Widget mit mehreren erweiterten Optionen, einschließlich Schwellenwerten, visuell feinabstimmen.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "gauge",
"name": "Gauge",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 4,
"name": "itemid.0",
"value": 44474
},
{
"type": 1,
"name": "min",
"value": "100000"
},
{
"type": 1,
"name": "max",
"value": "1000000"
},
{
"type": 0,
"name": "show.0",
"value": 1
},
{
"type": 0,
"name": "show.1",
"value": 2
},
{
"type": 0,
"name": "show.2",
"value": 3
},
{
"type": 0,
"name": "show.4",
"value": 4
},
{
"type": 0,
"name": "show.5",
"value": 5
},
{
"type": 0,
"name": "angle",
"value": 270
},
{
"type": 0,
"name": "desc_size",
"value": 10
},
{
"type": 0,
"name": "desc_bold",
"value": 1
},
{
"type": 0,
"name": "decimal_places",
"value": 0
},
{
"type": 0,
"name": "value_bold",
"value": 1
},
{
"type": 0,
"name": "units_size",
"value": 15
},
{
"type": 0,
"name": "units_pos",
"value": 3
},
{
"type": 1,
"name": "needle_color",
"value": "3C3C3C"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "700000"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "500000"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "100000"
},
{
"type": 0,
"name": "th_show_labels",
"value": 1
},
{
"type": 0,
"name": "th_show_arc",
"value": 1
},
{
"type": 0,
"name": "th_arc_size",
"value": 15
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}