Mapowanie wartości

Przegląd

Mapowanie wartości umożliwia skonfigurowanie bardziej przyjaznej dla użytkownika reprezentacji otrzymanych wartości przy użyciu mapowań między wartościami numerycznymi/tekstowymi a ich reprezentacjami tekstowymi.

Na przykład, gdy wartość pozycji to „0” lub „1”, mapowania wartości mogą zostać użyte do przedstawienia tych wartości w bardziej przyjazny dla użytkownika sposób:

  • 0 → Niedostępne
  • 1 → Dostępne

Mapowania wartości dla typów kopii zapasowych danych mogą zostać skonfigurowane następująco:

  • F → Pełna
  • D → Różnicowa
  • I → Przyrostowa

Zakresy wartości dla napięcia mogą zostać skonfigurowane następująco:

  • <=209 → Niskie
  • 210-230 → OK
  • >=231 → Wysokie

Mapowanie wartości jest używane w frontendzie Zabbix oraz w powiadomieniach wysyłanych przez typy mediów.

Podstawienie otrzymanej wartości skonfigurowaną reprezentacją jest wykonywane zarówno w frontendzie Zabbix, jak i na serwerze; jednak serwer obsługuje podstawienie tylko w następujących przypadkach:

Mapowania wartości są konfigurowane w szablonach lub hostach. Po skonfigurowaniu są dostępne dla wszystkich pozycji w odpowiednim szablonie lub hoście. Podczas konfigurowania pozycji należy podać nazwę wcześniej skonfigurowanego mapowania wartości w parametrze Mapowanie wartości.

Nie ma dziedziczenia mapowań wartości — hosty i szablony nie dziedziczą mapowań wartości z podłączonych szablonów. Pozycje szablonu na hoście będą nadal używać mapowań wartości skonfigurowanych w szablonie.

Mapowania wartości mogą być używane z pozycjami mającymi typ informacji Numeric (unsigned), Numeric (float) oraz Character.

Mapowania wartości są eksportowane/importowane wraz z odpowiednim szablonem lub hostem. Mogą również być masowo aktualizowane przy użyciu formularzy masowej aktualizacji hosta i szablonu.

Konfiguracja

Aby skonfigurować mapowanie wartości, wykonaj następujące kroki:

1. Otwórz formularz konfiguracji hosta lub szablonu.

2. Na karcie Value mapping kliknij Add, aby dodać nowe mapowanie wartości, lub kliknij nazwę istniejącego mapowania, aby je edytować.

Parametry mapowania wartości:

Parameter Description
Name Unikalna nazwa zestawu mapowań wartości.
Mappings Pojedyncze reguły mapowania wartości numerycznych/łańcuchowych na reprezentacje tekstowe.

Mapowanie jest stosowane w kolejności reguł, które można zmieniać metodą przeciągnij i upuść.
Type Typ mapowania:
equals - wartości równe będą mapowane;
is greater than or equals - wartości równe lub większe będą mapowane;
is less than or equals - wartości równe lub mniejsze będą mapowane;
in range - wartości z zakresu będą mapowane; zakres jest wyrażony jako <number1>-<number2> lub <number>; obsługiwanych jest wiele zakresów (na przykład 1-10,101-110,201);
regexp - wartości odpowiadające wyrażeniu regularnemu będą mapowane (globalne wyrażenia regularne nie są obsługiwane);
default - wszystkie pozostałe wartości zostaną zmapowane, z wyjątkiem tych z określonym mapowaniem.

W przypadku mapowania zakresów obsługiwane są tylko numeryczne typy wartości (is greater than or equals, is less than or equals, in range).
Value Wartość wejściowa (może zawierać zakres lub wyrażenie regularne, zależnie od typu mapowania).
Mapped to Reprezentacja tekstowa (do 64 znaków) dla wartości wejściowej.

Wszystkie wymagane pola wejściowe są oznaczone czerwoną gwiazdką.

Podczas wyświetlania mapowania wartości na liście widoczne są tylko trzy pierwsze mapowania, a trzy kropki wskazują, że istnieją kolejne mapowania.

Przykład mapowania wartości

Jedna z predefiniowanych pozycji agenta Zabbix agent ping używa mapowania wartości na poziomie szablonu "Zabbix agent ping status", aby wyświetlać swoje wartości.

W formularzu konfiguracji pozycji można znaleźć odwołanie do tego mapowania wartości w polu Mapowanie wartości:

To mapowanie jest używane w sekcji Monitoring > Latest data do wyświetlania "Up" (z wartością surową w nawiasach).

W sekcji Latest data wyświetlane wartości są skracane do 20 symboli. Jeśli używane jest mapowanie wartości, to skracanie nie jest stosowane do zmapowanej wartości, lecz tylko do wartości surowej (wyświetlanej w nawiasach).

Bez predefiniowanego mapowania wartości widoczna byłaby tylko wartość "1", co może być trudne do zrozumienia.