1 其他 JavaScript 对象

概述

本节介绍了 Zabbix 对使用 Duktape 实现的 JavaScript 语言所做的扩展，以及受支持的全局 JavaScript 函数。

内置对象

Zabbix

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

示例：

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

您可以使用以下别名：

示例（将执行延迟 15 秒）：

Zabbix.sleep(15000)

HttpRequest

该对象封装了 cURL 句柄，可用于发起简单的 HTTP 请求。 错误会以异常形式抛出。

示例：

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://jira.example.com/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 对象允许在监控项和低级发现预处理中以及 webhook 中处理 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(data) - 将数据编码为 base64 字符串。
• atob(base64_string) - 将 base64 字符串解码为 Uint8Array 缓冲区。

try {
    b64 = btoa("test string");
    buffer = atob(b64);

    // Note that decoding logic depends on the data format of the buffer.
    decoded = String.fromCharCode.apply(this, [].slice.call(buffer));
} 
catch (error) {
    return {'error.name' : error.name, 'error.message' : error.message};
}

• md5(data) - 计算数据的 MD5 哈希值。
• sha256(data) - 计算数据的 SHA256 哈希值。

• hmac('<hash type>',key,data) - 以十六进制格式字符串形式返回 HMAC 哈希值；hash type 支持 md5 和 sha256；key 和 data 参数支持二进制数据。

  示例：

  • hmac('md5',key,data)
  • hmac('sha256',key,data)

• sign(hash,key,data) - 以字符串形式返回计算出的签名（使用 SHA-256 的 RSA 签名），其中：
  hash - 仅允许使用 sha256，否则将抛出错误。
  key - 私钥。 它应符合 PKCS#1 或 PKCS#8 标准。 密钥可以通过不同形式提供：
  

  • 使用空格代替换行
  • 使用转义或未转义的 \n 代替换行
  • 不包含任何换行，作为单行字符串
  • 作为 JSON 格式字符串

  密钥也可以从用户宏/密文宏/vault 中加载。

  data - 将被签名的数据。 它可以是字符串（也支持二进制数据）或缓冲区（Uint8Array/ArrayBuffer）。

  示例：

  • sign('sha256',key,data)

  使用 OpenSSL 或 GnuTLS 计算签名。 如果 Zabbix 在构建时未包含这些加密库中的任何一个，则会抛出错误（'missing OpenSSL or GnuTLS library'）。