18 脚本监控项

概览

脚本监控项可以通过执行用户自定义的JavaScript代码,检索HTTP/HTTPS的方式来收集数据。除了脚本外,可以指定一个可选的参数列表(一些键值对)并配置超时限制。

此监控项类型在有收集数据过程中需要多个步骤或复杂逻辑的场景非常有用。举个例子,一个脚本监控项可以被配置为执行一个HTTP调用,然后经过某些方式处理从第一步调用得到的数据,并将转换后的数值传递给第二个HTTP调用。

脚本监控项由 Zabbix server 或 proxy的轮询器处理。

配置

监控项配置表单Type 字段中选择 Script,然后填写必填字段。

script\_item.png

所有必填输入字段都用红色星号标记。

Script 监控项需要填写特定信息的字段如下:

Field Description
Key 输入一个唯一的键值,用于标识该监控项。
Parameters 指定要传递给脚本的变量,采用属性和值对的形式。
支持用户宏。要查看支持哪些内置宏,请在支持的宏表中搜索“Script-type item”。
Script 在参数字段中单击,或单击其旁边的铅笔图标时打开的模态编辑器中输入 JavaScript 代码。该代码必须提供返回指标值的逻辑。
该代码可以访问所有参数,以及 Zabbix 添加的所有附加 JavaScript 对象
另请参见:JavaScript Guide
Timeout JavaScript 执行超时(1-600 秒;超过该时间将返回错误)。
请注意,根据脚本的不同,触发超时可能需要更长时间。
有关 Timeout 参数的更多信息,请参见通用监控项属性

示例

简单的数据采集

https://www.example.com/release\_notes 页面收集内容:

  • 创建一个监控项,类型选择”脚本“。 \
  • 脚本字段填写下面的代码:
var request = new HttpRequest();
return request.get("https://www.example.com/release_notes");
带参数收集数据

收集特定页面的内容并使用参数:

  • 创建一个 "脚本 "类型的项目,并设置两个参数:
    • url : {$DOMAIN}(应定义用户宏 {$DOMAIN},最好是在主机级定义)
    • 子页面 : /release_notes**

  • Script 字段中输入
var obj = JSON.parse(value);
var url = obj.url;
var subpage = obj.subpage;
var request = new HttpRequest();
return request.get(url + subpage);
多个 HTTP 请求

同时收集 https://www.example.comhttps://www.example.com/release\_notes

  • 创建一个类型为 "脚本 "的监控项。
  • Script 字段中输入
var request = new HttpRequest();
return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes");
日志

在 Zabbix 服务器日志中添加 "日志测试 "项并接收监控项 值 "1":

  • 创建一个类型为 "脚本 "的监控项。
  • Script 字段中输入
Zabbix.log(3, 'Log test');
return 1;