Auf dieser Seite
11 Honigwabe
Beschreibung
Diese Parameter und die möglichen Eigenschaftswerte für die jeweiligen Dashboard-Widget-Feldobjekte ermöglichen die Konfiguration des Widgets Honeycomb in den Methoden dashboard.create und dashboard.update.
Die Eigenschaften von Widget-fields werden beim Erstellen oder Aktualisieren 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 Honeycomb sicherzustellen, beachten Sie bitte das in den folgenden Tabellen beschriebene Verhalten der Parameter.
Parameter
Die folgenden Parameter werden für das Honeycomb-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. |
|
| Hostgruppen | 2 | groupids.0 | Hostgruppe-ID. Hinweis: Um mehrere Hostgruppen zu konfigurieren, erstellen Sie für jede Hostgruppe ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird. |
|
| Hostgruppen (Widget) | 1 | groupids._reference | Anstelle der Hostgruppe-ID:ABCDE._hostgroupids - setzen Sie ein kompatibles Widget (mit dem Parameter Reference auf "ABCDE") als Datenquelle für Hostgruppen.Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-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 Hostgruppen entweder gar nicht konfiguriert sein oder mindestens eine Hostgruppe enthalten, zu der die konfigurierten Hosts gehören. Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird. |
|
| Hosts (Widget/Dashboard) | 1 | hostids._reference | Anstelle der Host-ID:DASHBOARD.hostids - setzen Sie den Host-Selektor als Datenquelle für Hosts;ABCDE._hostids - 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 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 auf 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 auf 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 auf 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 auf einem Vorlagen-Dashboard konfiguriert wird. |
|
| Item-Muster | 1 | items.0 | Datenpunkt-Name oder -Muster. Hinweis: Um mehrere Item-Muster zu konfigurieren, erstellen Sie für jedes Item-Muster ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Parameterverhalten: - erforderlich |
|
| Item-Tags | ||||
| Auswertungstyp | 0 | evaltype_item | 0 - (Standard) Und/Oder; 2 - Oder. |
|
| 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 - 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 Item-Tags konfiguriert werden |
|
| Tag-Wert | 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 |
|
| Hosts in Wartung anzeigen | 0 | maintenance | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
|
| Anzeigen | 0 | show.0 | 1 - Primäres Label; 2 - Sekundäres Label. Hinweis: Um mehrere Werte zu konfigurieren, erstellen Sie für jeden Wert ein Dashboard-Widget-Feldobjekt mit einer erhöhten Zahl im Eigenschaftsnamen. Standard: 1, 2. |
|
| Referenz | 1 | reference | Beliebiger Zeichenfolgenwert mit 5 Zeichen (z. B. ABCDE oder JBPNL). Dieser Wert muss innerhalb des Dashboards, zu dem das Widget gehört, eindeutig sein.Parameterverhalten: - erforderlich |
|
Erweiterte Konfiguration
Die folgenden erweiterten Konfigurationsparameter werden für das Widget Honeycomb unterstützt.
Die Zahl im Namen der Eigenschaft Schwellenwerte (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 |
|---|---|---|---|
| Primäre Beschriftung | |||
| Typ | 0 | primary_label_type | 0 - (Standard) Text; 1 - Wert. |
| Text | 1 | primary_label | Beliebiger Zeichenfolgenwert, einschließlich Makros. Unterstützte Makros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Benutzermakros. Standard: {HOST.NAME} Parameterverhalten: - unterstützt, wenn Typ auf „Text“ gesetzt ist |
| Dezimalstellen | 0 | primary_label_decimal_places | Mögliche Werte liegen zwischen 0 und 6. Standard: 2. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ gesetzt ist |
| Größe (Typ) | 0 | primary_label_size_type | 0 - (Standard) Automatisch; 1 - Benutzerdefiniert. |
| Größe | 0 | primary_label_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 20. Parameterverhalten: - unterstützt, wenn Größe (Typ) auf „Benutzerdefiniert“ gesetzt ist |
| Fett | 0 | primary_label_bold | 0 - (Standard) Deaktiviert; 1 - Aktiviert. |
| Farbe | 1 | primary_label_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: basierend auf theme des Settings-Objekts und des Benutzerobjekts:1F2C33 für „blue-theme“ oder „hc-light“;EEEEEE für „dark-theme“ oder „hc-dark“. |
| Einheiten (Kontrollkästchen) | 0 | primary_label_units_show | 0 - Deaktiviert; 1 - (Standard) Aktiviert. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ gesetzt ist |
| Einheiten (Wert) | 1 | primary_label_units | Beliebiger Zeichenfolgenwert."" (leer)Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ und Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist |
| Position | 0 | primary_label_units_pos | 0 - Vor dem Wert; 1 - (Standard) Nach dem Wert. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ und Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist Dieser Parameter wird ignoriert, wenn er auf eine der folgenden zeitbezogenen Einheiten gesetzt ist: unixtime, uptime, s. |
| Sekundäre Beschriftung | |||
| Typ | 0 | secondary_label_type | 0 - Text; 1 - (Standard) Wert. |
| Text | 1 | secondary_label | Beliebiger Zeichenfolgenwert, einschließlich Makros. Unterstützte Makros: {HOST.*}, {ITEM.*}, {INVENTORY.*}, Benutzermakros. Standard: {{ITEM.LASTVALUE}.fmtnum(2)} Parameterverhalten: - unterstützt, wenn Typ auf „Text“ gesetzt ist |
| Dezimalstellen | 0 | secondary_label_decimal_places | Mögliche Werte liegen zwischen 0 und 6. Standard: 2. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ gesetzt ist |
| Größe (Typ) | 0 | secondary_label_size_type | 0 - (Standard) Automatisch; 1 - Benutzerdefiniert. |
| Größe | 0 | secondary_label_size | Mögliche Werte liegen zwischen 1 und 100. Standard: 30. Parameterverhalten: - unterstützt, wenn Größe (Typ) auf „Benutzerdefiniert“ gesetzt ist |
| Fett | 0 | secondary_label_bold | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| Farbe | 1 | secondary_label_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: basierend auf theme des Settings-Objekts und des Benutzerobjekts:1F2C33 für „blue-theme“ oder „hc-light“;EEEEEE für „dark-theme“ oder „hc-dark“. |
| Einheiten (Kontrollkästchen) | 0 | secondary_label_units_show | 0 - Deaktiviert; 1 - (Standard) Aktiviert. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ gesetzt ist |
| Einheiten (Wert) | 1 | secondary_label_units | Beliebiger Zeichenfolgenwert."" (leer)Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ und Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist |
| Position | 0 | secondary_label_position | 0 - Vor dem Wert; 1 - (Standard) Nach dem Wert. Parameterverhalten: - unterstützt, wenn Typ auf „Wert“ und Einheiten (Kontrollkästchen) auf „Aktiviert“ gesetzt ist Dieser Parameter wird ignoriert, wenn er auf eine der folgenden zeitbezogenen Einheiten gesetzt ist: unixtime, uptime, s. |
| Hintergrundfarbe | |||
| Hintergrundfarbe | 1 | bg_color | Hexadezimaler Farbcode (z. B. FF0000).Standard: basierend auf theme des Settings-Objekts und des Benutzerobjekts:D9E7ED für „blue-theme“;3D5059 für „dark-theme“;AAD7E9 für „hc-light“;335463 für „hc-dark“. |
| Schwellenwerte | |||
| Farbinterpolation | 0 | interpolation | 0 - Deaktiviert; 1 - (Standard) Aktiviert. |
| 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. |
Beispiele
Die folgenden Beispiele beschreiben nur die Konfiguration der Dashboard-Widget-Feldobjekte für das Honeycomb -Widget.
Für weitere Informationen zur Konfiguration eines Dashboards siehe dashboard.create.
Konfigurieren eines Honeycomb-Widgets
Konfigurieren Sie ein Honeycomb-Widget, das die Auslastung von Zabbix-Serverprozessen anzeigt. Ändern Sie außerdem die primäre Beschriftung der Honeycomb-Zellen und passen Sie das Widget visuell mit Schwellenwerten an.
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "honeycomb",
"name": "Honeycomb",
"x": "0",
"y": "0",
"width": "24",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 2,
"name": "groupids.0",
"value": 4
},
{
"type": 3,
"name": "hostids.0",
"value": 10084
},
{
"type": 1,
"name": "items.0",
"value": "Zabbix server: Utilization*"
},
{
"type": 1,
"name": "primary_label",
"value": "{ITEM.NAME}"
},
{
"type": 1,
"name": "thresholds.0.color",
"value": "0EC9AC"
},
{
"type": 1,
"name": "thresholds.0.threshold",
"value": "0"
},
{
"type": 1,
"name": "thresholds.1.color",
"value": "FFD54F"
},
{
"type": 1,
"name": "thresholds.1.threshold",
"value": "70"
},
{
"type": 1,
"name": "thresholds.2.color",
"value": "FF465C"
},
{
"type": 1,
"name": "thresholds.2.threshold",
"value": "90"
},
{
"type": 1,
"name": "reference",
"value": "KSTMQ"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}