2022 Zabbix中国峰会
2022 Zabbix中国峰会

1 预处理测试

测试

测试预处理步骤对于确保复杂的预处理流水线产生预期结果非常有用,而无需等待接收和预处理项目值。

可以进行以下测试:

  • 针对假设值
  • 针对来自主机的实际值

每个预处理步骤都可以单独测试,也可以同时测试所有步骤。当您分别点击操作块中的测试测试所有步骤按钮时,会打开一个测试窗口。

测试假设值

参数 描述
从主机获取值 如果要测试假设值,请不要选中此复选框。
参见:测试真实值
输入要测试的值。
单击参数字段或查看/编辑按钮 将打开一个文本区域窗口,用于输入值或代码块。
不支持 选中此复选框以测试不支持的值。
此选项可用于测试检查不支持的值预处理步骤。
错误 输入错误文本。
从主机获取值未选中但选中了不支持时,此字段可用。
如果从主机获取值已选中,则此字段将填写实际错误消息(只读)来自主机。
时间 输入值的时间显示为:now(只读)。
上一个值 输入要进行比较的先前输入值。
仅适用于更改节流预处理步骤。
上一个时间 输入要进行比较的先前输入值时间。
仅适用于更改节流预处理步骤。
默认值基于项目的“更新间隔”字段值(如果为“1m”,则此字段填写为 now-1m)。如果未指定任何内容或用户无权访问主机,则默认为 now-30s
如果使用了任何宏,则将它们列出以及它们的值。这些值可用于测试目的进行编辑,但更改仅在测试上下文中保存。
行尾序列 选择多行输入值的行尾序列:
LF - LF(换行)序列
CRLF - CRLF(回车换行)序列。
预处理步骤 列出了预处理步骤;在单击测试按钮后,每个步骤的测试结果都会显示出来。
当发送到前端的测试结果被截断到最大大小为512KB时,测试结果会被截断。如果结果被截断,则会显示一个警告图标。鼠标悬停时显示警告描述。请注意,大于512KB的数据仍然会被 Zabbix 服务器完全处理。
如果步骤在测试中失败,将显示一个错误图标。鼠标悬停时显示错误描述。
如果为该步骤指定了“自定义失败”,并执行了该操作,则在预处理测试步骤行后会出现一个新行,显示执行了什么操作以及产生了什么结果(错误或值)。
结果 在测试所有步骤一起测试时,无论在哪种情况下,都会显示预处理步骤的最终测试结果(当单击测试所有步骤按钮时)。
还显示了将值类型转换为项目值类型的类型,例如 结果转换为数字(无符号)
当发送到前端的测试结果被截断到最大大小为512KB时,测试结果会被截断。如果结果被截断,则会显示一个警告图标。鼠标悬停时显示警告描述。请注意,大于512KB的数据仍然会被 Zabbix 服务器完全处理。

单击测试以查看每个预处理步骤之后的结果。

测试值在测试会话之间存储,可以用于单独的步骤或所有步骤,允许用户更改预处理步骤或项目配置,然后返回到测试窗口,而无需重新输入信息。但是,在刷新页面时,值会丢失。

测试由 Zabbix 服务器执行。前端向服务器发送相应的请求并等待结果。请求包含输入值和预处理步骤(具有展开的用户宏)。对于更改节流步骤,可以指定可选的先前值和时间。服务器会以每个预处理步骤的结果响应。

所有技术错误或输入验证错误都显示在测试窗口顶部的错误框中。

测试真实值

要针对真实值测试预处理步骤:

  • 选中从主机获取值复选框
  • 输入或验证主机参数(主机地址、端口、proxy 名称/无 proxy)和特定于项目的细节(例如 SNMPv2 社区或 SNMPv3 安全凭据)。这些字段是上下文感知的:
    • 可能时,值会被预填充,即对于需要agent 的监控项,会从主机的所选agent 接口中获取信息
    • 对于模板项目,必须手动填写这些值
    • 解析明文宏值
    • 如果字段值(或部分值)是一个秘密或 Vault 宏,该字段将为空,必须手动填写。如果任何项目参数包含秘密宏值,则会显示以下警告消息:"项目包含具有秘密值的用户定义宏。应手动输入这些宏的值。"
    • 当不需要在项目类型的上下文中时,这些字段将被禁用(例如,对于计算项目,主机地址和proxy 字段将被禁用)
  • 单击获取值并测试以测试预处理

如果在项目配置表单中指定了值映射('显示值'字段),则项目测试对话框将在最终结果后显示另一行,名称为'应用值映射后的结果'。

从主机获取真实值的特定参数:

参数 描述
从主机获取值 选中此复选框以从主机获取真实值。
主机地址 输入主机地址。
此字段将自动填充为项目主机接口的地址。
端口 输入主机端口。
此字段将自动填充为项目主机接口的端口。
SNMP 接口的附加字段
(SNMP 版本、SNMP 社区、上下文名称等)
有关配置 SNMP 接口(v1、v2 和 v3)的附加详细信息,请参阅配置 SNMP 监控
这些字段将从项目主机接口自动填充。
Proxy 如果主机由proxy 监视,请指定proxy。
此字段将自动填充为主机的proxy(如果有)。
从主机检索到的值。
单击参数字段或查看/编辑按钮 将打开一个值或代码块的文本区域窗口。
当发送到前端的值被截断到最大大小为512KB时,只有在前端显示。如果结果被截断,则会显示一个警告图标。鼠标悬停时显示警告描述。请注意,大于512KB的数据仍然会被 Zabbix 服务器完全处理。

有关其他参数,请参见上面的测试假设值