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 Poszczególne reguły mapowania wartości liczbowych/ciągów znaków na reprezentacje ciągów znaków.

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

W przypadku mapowania zakresów obsługiwane są tylko typy wartości liczbowe (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 w postaci ciągu znaków (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 istnieje więcej mapowań.

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 wartości „Up” (z wartością surową w nawiasach).

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

Bez wstępnie zdefiniowanego mapowania wartości widoczna byłaby tylko wartość „1”, której zrozumienie może być trudne.