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

Gehen Sie wie folgt vor, um eine Wertezuordnung zu konfigurieren:

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

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

Parameter einer Wertezuordnung:

Parameter Beschreibung
Name Eindeutiger Name für die Menge der Wertezuordnungen.
Zuordnungen Einzelne Regeln für die Zuordnung numerischer/String-Werte zu String-Darstellungen.

Die Zuordnung wird in der Reihenfolge der Regeln angewendet, die per Ziehen neu angeordnet werden können.
Typ Zuordnungstyp:
gleich - gleiche Werte werden zugeordnet;
ist größer oder gleich - gleiche oder größere Werte werden zugeordnet;
ist kleiner oder gleich - gleiche oder kleinere Werte werden zugeordnet;
im Bereich - Werte im Bereich 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);
Standard - alle übrigen Werte werden zugeordnet, außer denen mit spezifischen Zuordnungen.

Für Bereichszuordnungen werden nur numerische Werttypen (ist größer oder gleich, ist kleiner oder gleich, im Bereich) unterstützt.
Wert Eingehender Wert (kann je nach Zuordnungstyp einen Bereich oder einen regulären Ausdruck enthalten).
Zugeordnet zu String-Darstellung (bis zu 64 Zeichen) für den eingehenden Wert.

Alle erforderlichen Eingabefelder sind mit einem roten Sternchen markiert.

Bei der Anzeige der Wertezuordnung 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.