Lahendame praktilisi ülesandeid Zabbixis JavaScripti abil

Tihhon Uskov, Zabbixi integreerimismeeskonna insener

Zabbix on kohandatav platvorm, mida kasutatakse igasuguste andmete jälgimiseks. Zabbixi varajastes versioonides olid monitorimise administreerijatel võimalus käivitada erinevaid skripte läbi Tegevused sihtpunkte võrku kontrollideks. Siiski, skriptide käivitamine tõi kaasa mitmeid keerukusi, sealhulgas skriptide toetamise vajadus, nende edastamine sidepunktidesse ja proxidesse ning erinevate versioonide toetamine.

JavaScript Zabbixi jaoks

Aprillis 2019 esitleb Zabbix 4.2, milles on JavaScripti eelprotsessimise funktsioon. Paljud innustusid loobuma skriptide kirjutamisest, mis kusagilt andmeid võtavad, neid töötlevad ja Zabbixi formaadis edastavad. Selle asemel soovitakse teha lihtsaid kontrollimisi, mis saavad Zabbixile mittevalmis andmeid ning seejärel töötlevad seda andmevoogu Zabbixi ja JavaScripti vahendeid kasutades. Koos madalama taseme tuvastamise ja sõltuvate andmeelementidega, mis ilmusid Zabbix 3.4-s, saadi piisavalt paindlik kontseptsioon saadud andmete sorteerimiseks ja haldamiseks.

Zabbix 4.4-s, loogilise jätkuna JavaScripti eelprotsessimisele, ilmus uus teavitamise meetod — Webhook, mida saab kasutada Zabbixi teavituste lihtsaks integreerimiseks kolmandate osapoolte rakendustega.

JavaScript ja Duktape

Miks valiti just JavaScript ja Duktape? Kaaluakse erinevaid keeli ja mootorite variante:

• Lua – Lua 5.1
• Lua – LuaJIT
• JavaScript – Duktape
• JavaScript – JerryScript
• Sisseehitatud Python
• Sisseehitatud Perl

Peamised valikukriteeriumid olid laialdane kasutamine, mootoritootmise lihtsus, madal ressursi kasutus ja mootorite üldine jõudlus, samuti selle keele koodi turvalisus jälgimisel. Nende näitajate kombinatsioonis võitis JavaScript Duktape'i mootori.

Valikukriteeriumid ja jõudlustestimine

Duktape'i omadused:

— Standard ECMAScript E5/E5.1
— Zabbixi moodulid Duktape'ile:

• Zabbix.log() — võimaldab kirjutada otse Zabbix Serveri logisse teateid erineva detailsuse tasemega, mis võimaldab seotud vigu võrreldes näiteks Webhooki ja serveri olekuga.
• CurlHttpRequest() — võimaldab teha HTTP-päringuid võrku, millel põhineb Webhooki kasutamine.
• atob() ja btoa() — võimaldavad kodeerida ja dekodeerida stringe Base64 formaati.

MÄRKUS. Duktape vastab ACME standarditele. Zabbixis kasutatakse 2015. aasta skripti versiooni. Järgmised muudatused on ebaolulised, mistõttu neid võib ignoreerida..

JavaScripti maagia

Kogu JavaScripti maagia seisneb dünaamilises tüüpide määramises ja tüüpide ümbersuunamises: stringide, numbrite ja loogiliste väärtuste osas.

See tähendab, et ei ole vaja eelnevalt kuulutada, millist tüüpi muutuja peaks väärtust tagastama.

Matemaatiliste operatsioonide käigus muudetakse funktsioonide operaatorite tagastatud väärtused numbriteks. Erandiks sellistes operatsioonides on liitmine, kuna kui vähemalt üks liidetav on string, rakendatakse kõigile liidetavatele stringi konverteerimist.

MÄRKUS. Meetodid, mis vastutavad selliste konversioonide eest, on tavaliselt rakendatud objektide vanematel prototüüpidel, valueOf ja toString. valueOf kutsutakse esile numbrilise konverteerimise käigus ja esineb alati meetodi ees toString. Meetod valueOf peab tagastama primitiivsed väärtused, vastasel juhul ignoreeritakse selle tulemust.

Objekti puhul kutsutakse esile meetod valueOF. Kui seda ei leita või see ei tagasta primitiivset väärtust, kutsutakse esile meetod toString. Kui meetod toString ei leita, otsitakse valueOf objekti prototüübist ja kõik kordub kuni väärtuse töötlemise lõpuni ja kõigi väljendi väärtuste ühtse tüübi saamiseni. Kui objekti jaoks on rakendatud meetod toString, mis tagastab primitiivse väärtuse, kasutatakse just seda stringi konverteerimisel. Sel juhul ei ole selle meetodi rakendamise tulemus tingimata string.

Näiteks, kui objekti ‘obj‘ jaoks on määratud meetod toString,

`var obj = { toString() { return "200" }}` 

meetod toString tagastab just stringi ja kui liidame stringi numbriga, saame kokku seotud stringi:

`obj + 1 // '2001'` 

`obj + 'a' // ‘200a'`

Kuid kui kirjutada ümber toString, nii et meetod tagastab numbri, toimub objekti liitmisel matemaatiline operatsioon numbriliseks teisendamiseks ja tulemuseks on matemaatiline liitmine.

`var obj = { toString() { return 200 }}` 

`obj + 1 // '2001'`

Siinkohal, kui teeme liitmise stringiga, toimub stringi teisendamine ja saame seotud stringi.

`obj + 'a' // ‘200a'`

Just siin peitub algajate JavaScripti kasutajate paljude vigade põhjus.

Meetodisse toString võib kirjutada funktsiooni, mis suurendab objekti praegust väärtust 1 võrra.

Skripti täitmine juhul, kui muutuja on 3 ja see samal ajal on 4.

Tüüpide teisendusega võrreldes (==) kutsub iga kord välja meetodi toString väärtuse suurendamise funktsioon. Vastavalt sellele suurendatakse iga järgneva võrdluse korral väärtust. Seda saab vältida, kasutades tüüpide teisendamiseta võrreldes (===).

Tüüpide teisendamiseta võrdlemine

MÄRKUS. Ärge kasutage tüüpide ülekandmist ilma vajaduseta.

Kuna keerulistes skriptides, näiteks keeruka loogikaga Webhookides, on vajalik tüüpide võrdlemine, on soovitatav eelnevalt kontrollida muutujate tagastatud väärtusi ning käsitseda võimalikke ebakõlasid ja vigu.

Webhook Media

2019. aasta lõpus ja 2020. aasta alguses töötas Zabbixi integreerimismeeskond aktiivselt Webhookide ja 'kastist välja' integreeringute arendamise kallal, mis on Zabbixi jaotises saadaval.

• Discord
• Jira
• Jira Service Desk
• Mattermost
• Microsoft Teams
• Opsgenie
• OTRS
• Pagerduty
• Pushover
• Redmine
• ServiceNow
• SINGL4
• Slack
• Telegram
• Zammad
• Zendesk

Link dokumentatsiooni

Eelprotsessimine

• Eelprotsessi ilmumine JavaScriptis on võimaldanud loobuda enamikust välistest skriptidest, ning hetkel on Zabbixis võimalik saada mistahes väärtus ja muuta see täiesti teiseks väärtuseks.
• Eelprotsessimine Zabbixis on rakendatud JavaScripti koodi abil, mis kompileerimise käigus byte-koodiks muudetakse funktsiooniks, mis võtab parameetrina vastu ühe väärtuse value stringina (stringis võib olla nii number kui arv).
• Kuna väljundiks on funktsioon, on skripti lõpus vajalik return.
• Kohandatud makrode kasutamine koodis on võimalik.
• Ressursse saab piirata mitte ainult operatsioonisüsteemi tasemel, vaid ka programmiliselt. Ettevalmistusetapis eraldatakse maksimaalselt 10 megabaiti peamälu ja käitusaeg on piiratud 10 sekundiga.

MÄRKUS. 10-sekundilised ajamuudatuse väärtused on üsna suured, kuna tuhandete andmepunktide kogumine ühe sekundi jooksul piisavalt „rasketes” ettevalmistusskeemides võib Zabbixi toimimist aeglustada. Seetõttu ei soovitata ettevalmistust kasutada täielike JavaScripti skriptide täitmiseks nii nimetatud „varjatud andmepunktide” (dummy items) kaudu, mis käivitatakse ainult ettevalmistuse täitmiseks..

Oma koodi saab kontrollida ettevalmistustesti või utiliidi kaudu. zabbix_js:

`zabbix_js -s *script-file -p *input-param* [-l log-level] [-t timeout]`

`zabbix_js -s script-file -i input-file [-l log-level] [-t timeout]`

`zabbix_js -h`

`zabbix_js -V`

Praktilised ülesanded

Ülesanne 1

Asenda arvutatud andmepunkt ettevalmistusega.

Tingimus: saame andurilt temperatuuri Fahrenheiti kraadides, et salvestada seda Celsiuse kraadides.

Varem oleksime loonud andmeelemendi, mis koguks temperatuuri Fahrenheiti kraadides. Seejärel veel ühe andmeelemendi (arvutatud), mis valemi abil muundaks Fahrenheiti kraadid Celsiuse kraadideks.

Probleemid:

• Kohustuslik on andmeelementide kopeerimine ja kõik väärtuste salvestamine andmebaasi.
• On vajalik kooskõlastada intervallid «vanema» andmeelemendi jaoks, mis arvutatakse ja mida kasutatakse valemis, ja arvutatud andmeelemendi jaoks. Vastasel juhul võib arvutatud andmeelement sattuda toetamatusse olekusse või arvutada eelneva väärtuse, mis mõjutab jälgimise tulemuste usaldusväärsust.

Üks lahendusi oli loobuda paindlikest kontrollintervallidest fikseeritud intervallide kasuks, et tagada arvutatud andmeelemendi alati arvutamine pärast andmeelemendi, mis kogub andmeid (meie puhul Fahrenheiti kraadides temperatuuri).

Kuid kui näiteks kasutame šablonit paljude seadmete kontrollimiseks ja kontroll toimub iga 30 sekundi järel, siis 29 sekundit Zabbix «töötleb» ja viimasel sekundil hakkab see kontrollima ja arvutama. See toob kaasa järjekorra ja mõjutab jõudlust. Seetõttu on soovitatav kasutada fikseeritud intervalle ainult siis, kui see on tõeliselt vajalik.

Selles ülesandes on optimaalne lahendus kasutada ühe rea eelprotsessimist JavaScriptis, mis konverteerib Fahrenheit kraadid Celsiuse kraadideks:

`return (value - 32) * 5 / 9;`

See on kiire ja lihtne, ei pea looma ülearuseid andmeelemente ja nende ajalugu salvestama ning saab kasutada ka paindlikke intervalle kontrollideks.

`return (parseInt(value) + parseInt("{$EXAMPLE.MACRO}"));`

Kuid kui hüpoteetilises olukorras on vajalik saadud andmeelement summeerida näiteks mingisuguse makros määratletud konstantiga, tuleb arvesse võtta, et parameeter value muudetakse stringiks. Stringide liitmisel ühendatakse kaks stringi lihtsalt üheks.

`return (value + "{$EXAMPLE.MACRO}");`

Matemaatilise tehte tulemuse saamiseks tuleb saadaolevad väärtused arvu formaati viia. Selleks saab kasutada funktsiooni parseInt(), mis tagastab täisarvu, funktsiooni parseFloat(), mis tagastab komakohaga arvu, või funktsiooni number, mis tagastab kas täisarvu või komakohaga arvu.

Ülesanne 2

Saada aega sekundites kuni sertifikaadi lõppemiseni.

Tingimus: üks teenus annab sertifikaadi lõppemise kuupäeva formaadis "Feb 12 12:33:56 2022 GMT".

ECMAScript5-s Date.parse() võtab kuupäeva ISO 8601 formaadis (YYYY-MM-DDTHH:mm:ss.sssZ). On vajalik viia string formaati MMM DD YYYY HH:mm:ss ZZ

Probleem: kuu väärtus on väljendatud tekstina, mitte numbrina. Sellisel formaadil andmeid Duktape ei aktsepteeri.

Lahenduse näide:

• Esiteks kuulutatakse välja muutuja, mis võtab väärtuse (kogu skript koosneb muutuja määratlemisest, mis on loetletud koma abil).

• Esimeses reas saame kuupäeva parameetris value ja eraldame selle tühikutega meetodi split. Nii saame massiivi, kus iga massiivi element, alustades indeksist 0, vastab ühele kuupäeva elemendile enne ja pärast tühikut. split(0) — kuu, split(1) — päev, split(2) — aeg ja muud. Pärast seda saab iga kuupäeva elementi massiivis indeksiga küsida.

`var split = value.split(' '),`

• Iga kuule (kronoloogilises järjestuses) vastab massiivi elementide indeks (0 kuni 11). Tekstilise väärtuse numbriliseks konverteerimiseks liidetakse kuuni indeksile üks (sest kuude numbrimine algab 1-st). Samas on see väljend, kus liidetakse üks, pandud sulgudesse, kuna muidu saame stringi, mitte arvu. Lõpus täidame slice() — massiivi lõike, et jätta alles ainult kaks numbrit (mis on olulised kahe numbri kuude puhul).

`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),`

• Moodustame saadud väärtustest stringi ISO formaadis, liites stringe vastavas järjekorras.

`ISOdate = split[3] + '-' + month_index + '-' + split[1] + 'T' + split[2],`

Saadud formaadis andmed — sekundite arv 1970. aastast kuni mingi hetk tulevikus. Andmete kasutamine saadud formaadis Zabbix'i käivitustes on praktiliselt võimatu, kuna Zabbix võimaldab töötada vaid makrodega {Date} ja {Time}, mis tagastavad kuupäeva ja kellaaega kasutajale arusaadavas formaadis.

• Pärast seda saame JavaScriptis saada praeguse kuupäeva Unix Timestamp formaadis ja lahutada selle saadud sertifikaadi lõppkuupäeva väärtusest, et arvutada millisekundite arv praegusest hetkest kuni sertifikaadi lõppemise hetkeni.

`now = Date.now();`

• Jagame saadud väärtuse tuhandega, et saada sekundid Zabbixis.

`return parseInt((Date.parse(ISOdate) - now) / 1000);`

Tingimustes võib kasutada väljendit ‘last<‘ ja numbrite kogumit, mis vastab sekundi arvule ajavahemikus, millele tuleb reageerida, näiteks nädalates. Nii teavitab tingimus, et sertifikaadi kehtivus aegub nädala jooksul.

MÄRKUS. Pange tähele, et kasutatakse parseInt() funktsioonis return, et konverteerida murdarv, mis on saadud millisekundite jagamisest, täisarvuks. Samuti võib kasutada parseFloat() ja säilitada murdarve..

Vaata ettekannet

Allikas: habr.com