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 Mapowanie wartości kliknij Dodaj, aby dodać nowe mapowanie wartości, lub kliknij nazwę istniejącego mapowania, aby je edytować.

Parametry mapowania wartości:

Parametr Opis
Nazwa Unikalna nazwa zestawu mapowań wartości.
Mapowania Poszczególne reguły mapowania wartości numerycznych/ciągów znaków na reprezentacje tekstowe.

Mapowanie jest stosowane zgodnie z kolejnością reguł, którą można zmieniać przez przeciąganie.
Typ Typ mapowania:
równa się - równe wartości zostaną zmapowane;
jest większe lub równe - równe lub większe wartości zostaną zmapowane;
jest mniejsze lub równe - równe lub mniejsze wartości zostaną zmapowane;
w zakresie - wartości z zakresu zostaną zmapowane; zakres jest wyrażany 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 zostaną zmapowane (globalne wyrażenia regularne nie są obsługiwane);
domyślne - wszystkie pozostałe wartości zostaną zmapowane, inne niż te ze zdefiniowanymi mapowaniami.

W przypadku mapowania zakresów obsługiwane są tylko numeryczne typy wartości (jest większe lub równe, jest mniejsze lub równe, w zakresie).
Wartość Wartość przychodząca (może zawierać zakres lub wyrażenie regularne, w zależności od typu mapowania).
Mapowane na Reprezentacja tekstowa (do 64 znaków) dla wartości przychodzącej.

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.