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 Honeycomb-Widget unterstützt.

Die Zahl im Eigenschaftsnamen Thresholds (z. B. thresholds.0.color) verweist auf die Position des Schwellenwerts in einer Liste, sortiert in aufsteigender Reihenfolge. 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äres Label
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 von 0 bis 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 von 1 bis 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 object und des 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äres Label
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 von 0 bis 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 von 1 bis 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 object und des 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 des Settings object und des 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