8 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 liczbowych/ł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 zapisywany jako <number1>-<number2> lub <number>; obsługiwane są 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ślonymi mapowaniami.

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 obowiązkowe pola wejściowe są oznaczone czerwoną gwiazdką.

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

Przykład mapowania wartości

Jedna ze wstępnie zdefiniowanych pozycji agenta, Zabbix agent ping, używa mapowania wartości na poziomie szablonu „Zabbix agent ping status” do wyświetlania swoich 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 → Najnowsze dane do wyświetlania „Up” (z surową wartością w nawiasach).

W sekcji Najnowsze dane wyświetlane wartości są skracane do 20 znaków. Jeśli używane jest mapowanie wartości, to skrócenie nie jest stosowane do zmapowanej wartości, lecz tylko do surowej wartości (wyświetlanej w nawiasach).

Bez wstępnie zdefiniowanego mapowania wartości widoczne byłoby tylko „1”, co mogłoby być trudne do zrozumienia.