8 systemd服务的自动发现

概述

通过 Zabbix 可以 discover systemd 单元（服务，默认情况下）。

监控项键值

在 发现规则 中使用的监控项是

systemd.unit.discovery

此 监控项 键值仅受 Zabbix agent 2 支持。

此监控项返回一个包含 systemd 单元信息的 JSON，例如：

[{
    "{#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.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 单元的发现

也可以发现已禁用的systemd单元。在这种情况下，结果JSON中将返回三个宏：

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

要使监控项以及从原型创建的触发器能够针对已禁用的systemd单元生效，请确保调整（或删除）针对{#UNIT.ACTIVESTATE}和{#UNIT.UNITFILESTATE}的LLD过滤器限制。

支持的宏

以下宏可用于发现规则 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} 单元文件的安装状态。

监控项原型

基于 systemd 服务发现可以创建的 监控项原型 包括，例如：

  • 监控项 名称：{#UNIT.DESCRIPTION} active state info；监控项 键：systemd.unit.info["{#UNIT.NAME}"]
  • 监控项 名称：{#UNIT.DESCRIPTION} load state info；监控项 键：systemd.unit.info["{#UNIT.NAME}",LoadState]