В этом разделе представлены примеры использования шагов предварительной обработки для решения некоторых практических задач.
В этом примере используется шаг предварительной обработки Совпадение регулярному выражению для фильтрации ненужных событий из журнала событий VMware.
1. Убедитесь, что на работающем узле сети гипервизора VMware элемент данных журнала событий vmware.eventlog присутствует и работает должным образом. Обратите внимание, что элемент данных журнала событий уже может присутствовать у гипервизора, если при создании узла сети был присоединён шаблон VMware.
2. На узле сети гипервизора VMware создайте зависимый элемент данных с типом «Журнал (лог)» и выберите элемент данных журнала событий в качестве основного элемента данных.
3. На вкладке Предобработка зависимого элемента данных выберите шаг предобработки «Совпадение регулярному выражению» и укажите, например, один из следующих параметров:
# Фильтрация всех событий входа в систему:
pattern: .* logged in .*
# Фильтрация строк, содержащих имена пользователей после «User»:
pattern: \bUser\s+\K\S+
Если нет соответствия регулярному выражению, то зависимый элемент данных станет неподдерживаемым с соответствующим сообщением об ошибке. Чтобы избежать этого, отметьте флажок «Другое при ошибке» и выберите опцию — например, отбросить значение либо выставить пользовательское значение. Обратите внимание, что отброшенные значения не сохраняются в базе данных; в результате триггеры не пересчитываются и данные о динамике изменений не генерируются.
В качестве альтернативы вы можете использовать шаг предварительной обработки Регулярное выражение для извлечения соответствующих групп и управления выводом. Например:
# Извлечь и вывести из журнала событий полное событие, содержащащее строку «logged in»:
pattern: .*logged in.*
output: \0
# Извлечь и вывести имена пользователей после «User»:
pattern: User (.*?)(?=\ )
output: \1
В этом примере используется шаг предварительной обработки Пользовательский множитель для проверки того, является ли тип полученного значения элемента данных числовым.
На вкладке Предобработка элемента данных выберите шаг предварительной обработки «Пользовательский множитель» и задайте следующий параметр:
Если предварительная обработка не удалась (например, значение на входе не является числовым), то элемент данных становится неподдерживаемым с соответствующим сообщением об ошибке. Чтобы избежать этого, отметьте флажок «Другое при ошибке» и выберите параметр, например, отбрасывание значения или установка пользовательского значения. Обратите внимание, что отброшенные значения не сохраняются в базе данных; в результате триггеры не пересчитываются и данные о динамике изменений не генерируются.
В этом примере используется шаг предварительной обработки Проверка на неподдерживаемое значение (Check for not supported value) для проверки того, что не удалось извлечь значение элемента данных.
Когда процесс поллера Zabbix сервера/прокси пытается собрать значение элемента данных, он может:
Чтобы обнаружить и обработать ошибки сбора значений элементов данных, вы можете использовать шаг предварительной обработки «Проверка на неподдерживаемое значение (Check for not supported value)». Обратите внимание, что этот шаг всегда выполняется первым и обнаруживает только ошибки, которые возникают до начала предварительной обработки.
На вкладке Предобработка (Preprocessing) элемента данных выберите шаг предобработки «Проверка на неподдерживаемое значение (Check for not supported value)».
Затем используйте параметр Другое при ошибке (Custom on fail), чтобы отбросить значение (в данном случае ошибку), задать пользовательское значение или вернуть пользовательское сообщение об ошибке. Обратите внимание, что отброшенные значения в базе данных не сохраняются; в результате триггеры не вычисляются и данные о динамике изменений не генерируются.