8. Обнаружение служб systemd

Обзор

Существует возможность обнаружения модулей (units) systemd (службы, по умолчанию) с помощью Zabbix.

Ключ элемента данных

Элемент данных, который нужно использовать в правиле обнаружения, — это

systemd.unit.discovery

Этот ключ элемента данных поддерживается только в Zabbix agent 2.

Этот элемент данных возвращает JSON с информацией о юнитах systemd, например:

[{
    "{#UNIT.NAME}": "mysqld.service",
    "{#UNIT.DESCRIPTION}": "MySQL Server",
    "{#UNIT.LOADSTATE}": "loaded",
    "{#UNIT.ACTIVESTATE}": "active",
    "{#UNIT.SUBSTATE}": "running",
    "{#UNIT.FOLLOWED}": "",
    "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice",
    "{#UNIT.JOBID}": 0,
    "{#UNIT.JOBTYPE}": "",
    "{#UNIT.JOBPATH}": "/",
    "{#UNIT.UNITFILESTATE}": "enabled"
    "{#UNIT.SERVICETYPE}": "simple"
}, {
    "{#UNIT.NAME}": "systemd-journald.socket",
    "{#UNIT.DESCRIPTION}": "Journal Socket",
    "{#UNIT.LOADSTATE}": "loaded",
    "{#UNIT.ACTIVESTATE}": "active",
    "{#UNIT.SUBSTATE}": "running",
    "{#UNIT.FOLLOWED}": "",
    "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket",
    "{#UNIT.JOBID}": 0,
    "{#UNIT.JOBTYPE}": "",
    "{#UNIT.JOBPATH}": "/",
    "{#UNIT.UNITFILESTATE}": "enabled"
}]
Обнаружение деактивированных модулей systemd

Также возможно обнаруживать и деактивированные (disabled) модули systemd. В этом случае в результирующем JSON-е возвращаются три макроса:

  • {#UNIT.PATH}
  • {#UNIT.ACTIVESTATE}
  • {#UNIT.UNITFILESTATE}.

Чтобы из прототипов создавались элементы данных и триггеры для деактивированных модулей systemd, убедитесь, что подправлены (или удалены) запрещающие фильтры LLD для {#UNIT.ACTIVESTATE} и {#UNIT.UNITFILESTATE}.

Поддерживаемые макросы

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

Macro Description
{#UNIT.NAME} Имя основной единицы.
{#UNIT.DESCRIPTION} Человекочитаемое описание.
{#UNIT.LOADSTATE} Состояние загрузки (то есть был ли файл единицы успешно загружен)
{#UNIT.ACTIVESTATE} Активное состояние (то есть запущена ли единица в данный момент или нет)
{#UNIT.SUBSTATE} Подсостояние (более детализированная версия активного состояния, специфичная для типа единицы, в отличие от активного состояния)
{#UNIT.FOLLOWED} Единица, состояние которой отслеживается этой единицей, если такая есть; иначе пустая строка.
{#UNIT.PATH} Путь объекта единицы.
{#UNIT.JOBID} Числовой ID задания, если для единицы задания есть задание в очереди; 0 в противном случае.
{#UNIT.JOBTYPE} Тип задания.
{#UNIT.JOBPATH} Путь объекта задания.
{#UNIT.UNITFILESTATE} Состояние установки файла единицы.
{#UNIT.SERVICETYPE} Тип единицы службы (например, simple, forking, oneshot, idle и т. д.). Этот макрос возвращается только если единица является службой.

Прототипы элементов данных

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

  • Имя элемента данных: {#UNIT.DESCRIPTION} active state info; ключ элемента данных: systemd.unit.info["{#UNIT.NAME}"]
  • Имя элемента данных: {#UNIT.DESCRIPTION} load state info; ключ элемента данных: systemd.unit.info["{#UNIT.NAME}",LoadState]