[comment]: # translation:outdated

[comment]: # ({2224a200-e8992262})
# 8 Wertezuordnung

[comment]: # ({/2224a200-e8992262})

[comment]: # ({cb8222c8-2d2da55e})
#### Ü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.

::: noteimportant
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:<br><br>

- beim Befüllen des [Host-Inventars](/manual/config/hosts/inventory#inventory-overview);
- beim Erweitern [unterstützter Makros](/manual/appendix/macros/supported_by_location) {ITEM.VALUE}, {ITEM.LASTVALUE}, {EVENT.OPDATA} und {EVENT.CAUSE.OPDATA}.
:::

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](/manual/config/items/item#configuration) geben Sie im Parameter *Wertezuordnung* den Namen einer zuvor konfigurierten Wertezuordnung an.

::: noteclassic
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.
:::

::: noteclassic
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](/manual/config/hosts/hostupdate) und [Vorlagen](/manual/config/templates/mass) massenhaft aktualisiert werden.

[comment]: # ({/cb8222c8-2d2da55e})

[comment]: # ({158cd610-18d7ef55})
#### 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.

![](../../../../assets/en/manual/config/items/value_mapping.png)

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.<br><br>Die Zuordnung wird in der Reihenfolge der Regeln angewendet, die per Ziehen neu angeordnet werden können.|
| |*Typ*|Zuordnungstyp:<br>**gleich** - gleiche Werte werden zugeordnet;<br>**ist größer oder gleich** - gleiche oder größere Werte werden zugeordnet;<br>**ist kleiner oder gleich** - gleiche oder kleinere Werte werden zugeordnet;<br>**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);<br>**regexp** - Werte, die dem [regulären Ausdruck](/manual/regular_expressions) entsprechen, werden zugeordnet (globale reguläre Ausdrücke werden nicht unterstützt);<br>**Standard** - alle übrigen Werte werden zugeordnet, außer denen mit spezifischen Zuordnungen.<br><br>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.

![](../../../../assets/en/manual/config/items/value_map_list.png)

[comment]: # ({/158cd610-18d7ef55})

[comment]: # ({74c7cb6d-6241051d})
#### 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.

![](../../../../assets/en/manual/config/items/value_mapping2.png)

Im [Konfigurationsformular](/manual/config/items/item#configuration) des Datenpunkts finden Sie im Feld *Value mapping* einen Verweis auf diese Wertzuordnung:

![](../../../../assets/en/manual/config/items/item_value_mapping.png)

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

![](../../../../assets/en/manual/config/items/value_display.png){width="600"}

::: noteclassic
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.

![](../../../../assets/en/manual/config/items/value_display2.png){width="600"}

[comment]: # ({/74c7cb6d-6241051d})
