1 Додатни JavaScript објекти

Преглед

Ова секција описује Zabbix додатке JavaScript језику који су имплементирани са Duktape-ом и подржане глобалне JavaScript функције.

Уграђени објекти

Zabbix

Објекат Zabbix обезбеђује интеракцију са интерном функционалношћу.

Пример:

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

Можете користити следеће псеудониме:

Пример (одлагање извршавања за 15 секунди):

Zabbix.sleep(15000)

HttpRequest

Овај објекат обухвата cURL дескриптор, омогућавајући једноставне HTTP захтеве. Грешке се избацују као изузеци.

::: noteimportantИницијализација вишеструких HttpRequest објеката је ограничена на 10 по извршавању скрипте. :::

Пример:

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 објекат омогућава обраду 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 атрибути ће бити конвертовани у кључеве чија имена су почев од '@'.

Пример:

Унос:

 <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 функције

Додатне глобалне JavaScript функције су имплементиране помоћу Duktape-а:

• btoa(data) - кодира податке у base64 стринг;
• atob(base64_string) - декодира base64 стринг као Uint8Array бафер.

try {
            b64 = btoa("test string");
            buffer = atob(b64);
       
       // Имајте на уму да логика декодирања зависи од формата података бафера.
       decoded = String.fromCharCode.apply(this, [].slice.call(buffer));
       } 
       catch (error) {
            return {'error.name' : error.name, 'error.message' : error.message};
       }

• md5(подаци) - израчунава MD5 хеш података
• sha256(подаци) - израчунава SHA256 хеш података
• hmac('<тип хеша>',кључ,подаци) - враћа HMAC хеш као хексадецимално форматирани стринг; MD5 и SHA256 типови хеша су подржани; параметри кључ и податак подржавају бинарне податке. Примери:
• hmac('md5',кључ,подаци)
• hmac('sha256',кључ,подаци)
• sign(хеш,кључ,подаци) - враћа израчунати потпис (RSA потпис са SHA-256) као стринг, где је:
  ** hash** - дозвољен је само 'sha256', у супротном се избацује грешка;
  ** key** - приватни кључ. Требало би да одговара стандарду PKCS#1 или PKCS#8. Кључ може бити дат у различитим облицима:
  
• са размацима уместо нових редова;
• са избегнутим или неизбегнутим \n уместо нових редова;
• без икаквих нових редова као једноредни стринг;
• као стринг у JSON формату.

Кључ се такође може учитати из корисничког макроа/тајног макроа/трезора.

** data** - подаци који ће бити потписани. Може бити стринг (подржани су и бинарни подаци) или бафер (Uint8Array/ArrayBuffer).
OpenSSL или GnuTLS се користе за израчунавање потписа. Ако је Zabbix направљен без било које од ових библиотека за шифровање, појавиће се грешка ('недостаје OpenSSL или GnuTLS библиотека').