Table of Contents

5 JavaScript 预处理

5 JavaScript 预处理

概述

本节提供有关通过JavaScript进行预处理的详细信息。

JavaScript预处理

JavaScript预处理通过调用带有单个参数'value'和用户提供的函数体的JavaScript函数来完成。预处理步骤的结果是该函数返回的值。例如，要执行华氏度到摄氏度的转换，请输入：

return (value - 32) * 5 / 9

在JavaScript预处理参数中，这将被服务器封装到一个JavaScript函数中：

function (value)
       {
          return (value - 32) * 5 / 9
       }

输入参数'value'始终作为string传递。返回值会自动通过toString()方法强制转换为string（如果失败，则错误将作为string值返回），有以下例外情况：

返回undefined值将导致错误；
返回null值将导致丢弃输入值，类似于“自定义失败”操作中的“丢弃值”预处理。

可以通过抛出值/objects（通常是字符串或Error objects）来返回错误。

例如：

if (value == 0)
           throw "Zero input value"
       return 1/value

每个脚本都有一个10秒的执行超时时间（根据脚本不同，触发超时可能需要更长时间）；超过此时间将返回错误。同时强制实施512兆字节的堆内存限制。

当JavaScript预处理步骤的字节码被再次应用时，它会被缓存和重用。对监控项的预处理步骤的任何更改都会导致缓存的脚本被重置并在稍后重新编译。

连续运行失败（3次连续失败）将导致引擎被重新初始化，以减少一个脚本破坏后续脚本执行环境的可能性（此操作将使用调试级别4及更高级别记录）。

JavaScript预处理是使用Duktape JavaScript引擎实现的。

另请参阅：Additional JavaScript objects and global functions

在脚本中使用宏

在JavaScript代码中可以使用用户宏。如果脚本包含用户宏，这些宏将在执行特定预处理步骤之前由server/proxy解析。请注意，当在前端测试预处理步骤时，宏值不会被自动获取，需要手动输入。

当宏被其值替换时，上下文会被忽略。宏值会原样插入到代码中，在将值放入JavaScript代码之前无法添加额外的转义。请注意，在某些情况下，这可能会导致JavaScript错误。

在下面的示例中，如果接收到的值超过{$THRESHOLD}宏的值，则会返回阈值（如果存在）：

var threshold = '{$THRESHOLD}';
       return (!isNaN(threshold) && value > threshold) ? threshold : value;

示例

以下示例说明了如何使用JavaScript预处理。

每个示例包含一个简要描述、JavaScript预处理参数的函数体以及预处理步骤的结果——即函数返回的值。

示例 1：将一个数字（科学计数法转换为 integer）

将数字 "2.62128e+07" 从科学计数法转换为 integer。

return (Number(value))

函数返回的值：26212800。

示例 2：将一个数字（二进制转换为十进制）

将二进制数 "11010010" 转换为十进制数。

return(parseInt(value,2))

函数返回的值：210。

示例 3：对一个数字取整

将数字 "18.2345" 四舍五入到 2 位小数。

return(Math.round(value* 100) / 100)

函数返回的值为：18.23。

示例 4：计算 string 中的字母数量

计算string "Zabbix" 中字母的数量。

return (value.length)

函数返回的值：6。

示例 5：获取剩余时间

获取证书到期日期（格林威治时间 2022 年 2 月 12 月 12:33:56）前的剩余时间（以秒为单位）。

var split = value.split(' '),
           MONTHS_LIST = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'],
           month_index = ('0' + (MONTHS_LIST.indexOf(split[0]) + 1)).slice(-2),
           ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],
           now = Date.now();
       
       return parseInt((Date.parse(ISOdate) - now) / 1000);

函数返回的值：44380233。

示例 6：移除 JSON 属性

通过移除键为 "data_size" 或 "index_size" 的属性来修改 JSON 数据结构。

var obj=JSON.parse(value);
       
       for (i = 0; i < Object.keys(obj).length; i++) {
           delete obj[i]["data_size"];
           delete obj[i]["index_size"];
       }
       
       return JSON.stringify(obj)

函数接受的值：

[
           {
               "table_name":"history",
               "data_size":"326.05",
               "index_size":"174.34"
           },
           {
               "table_name":"history_log",
               "data_size":"6.02",
               "index_size":"3.45"
           }
       ]

函数返回的值：

[
           {
               "table_name":"history"
           },
           {
               "table_name":"history_log"
           }
       ]

示例 7: 将 Apache 状态转换为 JSON

将从 web.page.get Zabbix agent 监控项（例如，web.page.get[http://127.0.0.1:80/server-status?auto]) 接收到的值转换为 JSON object。

// Convert Apache status to JSON
       
       // Split the value into substrings and put these substrings into an array
       var lines = value.split('\n');
       
       // Create an empty object "output"
       var output = {};
       
       // Create an object "workers" with predefined properties
       var workers = {
           '_': 0, 'S': 0, 'R': 0, 'W': 0,
           'K': 0, 'D': 0, 'C': 0, 'L': 0,
           'G': 0, 'I': 0, '.': 0
       };
       
       // Add the substrings from the "lines" array to the "output" object as properties (key-value pairs)
       for (var i = 0; i < lines.length; i++) {
           var line = lines[i].match(/([A-z0-9 ]+): (.*)/);
       
           if (line !== null) {
               output[line[1]] = isNaN(line[2]) ? line[2] : Number(line[2]);
           }
       }
       
       // Multiversion metrics
       output.ServerUptimeSeconds = output.ServerUptimeSeconds || output.Uptime;
       output.ServerVersion = output.ServerVersion || output.Server;
       
       // Parse "Scoreboard" property to get the worker count
       if (typeof output.Scoreboard === 'string') {
           for (var i = 0; i < output.Scoreboard.length; i++) {
               var char = output.Scoreboard[i];
       
               workers[char]++;
           }
       }
       
       // Add worker data to the "output" object
       output.Workers = {
           waiting: workers['_'], starting: workers['S'], reading: workers['R'],
           sending: workers['W'], keepalive: workers['K'], dnslookup: workers['D'],
           closing: workers['C'], logging: workers['L'], finishing: workers['G'],
           cleanup: workers['I'], slot: workers['.']
       };
       
       // Return JSON string
       return JSON.stringify(output);