3 低级别自动发现

概述

低级别自动发现可以自动为主机上的不同实体创建监控项、触发器和图表。比如， Zabbix可以自动监控文件系统和网络接口，并且不需要为其手工创建监控项。另外，可以基于周期性自动发现的结果来删除无用的监控实体。

用户可以基于特定的JSON格式来自定义发现类型。

自动发现的大体流程如下：

首先，用户在 “配置” → “模板” → “自动发现” 一栏中创建发现规则。发现规则包含用来发现特定实体(如文件系统和网络接口)的(1)监控项以及监控项、触发器和图表的(2)原型。

用于自动发现的监控项与常规监控项没有大体区别：Zabbix server向agent(或者其它任何类型的监控代理)请求监控项的值，agent对其回复一个文本值。唯一区别是agent响应中包含所发现的一系列JSON数组。对自动发现检查规则有自定义的需求时才需要了解格式的细节方面，不过有必要知道返回值包含一系列 宏 → 值 的键值对。比如，监控项 “net.if.discovery” 会返回两组键值对：”{#IFNAME}” → “lo” 和 “{#IFNAME}” → “eth0”。

当创建实际的监控项、触发器、图表以及主机时，宏会替换成接收到的值。使用低级别自动发现(LLD)的宏请参考 选项 中的全部列表。

当通过自动发现收到监控项返回值的时候，Zabbix server会查找 宏 → 值 键值对，每一对 宏 → 值 会基于原型生成监控项、触发器和图表。在上述 “net.if.discovery” 的例子中，为环回接口 “lo” 生成了一组监控项、触发器和图表，为 “eth0”接口生成了一组监控项、触发器和图表。

注意，自从Zabbix 4.2 开始，低级别自动发现返回的JSON数组的格式变化了。JSON格式将不再包含 “data” 对象。现在低级别自动发现接收一个普通的JSON数组，用于实现一些新特性，如监控项值的预处理和对于JSON文件中用于低级别自动发现的宏的路径自定义。

内置的自动发现的键已经可以实现在JSON文件的根路径返回一个低级别自动发现数组。如果数组使用{#MACRO}作为键，则宏和值会自动提取。任何新版的内置的自动发现检查会使用不含 “data”元素 的新语法格式。当处理一个低级别自动发现的值时，第一个步骤就是定位根目录 (数组的根目录是 $. 或 $.data)。

当”data”元素从所有跟自动发现有关的内置监控项中移除时，为了向后兼容，Zabbix会接受带有”data”元素的JSON格式，不过并不鼓励这么用。如果JSON数据包含一个对象，该对象只有一个”data”数组，则”data”数组的内容会通过JSONPath $.data自动提取出来。低级别自动发现现在接受可选的自定义宏，可在JSONPath语法中自定义路径。

上述变更会导致新的agent不再跟旧的Zabbix server有任何关联。

参阅: 发现的实体

配置低级别自动发现

下面是一个文件系统自动发现的例子。

要配置自动发现, 需完成下列操作:

• 找到: 配置 → 模板 或 主机
• 在对应模板/主机中点击 自动发现

• 在屏幕右上角点击 创建自动发现规则
• 在发现规则表格中填入所需信息

自动发现规则

自动发现规则表格包含五个选项卡，从左到右表示自动发现的数据流：

• 自动发现规则 - 最重要的一项，指定了用于获取自动发现的数据的内置监控项或自定义脚本
• 预处理 - 对发现的数据进行预处理
• LLD 宏 - 提取已发现的监控项、触发器等监控指标上配置的宏的取值。
• 过滤 - 过滤发现的值
• 覆盖 - 修改发现对象的监控项、触发器、图表和主机的原型

自动发现规则 选项卡包含用于自动发现的监控项的键 (以及一些通用的发现规则属性):

所有强制输入区域均会标记红色星号。

自动发现规则历史记录不会保存。

预处理

预处理 选项卡定义发现结果的转换规则。可以定义一个或多个转换规则。 转换规则执行的顺序以定义的顺序为准。所有预处理均由Zabbix server来执行。 参阅:

• 预处理详细信息
• 预处理测试

注意，如果自动发现规则已经通过模板应用到主机上，则此选项卡的内容是只读的。

自定义宏

LLD 宏 选项卡可以自定义低级别自动发现的宏。

如果返回的JSON数据不包含所需的宏时，自定义宏就派上用场了。例如:

• 用于文件系统自动发现的内置的 vfs.fs.discovery 键返回JSON数据，其中包含一些预定义的LLD宏，比如 {#FSNAME}, {#FSTYPE}。这些宏可直接用于监控项和触发器原型 (参考本页后续小节); 自定义宏不是强制的;
• vfs.fs.get 键同样返回JSON数据，包含 文件系统数据, 但不包括任何预定义的LLD宏。此例中你可以自定义宏, 并把自定义的宏映射到JSONPath返回的JSON数据上:

提取的值可用于已发现的监控项、触发器等实体上。 注意，值会从自动发现的结果中提取出来，也会从任何到目前为止的预处理步骤的结果中提取出来。

过滤器

过滤器可用于生成只匹配过滤条件的监控项、触发器和图表。过滤器 选项卡包含自动发现规则的过滤器配置，其可以过滤自动发现的值：

用于LLD规则中的正则表达式中的拼写错误(例如, 一个错误的 “文件系统自动发现” 的正则表达式)可能造成很多个配置项、历史数据以及主机的事件信息被删除。

如果操作系统名称只能通过区分大小写来正确识别，那么Zabbix的MYSQL数据库必须配置成大小写敏感。

覆盖

覆盖 选项卡允许设置规则来修改监控项， 触发器、图形和主机原型或它们的属性以用于发现 满足给定条件的对象。

覆盖（如果有）在可重新排序的拖放列表中显示，并且 按照定义的顺序执行。 配置一个新的覆盖，在 覆盖 选项卡单击 。要编辑现有覆盖，请单击覆盖名称。在弹出窗口中编辑覆盖规则详细信息。

所有强制参数都标有红色星号。

配置一个操作

要配置一个新操作, 点击操作面板上的 。编辑现有操作, 点击操作旁边的 。点击编辑按钮会出现弹窗。

参数				描述
对象				可使用四种对象: Item prototype 触发器原型 图表原型 主机原型
条件				允许过滤执行操作的目标实体。
	操作			可用操作: 等于 - 应用到此原型 不等于 - 应用到所有原型, 此原型除外 包含 - 如果原型名称包含此字符串，则应用 不包含 - 如果原型名称不包含此字符串，则应用 匹配 - 如果原型名称匹配正则表达式，则应用 不匹配 - 如果原型名称不匹配正则表达式，则应用
	模式			A 正则表达式 或 需要搜索的字符串。
	对象: 监控项原型
	启用创建			如果选取检查框, 会出现按钮, 允许覆盖原始监控项原型设置: 是 - 添加监控项，并且监控项处于启用状态。 否 - 添加监控项，监控项属于已发现的实体，但处于禁用状态。
	发现			如果选取检查框, 会出现按钮, 允许覆盖原始监控项原型设置: 是 - 添加监控项。 否 - 不添加监控项。
	更新间隔			如果选取检查框, 会出现两个选项, 允许为监控项设置不同的间隔: 延迟 - 监控项更新间隔。支持用户宏 和 时间后缀 (如 30s, 1m, 2h, 1d)。如果使用了 自定义间隔 则更新间隔应设置为0。 自定义间隔 - 点击 指定 灵活/计划的时间间隔。 更多信息请参阅 自定义间隔.
	历史保存周期			如果选取检查框, 会出现按钮, 允许给监控项设置不同的历史保存周期: 不保存历史 - 如果选择，那么历史数据不会保存。 保存周期 - 如果选择, 右侧会出现输入框，可以输入保存周期。支持用户宏 和LLD宏。
	趋势数据保存周期			如果选取检查框, 会出现按钮, 允许给监控项设置不同的趋势数据保存周期: 不保存趋势数据 - 如果选择, 趋势数据不会保存。 保存周期 - 如果选择, 右侧会出现输入框。支持用户宏和LLD宏。
	标签			如果选取检查框, 会出现一个面板, 允许指定 标签-值 的键值对。 即使标签名称匹配，这些标签也会追加到监控项原型的标签末尾。
	对象: 触发器原型
	启用创建			如果选取检查框, 会出现按钮, 允许覆盖原始触发器原型设置: 是 - 添加触发器，并且处于启用状态。 否 - 添加触发器到已发现的实体中，但触发器是禁用的。
	发现			如果选取检查框, 会出现按钮,允许覆盖原始触发器原型设置 : 是 - 添加触发器。 否 - 不会添加触发器。
	严重性			如果选取检查框, 会出现触发器严重性按钮, 允许修改触发器的严重性级别。
	标签			如果选取检查框,会出现一个新面板, 允许指定 标签-值 的键值对。 即使标签名称匹配，这些标签也会追加到监控项原型的标签末尾。
	对象: 图形原型
	发现			如果选取检查框, 会出现按钮, 允许覆盖原始图形原型设置: 是 - 添加图形。 否 - 不添加图形。
	对象: 主机原型
	启用创建			如果选取检查框, 会出现按钮,允许覆盖原始主机原型设置 : 是 - 创建主机，主机处于启用状态。 否 - 创建主机，主机处于禁用状态。
	发现			如果选取检查框,会出现按钮,允许覆盖原始的主机原型设置: 是 - 主机将被发现。 否 - 主机不会被发现。
	链接模板			如果选取检查框,会出现一个输入框，用于指定模板。 输入模板名称，或点击输入框旁边的 选择 然后从弹窗列表中选择模板。 所有链接到主机原型的模板均会被替换为此覆盖中配置的模板。
	标签			如果选取检查框,会出现一个面板, 允许指定 标签-值 的键值对。 即使标签名称匹配，这些标签也会追加到主机原型的标签后面。
	主机清单			如果选取检查框,会出现按钮,允许基于主机原型选择不同的清单模式 : 禁用 - 不添加主机清单数据。 手工 - 手工输入主机清单数据。 自动 - 基于收集的数据自动添加主机清单数据。

表格按钮

表格底部按钮允许执行一些操作。

	添加自动发现规则。此按钮只能用于新的自动发现规则。
	更新自动发现规则的属性。此按钮只能用于现有的自动发现规则。
	基于当前自动发现规则的属性，创建另一个自动发现规则。
	立即运行自动发现规则。该自动发现规则必须已存在。 参考 更多信息. 注意 当立即执行自动发现时, 配置缓存并没有更新, 所以自动发现的结果可能不会显示最近的变更。
	删除自动发现规则。
	取消对自动发现规则的编辑。

发现的实体

下面的截图展示了主机配置中已发现的监控项、触发器和图表。发现的实体用橙色的链接作为前缀标记，橙色链接指向关联的自动发现规则。

注意，如果跟现有实体的设备唯一标识相同，则不会创建新发现的实体。比如，一个监控项的键的名称重复或图表的名称重复。此类错误会显示在前端页面上，表明低级别自动发现无法创建对应实体。然而自动发现规则本身无法变为不支持的(unsupported)状态，因为一些实体无法创建，且必须跳过。自动发现规则会继续创建/更新其它实体。

如果发现的实体(文件系统、接口等)不再被发现(或过滤器过滤不出来)，则由低级别自动发现创建的监控项(触发器、图表也类似)会自动删除。此场景中，监控项、触发器和图表会在若干时间后被删除，数据保存的时间定义在 保存丢失资源周期 输入框中。

当发现的实体变为 ‘不再被发现’, 监控项列表中会显示一个涵盖整个生命周期的数据。移动鼠标到该数据上面，会显示离删除还剩多少天。

如果实体标记为已删除，但过期未删除(由于禁用了发现规则或禁用了监控的主机)，则会在下次运行自动发现规则时删除这些实体。

包含其它实体的实体，且标记为已删除，如果在自动发现规则层面做了变更，则不会再更新。比如， 基于低级别自动发现的触发器不会再更新，即使它们包含标记为已删除的实体。

其它类型的自动发现

如果想立刻上手熟悉其它类型的自动发现，更多信息和如何实现(how-to)方面可参阅以下章节:

• 网络接口的自动发现;
• CPU 和 CPU 核心的自动发现;
• SNMP OID的自动发现;
• JMX 对象的自动发现;
• 使用ODBC SQL 查询的自动发现;
• Windows 服务的自动发现;
• Zabbix 主机接口的自动发现。

更多关于JSON格式的自动发现和关于如何使用Perl脚本对文件系统做自动发现，请参阅 创建自定义LLD规则。

创建自定义LLD规则

可以创建完全自定义的低级别自动发现(LLD)规则，可用于发现任何类型的实体 - 如服务器上运行的数据库。

要实现此功能，需要创建一个自定义监控项，监控项需要返回JSON数据，其中包含发现的对象以及其它可选项 - 对象的一些属性。每个实体的宏没有数量限制 - 内置的自动发现规则返回一个或两个宏(比如文件系统自动发现返回两个宏)，但自定义的LLD可以返回更多个宏。

最好用一个例子来演示所需的JSON格式比较容易理解。假设一个旧版的Zabbix 1.8的agent正在运行(该agent不支持”vfs.fs.discovery”这个监控项的键)，不过我们还需要对文件系统进行自动发现。下面是个简单的Perl脚本，运行在Linux上，用于发现挂载的文件系统并输出JSON数据，JSON数据中包含文件系统名称和类型。使用Perl脚本的其中一种方式是作为一个UserParameter，利用 “vfs.fs.discovery_perl” 这个键：

#!/usr/bin/perl
       $first = 1;
       print "[\n";
       for (`cat /proc/mounts`)
       {
           ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;
           print "\t,\n" if not $first;
           $first = 0;
           print "\t{\n";
           print "\t\t\"{#FSNAME}\":\"$fsname\",\n";
           print "\t\t\"{#FSTYPE}\":\"$fstype\"\n";
           print "\t}\n";
       }
       print "]\n";

LLD宏的名称允许使用的符号有 0-9 , A-Z , _ , .

名称中不支持小写字母。

下面是一个输出(为了看的更清晰，重新排版)的例子。自定义的自动发现检查的JSON格式必须遵循相同的形式。

[
           { "{#FSNAME}":"/",                           "{#FSTYPE}":"rootfs"   },
           { "{#FSNAME}":"/sys",                        "{#FSTYPE}":"sysfs"    },
           { "{#FSNAME}":"/proc",                       "{#FSTYPE}":"proc"     },
           { "{#FSNAME}":"/dev",                        "{#FSTYPE}":"devtmpfs" },
           { "{#FSNAME}":"/dev/pts",                    "{#FSTYPE}":"devpts"   },
           { "{#FSNAME}":"/lib/init/rw",                "{#FSTYPE}":"tmpfs"    },
           { "{#FSNAME}":"/dev/shm",                    "{#FSTYPE}":"tmpfs"    },
           { "{#FSNAME}":"/home",                       "{#FSTYPE}":"ext3"     },
           { "{#FSNAME}":"/tmp",                        "{#FSTYPE}":"ext3"     },
           { "{#FSNAME}":"/usr",                        "{#FSTYPE}":"ext3"     },
           { "{#FSNAME}":"/var",                        "{#FSTYPE}":"ext3"     },
           { "{#FSNAME}":"/sys/fs/fuse/connections",    "{#FSTYPE}":"fusectl"  }
       ]

上面的例子中需要让键匹配原型中使用的LLD宏的名称，另一种方式是提取LLD宏的值，提取的方式是通过JSONPath {#FSNAME} → $.fsname 和 {#FSTYPE} → $.fstype, 于是可以使用下面的脚本来实现此功能:

#!/usr/bin/perl
       $first = 1;
       print "[\n";
       for (`cat /proc/mounts`)
       {
           ($fsname, $fstype) = m/\S+ (\S+) (\S+)/;
           print "\t,\n" if not $first;
           $first = 0;
           print "\t{\n";
           print "\t\t\"fsname\":\"$fsname\",\n";
           print "\t\t\"fstype\":\"$fstype\"\n";
           print "\t}\n";
       }
       print "]\n";

下面是一个输出(为了看的更清晰，重新排版)的例子。自定义的自动发现检查的JSON格式必须遵循相同的形式。

[
           { "fsname":"/",                           "fstype":"rootfs"   },
           { "fsname":"/sys",                        "fstype":"sysfs"    },
           { "fsname":"/proc",                       "fstype":"proc"     },
           { "fsname":"/dev",                        "fstype":"devtmpfs" },
           { "fsname":"/dev/pts",                    "fstype":"devpts"   },
           { "fsname":"/lib/init/rw",                "fstype":"tmpfs"    },
           { "fsname":"/dev/shm",                    "fstype":"tmpfs"    },
           { "fsname":"/home",                       "fstype":"ext3"     },
           { "fsname":"/tmp",                        "fstype":"ext3"     },
           { "fsname":"/usr",                        "fstype":"ext3"     },
           { "fsname":"/var",                        "fstype":"ext3"     },
           { "fsname":"/sys/fs/fuse/connections",    "fstype":"fusectl"  }
       ]

然后在自动发现规则的 “过滤器” 选项卡中，可以指定 “{#FSTYPE}” 作为宏 和”rootfs|ext3” 作为正则表达式。

无需使用 FSNAME/FSTYPE 作为自定义LLD规则中的宏的名称，可以使用任何名称。一旦使用了JSONPath，则LLD返回的数据会是一个数组元素，该元素可以是一个对象、另一个数组或一个值。

注意，如果使用一个用户参数，返回值限制在512 KB大小。更多信息请参考 LLD返回值的数据大小限制.