Table of Contents

1 追加のJavaScriptオブジェクト

1 追加のJavaScriptオブジェクト

概要

本セクションでは、Duktapeで実装された JavaScript の Zabbix への追加と、サポートされるグローバル JavaScript 関数について説明します。

組込オブジェクト

Zabbix

ZabbixオブジェクトはZabbixの内部機能とのインタラクションを提供します。

メソッド	説明
`log(loglevel, message)`	Writes <message> into Zabbix log using <loglevel> log level (see configuration file DebugLevel parameter).

例:

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)`	Delay JavaScript execution by `delay` milliseconds.

例（実行を15秒遅らせる）:

Zabbix.sleep(15000)

HttpRequest

このオブジェクトは cURL ハンドルをカプセル化し、シンプルな HTTP リクエストを発行できるようにします。エラーは例外としてスローされます。

複数の HttpRequest オブジェクトの初期化は、スクリプト実行ごとに 10 個までに制限されています。

メソッド	説明
`addHeader(value)`	HTTP ヘッダーフィールドを追加します。このフィールドは、`clearHeader()` メソッドでクリアされるまで、以降のすべてのリクエストで使用されます。 1 つの `HttpRequest` オブジェクトに追加できるヘッダーフィールドの合計長は、128 KB に制限されています（特殊文字とヘッダー名を含む）
`clearHeader()`	HTTP ヘッダーをクリアします。ヘッダーフィールドが設定されていない場合、POST されるデータが JSON 形式であれば、`HttpRequest` は Content-Type を application/json に設定します。それ以外の場合はtext/plainです。
`connect(url)`	URLにHTTP CONNECTリクエストを送信し、レスポンスを返します。
`customRequest(method, url, data)`	最初のパラメータに任意のHTTPメソッドを指定できます。メソッドリクエストをURLに送信し、オプションのdataペイロードを指定し、レスポンスを返します。
`delete(url, data)`	HTTP DELETEリクエストをURLに送信し、オプションのdataペイロードを指定し、レスポンスを返します。
`getHeaders(<asArray>)`	受信したHTTPヘッダーフィールドのオブジェクトを返します。 `asArray`パラメータは、"true"（例：`getHeaders(true)`）、"false"、またはundefinedに設定できます。"true"に設定した場合、受信したHTTPヘッダーフィールドの値は配列として返されます。これは、複数の同名ヘッダーのフィールド値を取得するために使用します。設定されていない場合、または "false" に設定されている場合、受信した HTTP ヘッダーフィールド値は文字列として返されます。
`get(url, data)`	オプションの data ペイロードを含む HTTP GET リクエストを URL に送信し、レスポンスを返します。
`head(url)`	HTTP HEAD リクエストを URL に送信し、レスポンスを返します。
`options(url)`	HTTP OPTIONS リクエストを URL に送信し、レスポンスを返します。
`patch(url, data)`	オプションの data ペイロードを含む HTTP PATCH リクエストを URL に送信し、レスポンスを返します。
`put(url, data)`	オプションの data ペイロードを含む HTTP PUT リクエストを URL に送信し、レスポンスを返します。
`post(url, data)`	オプションの data ペイロードを含む HTTP POST リクエストを URL に送信し、レスポンスを返します。
`getStatus()`	最後のHTTPリクエストのステータスコードを返します。
`setProxy(proxy)`	HTTPプロキシを"proxy"値に設定します。このパラメータが空の場合、プロキシは使用されません。
`setHttpAuth(bitmask, username, password)`	有効なHTTP認証方法（HTTPAUTH_BASIC、HTTPAUTH_DIGEST、HTTPAUTH_NEGOTIATE、HTTPAUTH_NTLM、HTTPAUTH_NONE）を'bitmask'パラメータに設定します。 HTTPAUTH_NONEフラグを指定すると、HTTP認証を無効にできます。例: `request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)` `request.setHttpAuth(HTTPAUTH_NONE)`
`trace(url, data)`	HTTP TRACEリクエストをURLに送信し、オプションのdataペイロードを指定してレスポンスを返します。

例:

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オブジェクトは、item 内のXMLデータの処理と、ローレベルディスカバリープリプロセッシングおよびウェブフックを可能にします。

XMLオブジェクトを利用するためには，libxml2がサポートされた状態で server / proxy がコンパイルされている必要があります。

メソッド	説明
`XML.query(data, expression)`	Retrieves node content using XPath. Returns null if node is not found. expression - an XPath expression; data - XML data as a string.
`XML.toJson(data)`	Converts data in XML format to JSON.
`XML.fromJson(object)`	Converts data in JSON format to XML.

例:

Input:

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

Output:

{
           "menu": {
               "food": {
                   "@type": "breakfast",
                   "name": "Chocolate",
                   "price": "$5.95",
                   "description": null,
                   "calories": "650"
               }
           }
       }

シリアライズ規則

XMLからJSONへの変換は、以下の規則に従って処理されます（JSONからXMLへの変換は、逆の規則が適用されます）。

1. XML の属性は、名前の先頭に '@' を付加したキーに変換されます。

例:

Input:

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

Output:

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

2. セルフクロージングの要素（<foo/>）は、'null'値を持つものとして変換されます。

例:

Input:

<xml>
         <foo/>
       </xml>

Output:

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

3. 空の属性（""の値）は、空文字列（''）の値として変換されます。

例:

Input:

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

Output:

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

4. 同じ要素名を持つ複数の子ノードは、値の配列を値とする1つのキーに変換されます。

例:

Input:

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

Output:

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

5. text 要素に属性がなく、子要素もない場合は、文字列として変換されます。

例:

Input:

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

Output:

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

6. text 要素に子がなく、属性がある場合、text の内容はキーが 'text'、値が content の要素に変換され、
属性はシリアライズ規則 1 のとおりに変換されます。

例:

Input:

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

Output:

{
         "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 ハッシュを計算します。

Documentation

1 追加のJavaScriptオブジェクト

概要

組込オブジェクト

Zabbix

HttpRequest

XML

シリアライズ規則

グローバル JavaScript 関数