3 低级发现

概述

低级别自动发现提供了一种自动create 监控项的方法， 计算机上不同实体的触发器和图形。例如， Zabbix 可以自动开始监控 file 系统或网络 接口，无需为每个接口单独配置 create 监控项。 file 系统或网络接口。此外，还可以手动配置 根据需要自动删除不必要的实体来配置Zabbix 定期执行的发现操作的实际结果。

用户可以定义自己的发现类型，只要他们遵循以下规则： 特定的 JSON 协议。

发现流程的总体架构如下所示。

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

发现必要实体的 监控项 就像一个常规的 监控项 其他地方见过：服务器会询问一个Zabbix agent（或 whatever 类型的 对于该监控项的值设置为时，监控项的值为，agent会响应一个 文本值。区别在于agent返回的值 应包含以 JSON 格式表示的已发现实体列表。而 此格式的详细信息仅对自定义实现者重要 发现检查，需要知道返回值 包含宏 → 值对的列表。例如，监控项 "net.if.discovery" 可能会返回两对结果："{#IFNAME}" → "lo" 和 "{#IFNAME}" → "eth0"

这些宏用于名称、键和其他原型字段中 它们随后会被接收到的值替换以创建实际内容。 监控项、触发器、图形，甚至每个已发现实体的主机。请参见 使用options的完整列表 LLD 宏。

当服务器接收到一个发现 监控项 的值时，它会查看 宏 → 值对，并为每对生成实际的 监控项、触发器 以及基于其原型的图形。在该示例中 如上所述的“net.if.discovery”，服务器将generate一组监控项， 环回接口“lo”的触发器和图形，以及另一组 对于接口 "eth0"。

请注意，自 Zabbix 4.2 以来，由其返回的 JSON 格式已发生变化。 低级别自动发现规则已更改。不再支持以下预期功能 JSON将包含"data" object。低级别自动发现将 现在接受一个包含 array 的普通 JSON，以支持新功能 诸如 监控项 值的预处理以及自定义路径等功能 低级别自动发现宏值在JSON文档中。

内置的自动发现键已更新为返回LLD行的array 在 JSON 文档的根目录处。Zabbix 将自动提取宏 并且如果一个array字段的值使用{#MACRO}语法作为键。任何新的 原生自动发现检查将使用不带“data”的新语法 元素。在处理低级别发现值时，首先处理根元素 位于 array 的 $. 或 $.data 处。

虽然“data”元素已从所有本机 监控项 相关内容中移除 用于发现，为了向后兼容，Zabbix 仍将接受 包含“data”元素的JSON表示法，尽管不推荐使用。如果 JSON 包含一个 object，其中只有一个 "data" array 元素，然后它 将自动使用JSONPath提取元素的内容 $.data. 低级别自动发现（LLD）现在接受可选的用户自定义LLD 使用 JSONPath 语法指定自定义路径的宏。

::: notewarning 由于上述更改的结果，较新的 agents 不再 更长的将能够与旧的 Zabbix server 一起工作。 仅返回OutputFormat格式要求结果

另请参阅：已发现的实体

配置低级发现

我们将通过一个 file 系统发现的示例来说明低级别自动发现功能。

要配置自动发现，请执行以下步骤：

• 前往：数据收集 → 模板 或 主机
• 在相应模板/主机 所在行点击 发现

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

发现规则

发现规则表单包含五个标签页，从左到右依次表示发现过程中的数据流：

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

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

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

预处理

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

另请参阅：

• Preprocessing details
• 测试

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

自定义宏

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

在返回的JSON中没有预先定义所需宏的情况下，自定义宏非常有用。例如：

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

提取的值可用于发现的监控项、触发器等。请注意，值将从发现结果以及迄今为止的任何预处理步骤中提取。

过滤器

过滤器可用于仅针对符合特定条件的实体，来generate真实监控项、触发器和图形。过滤器选项卡包含发现规则的过滤定义，允许对发现值进行过滤：

覆盖

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

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

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

配置操作

要配置新操作的详细信息，请单击 操作中的 块。要编辑现有操作，请单击 旁边 操作。将弹出一个窗口，您可以在其中编辑操作的详细信息。 open.

表单按钮

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

发现的实体

以下屏幕截图说明了已发现的监控项、触发器和 graphs look like in 主机's configuration. Discovered entities are 以橙色链接开头，该链接指向它们来源的发现规则。

请注意，如果存在以下情况，将不会创建已发现的实体： 具有相同唯一性准则的已存在实体，用于 例如，具有相同键值的监控项或具有相同名称的图表。错误 在这种情况下，前端会显示此消息 发现规则无法create某些实体。该发现规则 其本身不会因此而变为不支持状态，因为某些实体可能无法 已创建并被跳过。发现规则将继续执行 创建/更新其他实体。

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

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

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

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

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

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

其他发现类型

有关其他类型开箱即用发现的更多详细信息和操作指南，请参见以下章节：

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

有关发现的 JSON 格式的更多详细信息 监控项 以及如何实现您自己的 file 系统发现器的 Perl 脚本示例，请参见 creating custom LLD rules。