3. Низкоуровневое обнаружение (LLD)

Обзор

Низкоуровневое обнаружение (LLD) автоматически обнаруживает сущности (например, файловые системы, сетевые интерфейсы) на узле сети и создает соответствующие элементы данных, триггеры и графики без ручной настройки для каждой сущности.

Чтобы использовать LLD, вы создаете правило обнаружения, которое собирает JSON-данные, описывающие сущности, и прототипы (элемент данных, триггер и график) для каждой сущности.

JSON, возвращаемый правилом, должен быть массивом объектов, где каждый объект представляет одну обнаруженную сущность с использованием пар ключ-значение. Например, правило обнаружения net.if.discovery может вернуть:

[
  {"{#IFNAME}": "lo"},
  {"{#IFNAME}": "eth0"}
]

Соответствующий набор элементов данных, триггеров и графиков затем создается из прототипов — по одному для каждого интерфейса (lo и eth0).

Если объекты содержат ключи в формате {#MACRO}, эти макросы используются напрямую в прототипах. Если нет, либо если требуются дополнительные/пользовательские макросы, макросы можно определить вручную и сопоставить с полями JSON с помощью JSONPath.

LLD также может создавать узлы сети (например, для виртуальных машин, обнаруженных на гипервизоре), и поддерживает вложенные правила обнаружения для многоуровневого обнаружения.

Сущности, которые больше не обнаруживаются, могут быть автоматически отключены или удалены.

Настройка низкоуровневого обнаружения

Мы рассмотрим низкоуровневое обнаружение на примере обнаружения файловой системы.

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

1. Перейдите в Сбор данных > Шаблоны или Узлы сети.
2. Нажмите Обнаружение в строке соответствующего шаблона/узла сети.

3. Нажмите Создать правило обнаружения в правом верхнем углу экрана.
4. Заполните форму правила обнаружения, указав необходимые сведения.

Правило обнаружения

Диалог правила обнаружения содержит пять вкладок, представляющих (слева направо) поток обработки данных во время обнаружения:

• Правило обнаружения (Discovery rule) — самое главное, определяет встроенный элемент данных или пользовательский сценарий для получения данных обнаружения.
• Предобработка (Preprocessing) — применяет какую-либо предобработку к данным обнаружения.
• LLD макросы (LLD macros) — позволяет извлечь значения некоторых макросов, чтобы использовать в обнаруженных элементах данных, триггерах и т.д.
• Фильтры (Filters) — позволяет отфильтровать обнаруженные значения.
• Замещения (Overrides) — позволяет изменить прототипы элементов данных, триггеров, графиков или узлов сети, когда они применяются к конкретным найденным объектам.

Вкладка Правило обнаружения (Discovery rule) содержит ключ элемента данных, используемого для обнаружения (а также некоторые общие атрибуты правила обнаружения):

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

Предобработка

Вкладка Предобработка (Preprocessing) позволяет задать правила преобразований, применяемых к результату обнаружения. На этом шаге возможны одно или несколько преобразований. Преобразования выполняются в том порядке, в котором заданы. Вся предобработка выполняется сервером Zabbix.

Смотрите также:

• Подробности предобработки
• Тестирование предобработки

Обратите внимание, что если правило обнаружения применено к узлу сети через шаблон, то содержимое этой вкладки будет доступно только для чтения.

Пользовательские макросы

Вкладка LLD macros позволяет указать пользовательские LLD macros, если возвращаемый JSON еще не содержит ключей в формате {#MACRO}.

Например, ключ элемента данных агента vfs.fs.get возвращает JSON с данными файловой системы без каких-либо предопределенных LLD macros.
Здесь вы вручную определяете макросы и сопоставляете их со значениями в JSON с помощью выражений JSONPath:

Правило обнаружения должно возвращать массив JSON в корне ($.).
Для обратной совместимости также допускается объект JSON, содержащий единственный массив "data". В этом случае массив "data" автоматически разворачивается:

{"data":[{"foo":"bar"}, {"foo":"baz"}]}

Фильтр

Фильтр можно использовать для создания реальных элементов данных, триггеров и графиков только для сущностей, которые соответствуют критериям. Вкладка Фильтры содержит определения фильтров правила обнаружения, позволяющие фильтровать значения обнаружения:

Например, если вас интересуют только файловые системы C:, D: и E:, вы можете поместить {#FSNAME} в поле Macro и ^C|^D|^E в поле Regular expression.
Фильтрация также возможна по типам файловых систем с использованием макроса {#FSTYPE} (например, ^ext|^reiserfs) и по типам дисков (поддерживается только агентом Windows) с использованием макроса {#FSDRIVETYPE} (например, fixed).

Чтобы проверить регулярное выражение, вы можете использовать grep -E, например:

for f in ext2 nfs reiserfs smbfs; 
do echo $f | grep -E '^ext|^reiserfs' || echo "SKIP: $f"; 
done

Переопределение

Вкладка Overrides позволяет задавать правила для изменения списка прототипов элементов данных, триггеров, графиков, узлов сети и обнаружения или их атрибутов для обнаруженных объектов, которые соответствуют заданным критериям.

Переопределения, если они есть, отображаются в списке с возможностью изменения порядка перетаскиванием и выполняются в том порядке, в котором они определены. Чтобы настроить параметры нового переопределения, нажмите в блоке Overrides. Чтобы изменить существующее переопределение, нажмите на его имя. Откроется всплывающее окно, в котором можно изменить параметры правила переопределения.

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

Настройка операции

Чтобы настроить параметры новой операции, нажмите в блоке Operations. Чтобы изменить существующую операцию, нажмите рядом с операцией. Откроется всплывающее окно, в котором можно изменить параметры операции.

Parameter			Description
Object			Доступны пять типов объектов: Прототип элемента данных Прототип триггера Прототип графика Прототип узла сети Прототип обнаружения
Condition			Позволяет фильтровать сущности, к которым следует применять операцию.
	Operator		Поддерживаемые операторы: equals - применить к этому прототипу does not equal - применить ко всем прототипам, кроме этого contains - применить, если имя прототипа содержит эту строку does not contain - применить, если имя прототипа не содержит эту строку matches - применить, если имя прототипа соответствует регулярному выражению does not match - применить, если имя прототипа не соответствует регулярному выражению
	Pattern		Регулярное выражение regular expression или строка для поиска.
	Object: Item prototype
		Create enabled	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа элемента данных: Yes - элемент данных будет добавлен в включенном состоянии. No - элемент данных будет добавлен к обнаруженной сущности, но в отключенном состоянии.
		Discover	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа элемента данных: Yes - элемент данных будет добавлен. No - элемент данных не будет добавлен.
		Update interval	Когда установлен флажок, появятся два параметра, позволяющие задать другой интервал для элемента данных: Delay - интервал обновления элемента данных. Поддерживаются user macros, LLD macros и time suffixes (например, 30s, 1m, 2h, 1d). Если используется Custom interval, следует установить значение 0. Custom interval - нажмите , чтобы указать гибкие интервалы или интервалы по расписанию. Подробности см. в разделе Custom intervals.
		History	Когда установлен флажок, появятся кнопки, позволяющие задать другой период хранения истории для элемента данных: Do not store - если выбрано, история храниться не будет. Store up to - если выбрано, справа появится поле для ввода периода хранения. Поддерживаются user macros и LLD macros.
		Trends	Когда установлен флажок, появятся кнопки, позволяющие задать другой период хранения трендов для элемента данных: Do not store - если выбрано, тренды храниться не будут. Store up to - если выбрано, справа появится поле для ввода периода хранения. Поддерживаются user macros и LLD macros.
		Tags	Когда установлен флажок, появится новый блок, позволяющий указать пары тег-значение. Поддерживаются user macros и LLD macros. Эти теги будут добавлены к тегам, указанным в прототипе элемента данных, даже если имена тегов совпадают.
	Object: Trigger prototype
		Create enabled	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа триггера: Yes - триггер будет добавлен в включенном состоянии. No - триггер будет добавлен к обнаруженной сущности, но в отключенном состоянии.
		Discover	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа триггера: Yes - триггер будет добавлен. No - триггер не будет добавлен.
		Severity	Когда установлен флажок, появятся кнопки уровня серьезности триггера, позволяющие изменить серьезность триггера.
		Tags	Когда установлен флажок, появится новый блок, позволяющий указать пары тег-значение. Поддерживаются user macros и LLD macros. Эти теги будут добавлены к тегам, указанным в прототипе триггера, даже если имена тегов совпадают.
	Object: Graph prototype
		Discover	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа графика: Yes - график будет добавлен. No - график не будет добавлен.
	Object: Host prototype
		Create enabled	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа узла сети: Yes - узел сети будет создан в включенном состоянии. No - узел сети будет создан в отключенном состоянии.
		Discover	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа узла сети: Yes - узел сети будет обнаружен. No - узел сети не будет обнаружен.
		Link templates	Когда установлен флажок, появится поле для ввода шаблонов. Начните вводить имя шаблона или нажмите Select рядом с полем и выберите шаблоны из списка во всплывающем окне. Шаблоны из этого переопределения добавляются ко всем шаблонам, уже связанным с прототипом узла сети.
		Tags	Когда установлен флажок, появится новый блок, позволяющий указать пары тег-значение. Поддерживаются user macros и LLD macros. Эти теги будут добавлены к тегам, указанным в прототипе узла сети, даже если имена тегов совпадают.
		Host inventory	Когда установлен флажок, появятся кнопки, позволяющие выбрать другой режим инвентаризации для прототипа узла сети: Disabled - не заполнять инвентарные данные узла сети Manual - указывать сведения вручную Automated - автоматически заполнять инвентарные данные узла сети на основе собранных метрик.
	Object: Discovery prototype
		Create enabled	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа обнаружения: Yes - правило обнаружения будет добавлено в включенном состоянии. No - правило обнаружения будет добавлено в отключенном состоянии.
		Discover	Когда установлен флажок, появятся кнопки, позволяющие переопределить исходные настройки прототипа обнаружения: Yes - правило обнаружения будет добавлено. No - правило обнаружения не будет добавлено.
		Update interval	Когда установлен флажок, появятся два параметра, позволяющие задать другой интервал для правила обнаружения: Delay - интервал обновления правила. Поддерживаются user macros, LLD macros и time suffixes (например, 30s, 1m, 2h, 1d). Если используется Custom interval, следует установить значение 0. Custom interval - нажмите , чтобы указать гибкие интервалы или интервалы по расписанию. Подробности см. в разделе Custom intervals.

Кнопки диалога

Кнопки в нижней части диалога позволяют выполнить несколько видов операций.

(Добавить)	Добавление правила обнаружения. Эта кнопка доступна только для новых правил обнаружения.
(Обновить)	Обновление свойств правила обнаружения. Эта кнопка доступна только для уже существующих правил обнаружения.
(Клонировать)	Создание другого правила обнаружения на основе свойств текущего правила обнанужения.
(Выполнить сейчас)	Выполнение немедленного обнаружения на основе правила обнаружения. Правило обнаружения должно существовать. Смотрите более подробную информацию. Обратите внимание, что когда обнаружение выполняется немедленно, кэш конфигурации не обновляется, поэтому на результат не повлияют совсем недавние изменения настроек правила обнаружения.
(Тест)	Протестировать настройки правила обнаружения. Используйте эту кнопку для проверки настроек конфигурации (таких как подключение и корректность параметров) без постоянного применения каких-либо изменений.
(Удалить)	Удаление правила обнаружения
(Отмена)	Отмена изменения свойств правила обнаружения.

Обнаруженные объекты

Представленные ниже снимки экрана иллюстрируют, как выглядят уже обнаруженные элементы данных, триггеры и графики в настройках узла сети. Обнаруженные объекты имеют префикс — ссылку золотистого цвета, которая ведёт к правилу обнаружения, создавшему эти объекты.

Обратите внимание, что обнаруженные объекты не будут созданы в случае, если объекты с такими же условиями уникальности уже существуют — например, элемент данных с таким же ключом или график с таким же именем. В таком случае в веб-интерфейсе отобразится сообщение об ошибке, что правило низкоуровневого обнаружения не смогло создать определённые объекты. Само правило обнаружения, тем не менее, не станет неподдерживаемым из-за того, что некоторые объекты не смогли быть созданы и были пропущены. Правило обнаружения перейдёт к созданию/обновлению других объектов.

Если обнаруженный объект (узел сети, файловая система, интерфейс и т.д.) более не обнаруживается (или более не попадает под фильтр), то объекты, созданные на его основе, могут быть автоматически деактивированы и впоследствии удалены.

Потерянные ресурсы могут быть автоматически деактивированы на основе значения параметра Удаление потерянных ресурсов (Delete lost resources). Это влияет на потерянные узлы сети, группы узлов сети, элементы данных, триггеры и графики.

Потерянные ресурсы могут быть автоматически удалены на основе значения параметра Деактивация потерянных ресурсов (Disable lost resources). Это влияет на потерянные узлы сети, элементы данных и триггеры.

Когда обнаруженный объект становится «Более не обнаруживается», в списке элементов данных будет отображаться оранжевый индикатор времени жизни. Переместите курсор мыши на этот индикатор, и вы увидите сообщение с количеством дней до момента удаления элемента данных.

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

Объекты, которые содержат другие объекты, которые помечены на удаление, не будут обновлены, если будут изменены на уровне правила обнаружения. Например, триггеры на основе LLD не будут обновлены, если они содержат элементы данных, которые помечены на удаление.

Другие типы обнаружения

Для получения более подробных сведений и инструкций по остальным типам доступных «из коробки» обнаружений смотрите следующие разделы:

• обнаружение сетевых интерфейсов;
• обнаружение CPU и ядер CPU;
• обнаружение SNMP OID-ов;
• обнаружение объектов JMX;
• обнаружение с использованием запросов ODBC SQL;
• обнаружение служб Windows;
• обнаружение интерфейсов узлов сети в Zabbix.

Для получения более подробных сведений касательно JSON формата по обнаружению элементов данных и примера, каким образом реализовать своё собственное обнаружение файловых систем при помощи Perl скрипта, смотрите создание пользовательских правил LLD.