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

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

Конфигурация

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

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

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

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

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

Сопоставление применяется в порядке следования правил, которые можно менять местами перетаскиванием.
Тип Тип сопоставления:
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).
Значение Входящее значение (может содержать диапазон или регулярное выражение в зависимости от типа сопоставления).
Сопоставлено с Строковое представление (до 64 символов) для входящего значения.

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

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

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

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

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

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

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

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