Praktiliste probleemide lahendamine Zabbixi abil JavaScripti kaudu

Tihon Uskov, Zabbixi integreerimise meeskonna insener

Zabbix on kohandatav platvorm, mida kasutatakse igasuguste andmete jälgimiseks. Alates Zabbixi varasematest versioonidest on jälgimisadminsitratoritel olnud võimalus käivitada erinevaid skripte läbi Toimingud sihtvõrkude sõlmedes. Samas skriptide käivitamine tekitas mitmeid keerukusi, sealhulgas skriptide toetamise, nende edastamise sidepunkte ja proksisse, samuti erinevate versioonide toe.

Zabbixi jaoks JavaScript

Aprillis 2019 esitati Zabbix 4.2, mis sisaldas JavaScripti eelprotsessimisfunktsiooni. Paljud innustasid loobuma skriptide kirjutamisest, mis toovad andmeid, töötlevad neid ja esitlevad Zabbixile arusaadaval kujul. Selle asemel soovisid nad teostada lihtsaid kontrolle, mis saaksid Zabbixile töötlemiseks ja hoiustamiseks mittesobivaid andmeid ning seejärel neid Zabbixi ja JavaScripti abil töödelda. Koos madala taseme avastamise ja sõltuvate andmeelemenditega, mis ilmusid Zabbixis 3.4, saadi üsna paindlik kontseptsioon saadud andmete sorteerimiseks ja haldamiseks.

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

JavaScript ja Duktape

Miks valiti just JavaScript ja Duktape? Kaalu all olid erinevad keelte ja mootori variandid:

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

Peamised valikukriteeriumid olid levik, mootori lihtne integreerimine tootesse, madal ressursikasutus ning mootori üldine jõudlus ja koodi turvalisus selle keele jälgimisse. Kokkuvõttes võitis JavaScript Duktape mootoril.

Valikukriteeriumid ja jõudlushindamine

Duktape omadused:

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

• Zabbix.log() — võimaldab kirjutada Zabbixi serveri logisse sõnumeid erineva detailsuse tasemega, mis võimaldab seostada vigu, näiteks Webhookis, serveri olekuga.
• CurlHttpRequest() — võimaldab teha HTTP-päringuid võrgus, millel põhineb Webhooki rakendamine.
• atob() ja btoa() — võimaldab kodeerida ja dekodeerida stringe Base64 vormingusse.

MÄRKUS. Duktape vastab ACME standarditele. Zabbixis kasutatakse 2015. aasta skripti versiooni. Edasised muudatused on ebaolulised, seega võib need ignoreerida..

JavaScripti maagia

Kogu JavaScripti maagia seisneb dünaamilises tüpiseerimises ja tüüpide konverteerimises: stringidesse, numbriteks ja loogilisteks.

See tähendab, et muutujate tüüpi ei pea ette teatama.

Matemaatilistes operatsioonides konverteeritakse väärtused, mida operaator-funktsioonid tagastavad, numbriteks. Ainus erand on liitmine, kuna kui vähemalt üks liitja on string, rakendatakse kõigile liitjatele stringi konverteerimist.

MÄRKUS. Meetodid, mis on vastutavad selliste konverteerimiste eest, on tavaliselt realiseeritud objektide vanemprototüüpides, valueOf ja toString. valueOf kutsutakse esile numbrilise konverteerimise korral ja alati enne meetodit toString. Meetod valueOf peab tagastama primitiivseid väärtusi, vastasel juhul ignoreeritakse selle tulemust.

Objekti jaoks kutsutakse üles meetod valueOF. Kui seda ei leita või see ei tagasta primitiivset väärtust, kutsutakse esile meetod toString. Kui meetod toString ei leidu, otsitakse valueOf objekti prototüübist ja kõik kordub, kuni väärtuse töötlemine ja kõikide väljendis olevate väärtuste tüüpide konverteerimine on lõpetatud.. Kui objektil on realiseeritud meetod toString, mis tagastab primitiivse väärtuse, siis kasutatakse just seda stringi konverteerimiseks. Selle tulemusena ei pruugi selle meetodi rakendamise tulemus olla string.

Näiteks, kui objektile ‘obj‘ määratakse meetod toString,

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

meetod toString tagastab täpselt stringi ja kui liidame stringi numbriga, saame ühendatud stringi:

`obj + 1 // '2001'` 

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

Kuid kui me ümber kirjutame toString, et meetod tagastaks numbri, toimub objekti liitmisel matemaatiline operatsioon koos numbrilise konverteerimisega ja saame matemaatilise liitmise tulemuse.

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

`obj + 1 // '2001'`

Sel juhul, kui me teeme liitmise stringiga, toimub stringi konverteerimine ja me saame ühendatud stringi.

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

Just selles peitub paljude JavaScripti algajate vigade põhjus.

Meetodisse toString võib kirjutada funktsiooni, mis suurendab objekti praeguseid väärtusi ühe võrra.

Skripti täitmine, kui muutuja on 3 ja see on ka 4.

Tüüpide võrdlemisel (==) rakendatakse iga kord meetodit toString väärtuse suurendamiseks. Seega suurendatakse väärtust iga järgneva võrdlemisega. Seda saab vältida, kasutades tüüpide võrdlemist ilma teisendamiseta (===).

Tüüpide võrdlemine ilma teisendamiseta

MÄRKUS. Ärge kasutage tüübi võrdlemist, välja arvatud vajaduse korral.

Kompikad skriptid, näiteks Webhook koos keerulise loogikaga, kus tüüpide võrdlemine on vajalik, soovitatakse eelnevalt kirjutada kontrollid muutuja väärtuste jaoks ja käsitleda vastuolusid ja vigu.

Webhook Media

2019. aasta lõpust ja 2020. aasta algusest tegeleb Zabbixi integreerimismeeskond Webhookide ja "välja pakutud" integratsioonide aktiivse arendamisega, mis tarnitakse Zabbixi jaotises.

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

Link dokumentatsioon

Eeltöötlus

• JavaScripti eeltöötluse kohalolek on võimaldanud loobuda enamikest välisest skriptist ning praegu on Zabbixis võimalik saada mistahes väärtus ja muuta see täiesti uueks väärtuseks.
• Zabbixis rakendatakse eeltöötlemist JavaScripti koodi abil, mis kompileerimise käigus muutub hübriidiks, mis võtab ühe väärtuse parameetrina. value siis stringina (stringis võib olla nii number kui ka arv).
• Kuna väljundina saadakse funktsioon, on skripti lõpus kohustuslik return.
• Kohandatud makrode kasutamine koodis on võimalik.
• Resursse saab piirata mitte ainult operatsioonisüsteemi tasemel, vaid ka programmiliselt. Eeltöötlusetapil on maksimaalselt 10 megabaiti RAM-i ja 10-sekundiline täitmise piir.

MÄRKUS. 10-sekundilised ajaülemuse väärtused on üsna suured, kuna tingimuslike tuhandete andmeelementide kogumine 1 sekundi jooksul piisavalt "raske" eeltöötlusstsenaariumi järgi võib Zabbixi töötamise aeglustada. Seetõttu ei soovitata kasutada eeltöötlust täielike JavaScripti skriptide täitmiseks nii-öelda nimetu andmeelemendiga (dummy items), mis käivitatakse ainult eeltöötluse tegemiseks..

Kontrollige oma koodi eeltöötluse testi või utiliidi abil. 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

Asendada arvutatud andmeelement eelprotsessimisega.

Eeldus: saame andurist temperatuuri Fahrenheitis, et salvestada see Celsiusesse.

Varem oleksime loonud andmeelementi, mis kogub temperatuuri Fahrenheitis. Pärast seda veel ühe andmeelementi (arvutatud), mis ümber arvutab Fahrenheitid Celsiuseks vastava valemi abil.

Probleemid:

• On vajalik duplikeerida andmeelemente ja salvestada kõik väärtused andmebaasis.
• On oluline kooskõlastada ajavahemikud "vanema" andmeelemendi jaoks, mis arvutatakse ja mida kasutatakse valemis, ning arvutatud andmeelemendi jaoks. Vastasel juhul võib arvutatud andmeelement sattuda toetamatusse olukorda või lugeda eelmist väärtust, mis mõjutab jälgimise tulemuste usaldusväärsust.

Ühe lahendusena loobuti paindlike kontrollintervallide kasutamisest fikseeritud intervallide kasuks, et garanteerida arvutatud andmeelementide arvutamine andmeelementide pärast, mis andmeid koguvad (meie puhul - temperatuur Fahrenheitis).

Kuid kui näiteks mall, mida me kasutame paljude seadmete kontrollimiseks, ning kontroll toimub iga 30 sekundi järel, siis 29 sekundit Zabbix "unustab" ning viimase sekundi jooksul algab kontrollide ja arvutamise tegemine. See viib järjekorra tekkimiseni ja mõjutab jõudlust. Seetõttu on soovitatav kasutada fikseeritud intervalle ainult siis, kui see on tõeliselt vajalik.

Käesolevas ülesandes on optimaalne lahendus ühe rea eelprotsessimine JavaScriptis, mis konverteerib Fahrenheitid Celsiuseks:

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

See on kiire ja lihtne, ei ole vaja luua liigseid andmeelemente ja salvestada nende ajalugu, samuti saab kasutada paindlikke intervalle kontrollideks.

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

Kuid kui hüpoteetilises olukorras on vajalik saadud andmeelement liita näiteks mõne makros määraatud konstanti, tuleb arvesse võtta, et parameeter value avatakse stringina. Stringide liitmise operatsiooni ajal lihtsalt ühendatakse kaks stringi üheks.

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

Matemaatilise toimingu tulemuse saamiseks tuleb saavutada, et saadud väärtuste tüübid oleksid numbrilises formaadis. Selleks saab kasutada funktsiooni parseInt(), mis tagastab täisarvu, funktsiooni parseFloat(), mis tagastab kümnendmurru, või funktsiooni number, mis tagastab kas täisarvu või kümnendmurru.

Ülesanne 2

Saada teada aeg sekundites seni, kuni sertifikaat kehtib.

Eeldus: mõni teenus annab sertifikaadi lõppkuupäeva formaadis "Feb 12 12:33:56 2022 GMT".

ECMAScript 5 Date.parse() võtab vastu kuupäeva ISO 8601 formaadis (AAAA-KK-PÄEVTHH:mm:ss.sssZ). On vajalik viia see sobivaks stringiks, mis on formaadis MMM DD AAAA HH:mm:ss ZZ

Probleem: kuu väärtus on esitatud tekstina, mitte numbrina. Selliseid andmeid ei aktsepteeri Duktape.

Näide lahendusest:

• Esiteks kuulutatakse välja muutuja, mis saab väärtuse (kogu skript koosneb muutuja deklareerimisest, mis on loetletud koma abil).

• Esimeses reas saame kuupäeva parameetrist value ja jagame selle tühikutega meetodi split. Nii saame massiivi, kus iga massiivi elemendile, alates indeksist 0, vastab üks kuupäeva element enne ja pärast tühikut. split(0) — kuu, split(1) — päev, split(2) — aeg ja nii edasi. Pärast seda saab iga kuupäeva elementi massiivis indeksiga juurde pääseda.

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

• Iga kuule (kronoloogilises järjekorras) vastab selle asukoha indeks massiivis (0-st 11-ni). Tekstiväärtuse konverteerimiseks numbriliseks liidetakse kuu indeksile üks (sest kuude nummerdamine algab 1-st). Sel juhul tuleb väljend, kus liidetakse üks, panna sulgudesse, sest vastasel juhul saadakse string, mitte number. Lõpus esitame slice() — massiivi lõike lõpust, et jätta ainult kaks sümbolit (mis on oluline kahe numbri kuude jaoks).

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

• Koostame saadud väärtustest stringi ISO formaadis, liites stringe õigesse järjekorda.

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

Saadud formaadis andmed representavad sekundite arvu 1970. aastast kuni mõne tulevikus oleva hetkeni. Saadud formaadis andmete kasutamine käivitajates on praktiliselt võimatu, sest Zabbix lubab opereerida ainult makrodega {Date} ja {Time}, mis tagastavad kuupäeva ja kellaaja arusaadavas kasutaja formaadis.

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

`now = Date.now();`

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

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

Triggeris saab määrata väljendi ‘last<‘ ja numbrite kogumi, mis vastab sekundite arvule perioodis, millele tuleb reageerida, näiteks nädalates. Nii saad trigger teavitada, et sertifikaadi kehtivusaeg lõpeb nädala jooksul.

MÄRKUS. Pöörake tähelepanu kasutamisele parseInt() funktsioonis return, et konverteerida jagamise tulemusena saadud murdarv täisarvuks. Saate kasutada ka parseFloat() ja salvestada murdarve.

Vaata ettekannet

Allikas: habr.com