8 自定义 LLD 规则

概述

也可以创建完全自定义的 LLD 规则，用于发现任何类型的实体——例如，数据库服务器上的数据库。

为此，应创建一个自定义监控项，使其返回一个 JSON 字符串，用于指定已发现的对象，以及可选的这些对象的某些属性。每个实体的宏数量没有限制——内置发现规则通常返回一个或两个宏（例如，文件系统发现会返回两个宏），但也可以返回更多。

示例

所需的 JSON 字符串格式最好通过示例来说明。假设您正在运行一个旧版的 Zabbix 1.8 agent（即不支持 vfs.fs.discovery 键的版本），但您仍然需要发现文件系统。
下面是一个适用于 Linux 的简单 Perl 脚本，用于发现已挂载的文件系统并以 JSON 格式输出，其中同时包含文件系统名称和类型。其一种使用方式是将其作为一个 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";

其输出示例如下所示（为便于阅读已重新格式化）。自定义发现检查的 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 宏名称匹配；另一种方式是使用 JSONPath 提取 LLD 宏值，即 {#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";

其输出示例如下所示（为便于阅读已重新格式化）。

[
    { "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"  }
]

然后，在发现规则的 Filter 字段中，您可以将 "{#FSTYPE}" 指定为宏，并将 "rootfs|ext3" 指定为正则表达式。

请注意，如果使用用户参数，返回值限制为 16MB。
更多详细信息，请参见 LLD 返回值的数据限制。