这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

其他 JavaScript 对象

概述

本节介绍Zabbix对JavaScript语言的支持,该语言使用Duktape和受支持的全局JavaScript函数实现。

内置对象

Zabbix

Zabbix 对象提供与 Zabbix内部功能的交互。

方法 描述
log(loglevel, message) 使用 <loglevel> 日志级别将 <message> 写入 Zabbix 日志(参见配置文件 DebugLevel 参数)。

示例:

Zabbix.log(3, "this is a log entry written with 'Warning' log level")

你可以使用以下别名:

别名 原义
console.log(object) Zabbix.log(4, JSON.stringify(object))
console.warn(object) Zabbix.log(3, JSON.stringify(object))
console.error(object) Zabbix.log(2, JSON.stringify(object))
方法 描述
sleep(delay) 将 JavaScript 执行延迟 delay 毫秒。

示例(延迟执行 15 秒):

Zabbix.sleep(15000)

HttpRequest

该对象封装了 cURL 句柄,允许发送简单的 HTTP请求。 错误将作为异常抛出。

HttpRequest是自 Zabbix 5.4 以来此对象的新名称。 以前它曾经被命名为 CurlHttpRequest。 Zabbix 5.4 中的方法名称也已更改。 旧的对象/方法名称现在已弃用,并且在 Zabbix 6.0 之后将停止对它们的支持。

方法 描述
addHeader(name, value) 添加 HTTP 标头字段。此字段用于所有后续请求,直到使用 clearHeader() 方法清除。
clearHeader() 清除 HTTP 标头。如果没有设置头字段,HttpRequest 会将 Content-Type 设置为 application/json 如果发布的数据是 JSON 格式的;否则文本/纯文本。
connect(url) 向 URL 发送 HTTP CONNECT 请求并返回响应。
customRequest(method, url, data) 允许在第一个参数中指定任何 HTTP 方法。
delete(url, data) 使用可选的 data 负载向 URL 发送 HTTP DELETE 请求并返回响应。
getHeaders(<asArray>) 返回接收到的 HTTP 标头字段的对象。
asArray 参数可以设置为“true”(例如 getHeaders(true))、“false”或未定义。 如果设置为“true”,接收到的 HTTP 标头字段值将作为数组返回; 这应该用于检索多个同名标头的字段值。
如果未设置或设置为“false”,则接收到的 HTTP 标头字段值将作为字符串返回。
get(url, data) 发送 HTTP GET 请求到带有可选 data 负载的 URL 并返回响应。
head(url) 向 URL 发送 HTTP HEAD 请求并返回响应。
options(url) 向 URL 发送 HTTP OPTIONS 请求并返回响应。
patch(url, data) 将 HTTP PATCH 请求发送到带有可选 data 负载的 URL 并返回响应。
put(url, data) 将 HTTP PUT 请求发送到带有可选 data 负载的 URL 并返回响应。
post(url, data) 发送 HTTP POST 请求到带有可选 data 负载的 URL 并返回响应。
getStatus() 返回最后一个 HTTP 请求的状态码。
setProxy(proxy) 将 HTTP 代理设置为“代理”值。如果此参数为空,则不使用代理。
setHttpAuth(bitmask, username, password) 在'bitmask'参数中设置启用的 HTTP 身份验证方法 (HTTPAUTH_BASIC, HTTPAUTH_DIGEST, HTTPAUTH_NEGOTIATE, HTTPAUTH_NTLM, HTTPAUTH_NONE)
HTTPAUTH _NONE 标志允许禁用 HTTP 身份验证。
示例:
request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)
request.setHttpAuth(HTTPAUTH_NONE)
trace(url, data) 发送 HTTP TRACE 请求到带有可选 data 负载的 URL 并返回响应。

示例:

try {
           Zabbix.log(4, 'jira webhook script value='+value);
         
           var result = {
               'tags': {
                   'endpoint': 'jira'
               }
           },
           params = JSON.parse(value),
           req = new HttpRequest(),
           fields = {},
           resp;
         
           req.addHeader('Content-Type: application/json');
           req.addHeader('Authorization: Basic '+params.authentication);
         
           fields.summary = params.summary;
           fields.description = params.description;
           fields.project = {"key": params.project_key};
           fields.issuetype = {"id": params.issue_id};
           resp = req.post('https://tsupport.zabbix.lan/rest/api/2/issue/',
               JSON.stringify({"fields": fields})
           );
         
           if (req.getStatus() != 201) {
               throw 'Response code: '+req.getStatus();
           }
         
           resp = JSON.parse(resp);
           result.tags.issue_id = resp.id;
           result.tags.issue_key = resp.key;
       } catch (error) {
           Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));
           Zabbix.log(4, 'jira issue creation failed : '+error);
         
           result = {};
       }
         
       return JSON.stringify(result);

XML

XML 对象允许处理监控项中的 XML 数据以及底层自动发现预处理和 Webhook。

要使用 XML 对象,必须使用支持 libxml2 编译的Server或proxy。

方法 描述
XML.query(expression, data) 使用 XPath 检索节点内容。 如果未找到节点,则返回 null。
expression - XPath 表达式;
data - XML 数据作为字符串。
XML.toJson(data) 将 XML 格式的数据转换为 JSON。
XML.fromJson(object) 将 JSON 格式的数据转换为 XML。

示例:

输入:

<menu>
           <food type = "breakfast">
               <name>Chocolate</name>
               <price>$5.95</price>
               <description></description>
               <calories>650</calories>
           </food>
       </menu>

输出:

{
           "menu": {
               "food": {
                   "@type": "breakfast",
                   "name": "Chocolate",
                   "price": "$5.95",
                   "description": null,
                   "calories": "650"
               }
           }
       }
序列化规则

XML 到 JSON 的转换将根据以下规则进行处理(对于 JSON 到 XML 的转换,应用相反的规则):

1. XML 属性将被转换为名称前面带有“@”的键。

示例:

输入:

 <xml foo="FOO">
          <bar>
            <baz>BAZ</baz>
          </bar>
        </xml>

输出:

 {
          "xml": {
            "@foo": "FOO",
            "bar": {
              "baz": "BAZ"
            }
          }
        }

2. 自闭合元素 (<foo/>) 将被转换为具有 'null' 值。

示例:

输入:

<xml>
         <foo/>
       </xml>

输出:

{
         "xml": {
           "foo": null
         }
       }

3. 空属性(具有 "" 值)将被转换为具有空字符串 ('') 值。

示例:

输入:

<xml>
         <foo bar="" />
       </xml>

输出:

{
         "xml": {
           "foo": {
             "@bar": ""
           }
         }
       }

4. 具有相同元素名称的多个子节点将被转换为具有值数组作为其值的单个键。

示例:

输入:

<xml>
         <foo>BAR</foo>
         <foo>BAZ</foo>
         <foo>QUX</foo>
       </xml>

输出:

{
         "xml": {
           "foo": ["BAR", "BAZ", "QUX"]
         }
       }

5. 如果文本元素没有属性也没有子元素,它将被转换为字符串。

示例:

输入:

<xml>
           <foo>BAZ</foo>
       </xml>

输出:

{
         "xml": {
           "foo": "BAZ"
          }
       }

6.如果一个文本元素没有子元素,但有属性:文本内容将被转换为一个元素,键为'#text',内容为值; 属性将按照序列化规则 1 中的说明进行转换。

示例:

输入:

<xml>
         <foo bar="BAR">
           BAZ
         </foo>
       </xml>

输出:

{
         "xml": {
           "foo": {
             "@bar": "BAR",
             "#text": "BAZ"
           }
         }
       }

全局 JavaScript 函数

使用 Duktape 实现了额外的全局 JavaScript 函数:

  • btoa(string) - 将字符串编码为 base64 字符串
  • atob(base64_string) - 对 base64 字符串进行解码
try {
           b64 = btoa("utf8 string");
           utf8 = atob(b64);
       } 
       catch (error) {
           return {'error.name' : error.name, 'error.message' : error.message}
       }
  • md5(string) - 计算字符串的 MD5 哈希

  • sha256(string) - 计算字符串的 SHA256 哈希

  • hmac('<hash type>',key,string) - 返回 HMAC 哈希作为十六进制格式的字符串。 支持 MD5 和 SHA256 哈希类型。 键和字符串参数支持二进制数据。 例如:

  • hmac('md5',key,string)

  • hmac('sha256',key,string)