3 低级发现

概述

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

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

发现过程的一般架构如下。

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

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

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

当服务器接收到发现监控项的值时，它会查看宏→值对，并根据它们的原型为每对生成实际的监控项、触发器和图形。在上面的"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系统发现的示例来说明低级发现机制.

配置发现规则需执行以下步骤:

• 前往: Configuration → 模板 或 主机
• 在相应模板/主机的行中点击Discovery

• 点击屏幕右上角的Create discovery rule
• 在发现规则表单中填写必要信息

发现规则

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

• 发现规则 - 最重要的是指定用于获取发现数据的内置监控项或自定义脚本

• 预处理 - 对发现的数据应用预处理

• LLD宏 - 允许提取某些宏值用于发现的监控项、触发器等

• 过滤器 - 允许筛选发现的值

• 覆盖 - 允许修改监控项、触发器、图形或主机

  prototypes when applying to specific discovered objects

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

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

预处理

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

另请参阅:

• Preprocessing details
• 测试

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

自定义宏

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

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

• 原生文件系统发现的vfs.fs.discovery键会返回包含预定义LLD宏（如{#FSNAME}、{#FSTYPE}）的JSON。这些宏可直接用于监控项和触发器原型（参见本页后续章节），无需定义自定义宏；

• vfs.fs.get agent 监控项同样返回包含[filesystem

  data](/manual/discovery/low_level_discovery/examples/mounted_filesystems), but without any pre-defined LLD macros. In this case you may define the macros yourself, and map them to the values in the JSON using 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的发现;

• [host

  interfaces](/manual/discovery/low_level_discovery/examples/host_interfaces) in Zabbix.

For more detail on the JSON format for discovery items and an example of how to implement your own file system discoverer as a Perl script, see creating custom LLD rules的发现.