8 Преобразование значений

Обзор

Сопоставление значений позволяет настроить более удобное для пользователя представление полученных значений с помощью сопоставлений между числовыми/строковыми значениями и их строковыми представлениями.

Например, когда значение элемента данных равно "0" или "1", сопоставления значений можно использовать для более удобного представления этих значений:

  • 0 → Недоступно
  • 1 → Доступно

Сопоставления значений для типов резервного копирования данных могут быть настроены следующим образом:

  • F → Полное
  • D → Дифференциальное
  • I → Инкрементальное

Диапазоны значений напряжения могут быть настроены следующим образом:

  • <=209 → Низкое
  • 210-230 → Норма
  • >=231 → Высокое

Сопоставление значений используется в веб-интерфейсе Zabbix и в уведомлениях, отправляемых способами оповещения.

Подстановка полученного значения настроенным представлением выполняется как в веб-интерфейсе Zabbix, так и на сервере; однако сервер выполняет подстановку только в следующих случаях:

Сопоставления значений настраиваются в шаблонах или на узлах сети. После настройки они доступны для всех элементов данных в соответствующем шаблоне или на узле сети. При настройке элементов данных укажите имя ранее настроенного сопоставления значений в параметре Value mapping.

Наследование сопоставлений значений отсутствует — узлы сети и шаблоны не наследуют сопоставления значений из связанных шаблонов. Элементы данных шаблона на узле сети продолжат использовать сопоставления значений, настроенные в шаблоне.

Сопоставления значений можно использовать с элементами данных, имеющими тип информации Numeric (unsigned), Numeric (float) и Character.

Сопоставления значений экспортируются/импортируются вместе с соответствующим шаблоном или узлом сети. Их также можно массово обновлять с помощью форм массового обновления узлов сети и шаблонов.

Настройка

Чтобы настроить сопоставление значений, выполните следующие шаги:

1. Откройте форму настройки узла сети или шаблона.

2. На вкладке Value mapping нажмите Add, чтобы добавить новое сопоставление значений, или нажмите на имя существующего сопоставления, чтобы изменить его.

Параметры сопоставления значений:

Параметр Описание
Name Уникальное имя для набора сопоставлений значений.
Mappings Отдельные правила для сопоставления числовых/строковых значений со строковыми представлениями.

Сопоставление применяется в порядке правил, который можно изменять перетаскиванием.
Type Тип сопоставления:
equals - будут сопоставлены равные значения;
is greater than or equals - будут сопоставлены равные или большие значения;
is less than or equals - будут сопоставлены равные или меньшие значения;
in range - будут сопоставлены значения в диапазоне; диапазон задается как <number1>-<number2> или <number>; поддерживается несколько диапазонов (например, 1-10,101-110,201);
regexp - будут сопоставлены значения, соответствующие регулярному выражению (глобальные регулярные выражения не поддерживаются);
default - будут сопоставлены все остальные значения, кроме тех, для которых заданы конкретные сопоставления.

Для сопоставления диапазонов поддерживаются только числовые типы значений (is greater than or equals, is less than or equals, in range).
Value Входящее значение (может содержать диапазон или регулярное выражение, в зависимости от типа сопоставления).
Mapped to Строковое представление (до 64 символов) для входящего значения.

Все обязательные поля ввода отмечены красной звездочкой.

При просмотре сопоставления значений в списке видны только первые три сопоставления, а три точки указывают на наличие дополнительных сопоставлений.

Пример сопоставления значений

Один из предопределённых элементов данных агента Zabbix agent ping использует сопоставление значений уровня шаблона "Zabbix agent ping status" для отображения своих значений.

В форме настройки элемента данных вы можете найти ссылку на это сопоставление значений в поле Value mapping:

Это сопоставление используется в разделе Мониторинг → Последние данные для отображения "Up" (с исходным значением в скобках).

В разделе Последние данные отображаемые значения сокращаются до 20 символов. Если используется сопоставление значений, это сокращение применяется не к сопоставленному значению, а только к исходному значению (отображаемому в скобках).

Без предопределённого сопоставления значений вы бы увидели только "1", что могло бы быть затруднительно для понимания.