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

Обзор

Низкоуровневое обнаружение (англ. Low-level discovery, LLD) даёт возможность автоматического создания элементов данных, триггеров и графиков для различных объектов на компьютере. Например, Zabbix может автоматически начать мониторинг файловых систем или сетевых интерфейсов на вашем устройстве, без необходимости создания вручную элементов данных для каждой файловой системы или сетевого интерфейса. Кроме того, в Zabbix имеется возможность настроить удаление ненужных объектов, основываясь на фактических результатах периодически выполняемого обнаружения.

Пользователь имеет возможность определить свои собственные типы обнаружения, обеспечив их функционирование согласно спецификации JSON протокола.

Общая архитектура процессов обнаружения заключается в следующем.

Сначала пользователь создаёт правило обнаружения в «Настройка» → «Шаблоны» → колонка «Обнаружение». Правило обнаружения состоит из (1) элемента данных, который осуществляет обнаружение необходимых объектов (например, файловые системы или сетевые интерфейсы) и (2) прототипов элементов данных, триггеров и графиков, которые должны быть созданы на основании полученных значений этого элемента данных.

Элемент данных, который осуществляет обнаружение необходимых объектов, подобен обычным элементам данных, которые видны в других местах: Zabbix сервер запрашивает у Zabbix агента (или используя любой другой указанный тип элемента данных) значение этого элемента данных, и агент отвечает текстовым значением. Разница в том, что значение, которое возвращает агент, должно содержать список обнаруженных объектов в специальном JSON формате. Хотя детали этого формата важны только для создателей собственных проверок обнаружения, всё же необходимо знать, что возвращаемое значение содержит список из пар: макрос → значение. Например, элемент данных «net.if.discovery» может вернуть две пары: «{#IFNAME}» → «lo» и «{#IFNAME}» → «eth0».

Эти макросы затем используются в именах, ключах и в других полях прототипов, которые являются основой для создания реальных элементов данных, триггеров и графиков для каждого обнаруженного объекта. Смотрите полный список опций по использованию LLD-макросов.

Когда сервер получает значение элемента данных обнаружения, он смотрит на пары макрос → значение и для каждой пары создаёт реальные элементы данных, триггеры и графики, основанные на их прототипах. В приведённом выше примере с «net.if.discovery», сервер будет создавать один набор элементов данных, триггеров и графиков для локального интерфейса "lo" и другой набор для интерфейса «eth0».

Обратите внимание, что начиная с Zabbix 4.2, формат возвращаемого правилами низкоуровневого обнаружения JSON-а изменился. Более не ожидается, что JSON будет содержать объект "data". Чтобы поддерживать новые возможности - такие как предобработку значений элементов данных и пользовательские пути к значениям LLD-макросов в документе JSON, - правила LLD теперь будут воспринимать обычный JSON, содержащий массив.

Встроенные ключи обнаружения были обновлены, чтобы возвращать массив строк LLD на корневом уровне JSON документа. Zabbix будет автоматически извлекать макрос и значение, если массив использует синтаксис {#MACRO} как ключ. Любые новые собственные проверки обнаружений будут использовать новый синтаксис без элемента "data". При обработке значения LLD сначала находится корень (массив на уровне $. или $.data).

Хотя элемент "data" был убран из всех собственных элементов данных, относящихся к обнаружению, в целях обратной совместимости Zabbix всё ещё будет воспринимать нотацию JSON с элементом "data", хотя его использование не рекомендуется. Если JSON содержит объект с только одним элементом "data" (массивом), то будет автоматически извлекаться содержимое этого элемента, используя JSONPath $.data. Низкоуровневое обнаружение теперь воспринимает необязательные определённые пользователем LLD-макросы, с настраиваемым путём, указанным с помощью синтаксиса JSONPath.

Смотрите также: Обнаруженные объекты

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

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

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

• Перейдите в: Настройка → Шаблоны или Узлы сети
• Нажмите на Обнаружение в строке с соответствующим шаблоном / узлом сети

• Нажмите на Создать правило обнаружения в верхнем правом углу экрана
• Заполните диалог правила обнаружения необходимыми деталями

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

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

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

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

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

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

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

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

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

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

Настраиваемые макросы

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

Настраиваемые макросы полезны в случаях, когда возвращаемый JSON не имеет нужных макросов, уже определённых должным образом. Так, например:

• Встроенный ключ vfs.fs.discovery для обнаружения файловых систем возвращает JSON с некоторыми уже определёнными LLD макросами, такими как {#FSNAME} и {#FSTYPE}. Эти макросы могут быть непосредственно использованы в прототипах элементов данных и триггеров (смотрите последующие разделы на этой странице); определение настраиваемых макросов не требуется;
• Элемент данных агента vfs.fs.get также возвращает JSON с данными о файловой системе, однако, без готовых LLD макросов. В этом случае вы можете определить эти макросы самостоятельно, и выставить соответствие между ними и значениями в JSON-е, используя JSONPath:

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

Фильтр правила обнаружения

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

Замещения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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