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.
Host-Gruppen 2 groupids.0 ID der Host-Gruppe.

Hinweis: Um mehrere Host-Gruppen zu konfigurieren, erstellen Sie für jede Host-Gruppe ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Host-Gruppen (Widget) 1 groupids._reference Anstelle der ID der Host-Gruppe:
ABCDE._hostgroupids - ein kompatibles Widget (mit dem Parameter Referenz auf "ABCDE" gesetzt) als Datenquelle für Host-Gruppen festlegen.

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Hosts 3 hostids.0 ID des Hosts.

Hinweis: Um mehrere Hosts zu konfigurieren, erstellen Sie für jeden Host ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen. Bei mehreren Hosts darf der Parameter Host-Gruppen entweder gar nicht konfiguriert sein oder muss mit mindestens einer Host-Gruppe konfiguriert sein, 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 ID des Hosts:
DASHBOARD.hostids - die Host-Auswahl des Dashboards als Datenquelle für Hosts festlegen;
ABCDE._hostids - ein kompatibles Widget (mit dem Parameter Referenz auf "ABCDE" gesetzt) als Datenquelle für Hosts festlegen.

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 Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

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 Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

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 Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Host-Tags

Dieser Parameter wird nicht unterstützt, wenn das Widget auf einem Vorlagen-Dashboard konfiguriert wird.
Datenpunkt-Muster 1 items.0 Name oder Muster des Datenpunkts.

Hinweis: Um mehrere Datenpunkt-Muster zu konfigurieren, erstellen Sie für jedes Datenpunkt-Muster ein Dashboard-Widget-Feldobjekt mit einer inkrementierten Nummer im Eigenschaftsnamen.

Parameterverhalten:
- erforderlich
Datenpunkt-Tags
Auswertungstyp 0 evaltype_item 0 - (Standard) Und/Oder;
2 - Oder.
Tag-Name 1 item_tags.0.tag Beliebiger Zeichenfolgenwert.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Datenpunkt-Tags
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 Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Datenpunkt-Tags
Tag-Wert 1 item_tags.0.value Beliebiger Zeichenfolgenwert.

Hinweis: Die Nummer im Eigenschaftsnamen verweist auf die Tag-Reihenfolge in der Tag-Auswertungsliste.

Parameterverhalten:
- erforderlich bei Konfiguration von Datenpunkt-Tags
Hosts in Wartung anzeigen 0 maintenance 0 - (Standard) Deaktiviert;
1 - Aktiviert.
Anzeigen 0 show.0 1 - Primäre Beschriftung;
2 - Sekundäre Beschriftung.

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.
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 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 sind, werden die Werte nach dem Aktualisieren 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
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 im Bereich 0-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 im Bereich 1-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 von Settings object und User object:
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" gesetzt ist 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" gesetzt ist 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 im Bereich 0-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 im Bereich 1-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 von Settings object und User object:
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" gesetzt ist 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" gesetzt ist 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 von Settings object und User object:
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.

Anfrage:

{
    "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
}

Siehe auch