Documentation

# 1 预处理测试

测试

测试预处理步骤对于确保复杂的预处理流程能够产生预期的结果非常有用，而无需等待接收到并预处理监控项值。

可以针对以下内容进行测试：

• 假设的值
• 来自一个主机的真实值

每个预处理步骤都可以单独测试，也可以一起测试所有步骤。当分别在“操作”区块中点击“测试”或“测试所有步骤”按钮时，将打开一个测试窗口。

测试假设值

参数	描述
Get value from host	如果你想测试一个假设值，请不要勾选此复选框。 另请参阅：测试实际值。
Value	输入要测试的值。 单击参数字段或查看/编辑按钮 将打开一个文本区域窗口，用于输入值或代码块。
Not supported	勾选此复选框以测试不支持的值。 此选项对于测试检查不支持的值预处理步骤非常有用。
Error	输入错误文本。 当取消选中 从 主机 获取值 时，此字段可用，但需选中 不支持。 如果选中 从 主机 获取值，此字段将自动填充来自 主机 的实际错误消息（只读）。
Time	显示输入值的时间：now（只读）。
Previous value	输入一个先前的值用于比较。 仅适用于变更和节流预处理步骤。
Previous time	输入用于比较的先前输入值时间。 仅适用于变更和节流预处理步骤。 默认值基于监控项的“更新间隔”字段值（如果为“1m”，则此字段填入now-1m）。如果未指定内容或用户无法访问主机，默认值为now-30s。
Macros	如果使用了任何宏，它们将与对应的值一并列出。这些值在测试过程中可编辑，但更改仅在测试上下文中保存。
End of line sequence	选择多行输入值的行结束序列： LF - LF（换行）序列 CRLF - CRLF（回车换行）序列。
Preprocessing steps	预处理步骤已列出；每次点击测试按钮后，将显示对应步骤的测试结果。 测试结果在发送到前端时会被截断至最大512KB大小。如果结果被截断，则会显示一个警告图标，鼠标悬停时会显示警告描述。请注意，Zabbix server仍会完整处理超过512KB的数据。 如果测试过程中该步骤失败，则会显示一个错误图标，鼠标悬停时会显示错误描述。 如果为该步骤指定了“自定义失败操作”并执行了该操作，则在预处理测试步骤行之后会新增一行，显示执行了什么操作以及该操作产生的结果（错误或值）。
Result	测试预处理步骤的最终结果在所有步骤一起测试时（当您单击 Test all steps 按钮时）显示。 转换 version 到 监控项 的值类型也会显示，例如 Result converted to Numeric (unsigned)。 测试结果在发送到前端时会被截断为最大512KB。如果结果被截断，则会显示一个警告图标。将鼠标悬停在警告图标上时会显示警告描述。请注意，Zabbix server 仍然会完全处理大于512KB的数据。

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

测试值在测试会话之间为各个步骤存储 或所有步骤，允许用户更改预处理步骤或 监控项 配置，然后在不关闭测试窗口的情况下返回 重新输入信息。页面刷新时值会丢失。

测试由Zabbix server完成。前端发送相应的 向服务器发送请求并等待结果。请求包含以下内容： 输入值和预处理步骤（展开的用户宏）。 变更和节流步骤，可选的先前值和时间可以 被指定。服务器以每个预处理的结果进行响应 步骤。

所有技术错误或输入验证错误都会在界面中显示。 测试窗口Top的错误框。

测试实际值

要针对实际值测试预处理：

• 勾选 从 主机 获取值 复选框
• 输入或验证 主机 参数（主机 地址、端口、proxy 名称/编号 proxy）和监控项特定的详细信息（例如 SNMPv2 团体名或 SNMPv3 安全凭据）。这些字段是上下文相关的：
  • 当可能时，值会预先填充，例如，对于 监控项 requiring an agent, 通过从选定的信息中提取 agent 接口属于 主机
  • 需要为模板 监控项 手动填写值
  • 纯文本宏值将被解析
  • 当字段值（或部分值）为秘密信息或 Vault宏，该字段将为空，必须手动填写。如果任何 监控项 参数包含一个密钥宏值，如下所示 警告信息显示：“监控项 包含用户自定义宏” 带有密文值。这些宏的值应被输入 手动。
  • 在不需要的上下文环境中，这些字段会被禁用 监控项 类型（例如，主机 地址和 proxy 字段是 disabled for calculated 监控项
• 点击 Get value and test 以测试预处理

如果在监控项配置表单中指定了值映射 “显示值”字段），监控项 测试对话框将在其后显示另一行 最终结果，名为“应用值映射后的结果”。

从 一个主机 获取真实值时特有的参数：

参数	描述
Get value from host	勾选此复选框以从 主机 中 get 一个真实值。
Host address	输入 主机 地址。 此字段由 监控项 主机 接口的地址自动填充。
Port	输入 主机 端口。 此字段由 监控项 主机 接口的端口自动填充。
Additional fields for SNMP interfaces (SNMP version, SNMP community, Context name, etc.)	有关配置 SNMP 接口（v1、v2 和 v3）的更多详细信息，请参见 步骤-2。 这些字段将从 监控项 主机 接口自动填充。
Proxy	如果由proxy监控主机，请指定proxy。 该字段将自动填写为主机的proxy（如果有的话）。
Value	从 主机 中检索到的值。 单击参数字段或查看/编辑按钮 将打开一个文本区域窗口以显示该值或代码块。 值会被截断为最大 512KB，且仅在前端界面中进行截断。如果结果被截断，则会显示一个警告图标。鼠标悬停时会显示警告描述。请注意，Zabbix server 仍会完整处理大于 512KB 的数据。

对于其余参数，请参见测试假设 值 以上。