3 低级发现

概述

低级发现（LLD）提供了一种自动create监控项、触发器以及为计算机上不同实体创建图形的方法。 例如，Zabbix可以自动开始监控file系统或机器上的网络接口，而无需手动为每个file系统或网络接口create监控项。 LLD还可以create主机，例如为populate virtual machines在虚拟化管理程序上发现的实体创建主机。 此外，可以配置Zabbix根据定期执行发现的实际结果自动删除不需要的实体。

用户可以定义自己的发现类型，前提是遵循特定的JSON协议。

发现过程的总体架构如下。

首先，用户在数据收集 > 模板中的发现列创建发现规则。 发现规则由（1）一个发现必要实体（例如file系统或网络接口）的监控项和（2）基于该监控项值应创建的监控项、触发器和图形的原型组成。

发现必要实体的监控项与其他地方看到的常规监控项类似：服务器向Zabbix agent（或监控项设置的任何类型）请求该监控项的值，agent以文本值响应。 不同之处在于agent响应的值应包含JSON格式的发现实体列表。 虽然此格式的细节仅对自定义发现检查的实现者重要，但有必要知道返回值包含宏→值对的列表。 例如，监控项 "net.if.discovery"可能返回两对："{#IFNAME}" → "lo"和"{#IFNAME}" → "eth0"。

这些宏用于名称、键和其他原型字段中，然后替换为接收到的值，为每个发现的实体创建实际的监控项、触发器、图形甚至主机。 查看options以了解使用LLD宏的完整列表。

当服务器接收到发现监控项的值时，它会查看宏→值对，并根据它们的原型为每对生成实际的监控项、触发器和图形。 在上面的"net.if.discovery"示例中，服务器将为环回接口"lo"generate一组监控项、触发器和图形，为接口"eth0"创建另一组。

请注意，自Zabbix 4.2起，低级发现规则返回的JSON格式已更改。 不再期望JSON包含"data"object。 低级发现现在接受包含array的正常JSON，以支持新功能，如监控项值预处理和JSON文档中低级发现宏值的自定义路径。

内置发现键已更新为在JSON文档的根目录返回LLD行的array。 如果array字段使用{#MACRO}语法作为键，Zabbix将自动提取宏和值。 任何新的本机发现检查将使用不带"data"元素的新语法。 在处理低级发现值时，首先定位根（array在$.或$.data）。

虽然"data"元素已从所有与发现相关的本机监控项中删除，但为了向后兼容，Zabbix仍将接受带有"data"元素的JSON表示法，但不鼓励使用。 如果JSON包含仅有一个"data"array元素的object，则它将使用JSONPath $.data自动提取元素的内容。 低级发现现在接受可选的用户定义LLD宏，其自定义路径以JSONPath语法指定。

另请参阅：发现的实体

配置低级发现

我们将通过file系统发现的示例来说明低级发现机制.

要配置发现规则，请执行以下操作:

• 前往: 数据收集 > 模板 或 主机.
• 在相应模板/主机的行中点击发现.

• 点击屏幕右上角的创建发现规则.
• 在发现规则表单中填写必要信息.

发现规则

发现规则表单包含五个标签页，从左至右分别代表发现过程中的数据流：

• 发现规则 - 主要指定用于获取发现数据的内置监控项或自定义脚本。
• 预处理 - 对发现的数据应用预处理操作。
• LLD宏 - 允许提取某些宏值以用于发现的监控项、触发器等。
• 过滤器 - 允许对发现的值进行筛选。
• 覆盖 - 在应用到特定发现的objects时，允许修改监控项、触发器、图形或主机原型。

发现规则标签页包含用于发现的监控项键（以及一些通用发现规则属性）：

所有必填字段均以红色星号标记。

预处理

预处理选项卡允许定义应用于发现结果的转换规则。 在此步骤中可以应用一个或多个转换。 转换按照定义的顺序执行。 所有预处理均由Zabbix server完成。

另请参阅：

• Preprocessing details
• 测试

请注意，如果发现规则已通过模板应用于主机，则此选项卡的内容为只读。

自定义宏

LLD宏选项卡允许指定自定义的低级发现宏。

当返回的JSON未定义所需宏时，自定义宏非常有用。 例如：

• 文件系统发现的原生vfs.fs.discovery键返回的JSON包含预定义的LLD宏，如{#FSNAME}、{#FSTYPE}。 这些宏可直接用于监控项、触发器原型（参见本页后续章节），无需定义自定义宏；
• vfs.fs.get agent 监控项也返回带有filesystem data的JSON，但没有任何预定义的LLD宏。 此时您可以自行定义宏，并使用JSONPath将其映射到JSON中的值：

提取的值可用于发现的监控项、触发器等。 注意，值将从发现结果及当前所有预处理步骤中提取。

过滤器

过滤器可用于generate仅匹配条件的实体对应的真实监控项、触发器及图表。 Filters选项卡包含发现规则过滤器定义，可用于筛选发现值：

覆盖

覆盖选项卡允许设置规则来修改满足特定条件的已发现objects的监控项、触发器、图表和主机原型或其属性列表。

覆盖规则（如有）将以可拖拽重新排序的列表形式显示，并按定义顺序执行。要配置新覆盖规则的详细信息，请点击覆盖区块中的。 要编辑现有覆盖规则，请点击覆盖名称。 将弹出窗口允许编辑覆盖规则的详细信息。

所有必填参数均以红色星号标记。

配置操作

要配置新操作的详细信息，请点击操作区块中的。 要编辑现有操作，请点击操作旁边的。 将弹出窗口允许编辑操作详细信息。

表单按钮

表单底部的按钮可用于执行多个操作。

发现的实体

以下截图展示了在主机配置中发现的监控项、触发器和图形的显示效果。 发现的实体前缀带有橙色链接，指向其来源的发现规则。

请注意，如果已存在具有相同唯一性标准的实体（例如具有相同键的监控项或同名的图形），则不会创建发现的实体。 在这种情况下，前端会显示错误消息，指出低级发现规则无法create某些实体。 然而，发现规则本身不会因为某些实体无法创建而被迫跳过就变为不支持状态。 发现规则将继续创建/更新其他实体。

如果发现的实体（主机、file系统、接口等）不再被发现（或不再通过过滤器），则基于它创建的实体可能会被自动禁用并最终删除。

丢失的资源可能会根据禁用丢失资源参数的值自动禁用。 这会影响丢失的主机、监控项和触发器。

丢失的资源可能会根据删除丢失资源参数的值自动删除。 这会影响丢失的主机、主机组、监控项、触发器和图形。

当发现的实体变为"不再被发现"时，实体列表中会显示一个生命周期指示器。 将鼠标指针悬停在其上，将显示一条消息，指示其状态详细信息。

如果实体被标记为删除，但未在预期时间删除（禁用的发现规则或监控项 主机），则下次处理发现规则时将删除它们。

包含其他实体的实体（这些实体被标记为删除）如果在发现规则级别发生更改，将不会update。 例如，基于LLD的触发器如果包含被标记为删除的监控项，则不会update。

其他发现类型

关于其他类型开箱即用发现的更多细节及操作指南，请参阅以下章节：

• network interfaces的发现
• CPUs and CPU cores的发现
• SNMP OIDs的发现
• JMX objects的发现
• 使用ODBC SQL queries进行发现
• Windows services的发现
• Zabbix中host interfaces的发现

有关发现监控项的JSON格式详情及如何通过Perl脚本实现自定义file系统发现器的示例，请参阅creating custom LLD rules。