Auf dieser Seite
11 Honigwabe
Beschreibung
Mit diesen Parametern und den möglichen Eigenschaftswerten für die jeweiligen Feldobjekte des Dashboard-Widgets können Sie das Widget Honeycomb in den Methoden dashboard.create und dashboard.update konfigurieren.
Die Eigenschaften von fields des Widgets werden beim Erstellen oder Aktualisieren 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 sicherzustellen, dass das Widget Honeycomb erfolgreich erstellt oder aktualisiert wird, beachten Sie bitte das in den folgenden Tabellen beschriebene Parameterverhalten.
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
}