8 Wertezuordnung

Übersicht

Mit der Wertezuordnung lässt sich eine benutzerfreundlichere Darstellung empfangener Werte konfigurieren, indem Zuordnungen zwischen numerischen/Zeichenfolgenwerten und Zeichenfolgendarstellungen verwendet werden.

Wenn der Wert eines Datenpunkts beispielsweise „0“ oder „1“ ist, können Wertezuordnungen verwendet werden, um diese Werte benutzerfreundlicher darzustellen:

  • 0 → Nicht verfügbar
  • 1 → Verfügbar

Wertezuordnungen für Datensicherungstypen könnten beispielsweise wie folgt konfiguriert werden:

  • F → Vollständig
  • D → Differenziell
  • I → Inkrementell

Wertebereiche für Spannung könnten beispielsweise wie folgt konfiguriert werden:

  • <=209 → Niedrig
  • 210-230 → OK
  • >=231 → Hoch

Die Wertezuordnung wird im Zabbix Frontend und in Benachrichtigungen verwendet, die von Medientypen gesendet werden.

Die Ersetzung des empfangenen Werts durch die konfigurierte Darstellung erfolgt sowohl im Zabbix Frontend als auch auf dem Server; der Server verarbeitet die Ersetzung jedoch nur in den folgenden Fällen:

Wertezuordnungen werden auf Vorlagen oder Hosts eingerichtet. Nach der Konfiguration stehen sie für alle Datenpunkte innerhalb der jeweiligen Vorlage oder des jeweiligen Hosts zur Verfügung. Beim Konfigurieren von Datenpunkten geben Sie im Parameter Wertezuordnung den Namen einer zuvor konfigurierten Wertezuordnung an.

Es gibt keine Vererbung von Wertezuordnungen – Hosts und Vorlagen übernehmen keine Wertezuordnungen aus verknüpften Vorlagen. Vorlagen-Datenpunkte auf einem Host verwenden weiterhin die auf der Vorlage konfigurierten Wertezuordnungen.

Wertezuordnungen können mit Datenpunkten verwendet werden, die die Informationstypen Numerisch (Ganzzahl ohne Vorzeichen), Numerisch (Gleitkommazahl) und Zeichen haben.

Wertezuordnungen werden zusammen mit der jeweiligen Vorlage oder dem jeweiligen Host exportiert/importiert. Sie können auch mithilfe der Formulare zur Massenaktualisierung für Hosts und Vorlagen massenhaft aktualisiert werden.

Konfiguration

Um eine Wertzuordnung zu konfigurieren, gehen Sie wie folgt vor:

1. Öffnen Sie das Konfigurationsformular des Hosts oder der Vorlage.

2. Klicken Sie auf der Registerkarte Value mapping auf Add, um eine neue Wertzuordnung hinzuzufügen, oder klicken Sie auf den Namen einer vorhandenen Zuordnung, um sie zu bearbeiten.

Parameter einer Wertzuordnung:

Parameter Beschreibung
Name Eindeutiger Name für den Satz von Wertzuordnungen.
Mappings Einzelne Regeln zum Zuordnen numerischer/String-Werte zu Zeichenfolgendarstellungen.

Die Zuordnung wird in der Reihenfolge der Regeln angewendet, die per Drag-and-drop neu angeordnet werden können.
Type Zuordnungstyp:
equals - gleiche Werte werden zugeordnet;
is greater than or equals - gleiche oder größere Werte werden zugeordnet;
is less than or equals - gleiche oder kleinere Werte werden zugeordnet;
in range - Werte innerhalb eines Bereichs werden zugeordnet; der Bereich wird als <number1>-<number2> oder <number> angegeben; mehrere Bereiche werden unterstützt (zum Beispiel 1-10,101-110,201);
regexp - Werte, die dem regulären Ausdruck entsprechen, werden zugeordnet (globale reguläre Ausdrücke werden nicht unterstützt);
default - alle übrigen Werte werden zugeordnet, außer denen mit spezifischen Zuordnungen.

Für Bereichszuordnungen werden nur numerische Werttypen (is greater than or equals, is less than or equals, in range) unterstützt.
Value Eingehender Wert (kann je nach Zuordnungstyp einen Bereich oder regulären Ausdruck enthalten).
Mapped to Zeichenfolgendarstellung (bis zu 64 Zeichen) für den eingehenden Wert.

Alle Pflichtfelder sind mit einem roten Sternchen markiert.

Beim Anzeigen der Wertzuordnung in der Liste sind nur die ersten drei Zuordnungen sichtbar; drei Punkte zeigen an, dass weitere Zuordnungen vorhanden sind.

Beispiel für Wertzuordnung

Einer der vordefinierten Agent-Datenpunkte, Zabbix agent ping, verwendet eine Wertzuordnung auf Vorlagenebene „Zabbix agent ping status“, um seine Werte anzuzeigen.

Im Konfigurationsformular des Datenpunkts finden Sie im Feld Value mapping einen Verweis auf diese Wertzuordnung:

Diese Zuordnung wird im Abschnitt Monitoring → Latest data verwendet, um „Up“ anzuzeigen (mit dem Rohwert in Klammern).

Im Abschnitt Latest data werden angezeigte Werte auf 20 Zeichen gekürzt. Wenn eine Wertzuordnung verwendet wird, wird diese Kürzung nicht auf den zugeordneten Wert angewendet, sondern nur auf den Rohwert (in Klammern angezeigt).

Ohne eine vordefinierte Wertzuordnung würden Sie nur „1“ sehen, was möglicherweise schwer zu verstehen ist.