Zabbix - ulatub makro piire üle

Kliendi lahenduse koostamisel tekkis kaks ülesannet, millele sooviti leida ilus ja töötav lahendus Zabbixi standardfunktsionaalsuse raames.

Ülesanne 1. Mikrotik ruuterite tarkvara versiooni jälgimine.

Ülesanne lahendatakse lihtsalt, lisades HTTP agendi šablooni. Agent saavad versiooni info Mikrotiku veebilehelt ja käivitab tingimuse, mis võrdleb saadud versiooni praegusega; versioonide erinevuse korral väljastatakse häire.

Kui teil on 10 ruuterit, pole selline algoritm kriitiline, aga mis siis, kui on 3000 ruuteri? Saata 3000 päringut serverisse? Tõesti, see skeem toimib, kuid juba idee saata 3000 päringut mulle ei sobinud; soovisin leida teisi lahendusi. Samuti oli sellise algoritmi puhul puudus: teine pool võib pidada nii suurt päringute arvu ühelt IP-aadressilt DoS rünnakuks ja nad võivad lihtsalt blokeerida.

Ülesanne 2. Autoriseerimise sessiooni kasutamine erinevates HTTP agentides.

Kui HTTP agendi kaudu on vaja saada teavet „suletud” lehtedelt, on vajalik autoriseerimise küpsis. Selleks eksisteerib tavaliselt standardne autoriseerimisvorm, kus kasutatakse „kasutajanime/parooli” kombinatsiooni ning seansi ID salvestatakse küpsisesse.

Aga on probleem, ei saa ühe HTTP agendi elemendi kaudu pöörduda teise elemendi andmete poole, et asendada need väli päises.

On olemas ka „Veebi stsenaarium”, millel on teine piirang – see ei võimalda saada sisu analüüsimiseks ja hilisemaks salvestamiseks. Saab ainult kontrollida lehtede vajalikku muutujate olemasolu või edastada eelnevalt saadud muutujaid veebistseeni samme vahetades.

Natuke nendele ülesannetele mõeldes otsustasin kasutada makrosid, mis on hästi nähtavad igas monitooringusüsteemi osas: šabloonides, hostides, häiretes või elementides. Ja makrode värskendamine on võimalik läbi API veebiliidese.

Zabbixil on olemas hea ja põhjalik dokumentatsioon API kohta. API kaudu andmete vahetamiseks kasutatav andmevorming on JSON. Üksikasjalikumalt saab lugeda ametlikust dokumentatsioonist.

Vajalikud andmed hankimise ja nende makrosse salvestamise tegevuste järjestus on esitatud allolevas skeemis.

Samm 1

Esimene samm võib koosneda ühest või mitmest tegevusest. Esimesed sammud asetavad kogu põhiloogika paika ning kõige olulisemad on viimane kolm sammu.

Minu näites tehti esimeses sammus autoriseerimise küpsise saamine PBKeskselt esimese ülesande lahendamiseks. Teise ülesande puhul sain Mikrotiku praeguse tarkvara versiooni numbri.

Mikrotik'i uusimate tarkvaraversioonide URL

• upgrade.mikrotik.com/routeros/LATEST.6 — Stabiilse versiooni aktuaalne URL
• upgrade.mikrotik.com/routeros/LATEST.6fix — LTS versiooni aktuaalne URL

Need aadressid on Mikrotik'i seadmete poolt kasutatavad, et saada uusim saadaval olev tarkvaraversioon.

Esimene samm on igaühe jaoks ainulaadne ning selle töötlusloogika võib olla erinev. Kõik sõltub teie ülesandest.

Veebiskeenuste kasutamisel jälgige, milline meetod vastuse saamiseks on vajalik. Pealkirjad HTTP vastuse või sisu vastuse pealkirjadeta?
Kui vajate autentimisküpsiseid, seadke vastuse meetod Pealkirjad nagu Asterisk'i puhul.

Kui vajate andmeid, nagu Mikrotik'i serveri vastuse puhul, seadke Vastus pealkirjadeta.

Samm 2

Liigume teise sammu juurde. Autentimisseansi saamine:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc": "2.0",
    "method": "user.login",
    "params": {
        "user": "Admin",
        "password": "zabbix"
    },
    "id": 1,
    "auth": null
}

jsonrpc — kasutatav JSON-RPC protokolli versioon;
Zabbix rakendab JSON-RPC versiooni 2.0;

• meetod — kutsutav meetod;
• parameetrid — meetodi kaudu edastatavad parameetrid;
• id — päringu meelevaldne identifikaator;
• auth — kasutaja autentimise võti; kuna meil pole veel seda, seadke see nulliks.

API kasutamiseks lõin eraldi konto, mille õigused on piiratud. Esiteks, ei tohiks anda juurdepääsu kohtadele, kuhu see pole vajalik. Teiseks, enne versiooni 5.0, võis läbi makro parooli lugeda. Seega, kui kasutate Zabbixi administraatori parooli, on admini konto kergesti varastatav.

See on eriti oluline, kui kasutate API-d kolmandate osapoolte skriptide kaudu ja salvestate mandaadid küljele.

Alates versioonist 5.0 on ilmunud valik peita makros salvestatud parool.

Kui loote eraldi konto andmete uuendamiseks API kaudu, kontrollige kindlasti, kas soovitud andmed on veebiliidese kaudu kergesti ligipääsetavad ja kas neid saab uuendada. Ma ei kontrollinud ja hiljem ei suutnud kaua aru saada, miks API kaudu soovitud makro ei paistnud.

Pärast API-s autoriseerimist liikume makrode loendi saamise juurde.

Samm 3

API liides ei võimalda hosti makro nimel uuendada, selleks tuleb esmalt saada makro ID. Veelgi enam, et saada konkreetse hosti makrode nimekiri, tuleb teada selle hosti ID-d, mis toob kaasa lisaküsimuse. Kasutage standardset makrot {HOST.ID} päringus ei tohi. Piirangut otsustasin ümber minna nii:

Loomisin kohaliku makro selle hosti ID-ga. Host ID saamine on veebiliidest kasutades väga lihtne.

Vastus kõigi antud hosti makrode nimekirjaga saab filtreerida mustri järgi:

regex:{"hostmacroid":"([0-9]+)"[A-z0-9,":]+"{$MIKROTIK_VERSION}"

Nii saame vajaliku makro ID, kus MIKROTIK_VERSION on makro nimi, mida me otsime. Minu puhul otsitakse makrot MIKROTIK_VERSION, mis on määratud hostile.

Kogu päring näeb välja järgmine:

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.get",
    "params":{
        "output":"extend",
        "hostids":"{$HOST_ID}"
    },
    "auth":"{sid}",
    "id":1
}

Muutuja {sid} saadud teisel sammul ja seda kasutatakse pidevalt, kus on vaja töötada API liidesega.

Lõplik 4. SAMM — makro uuendamine

Nüüd, kui teame makro ID-d, mida tuleb uuendada, autentimisviisi või marsruuteri versiooni, saame makrot uuendada.

POST http://company.com/zabbix/api_jsonrpc.php HTTP/1.1
Content-Type: application/json-rpc

{
    "jsonrpc":"2.0",
    "method":"usermacro.update",
    "params":{
        "hostmacroid":"{hostmacroid}",
        "value":"{mikrotik_version}"
    },
    "auth":"{sid}",
    "id":1
}

{mikrotik_version} – väärtus, mille saime esimesel sammul. Minu näites — mikrotik'i värskeima versiooni.
{hostmacroid} – väärtus, mille saime kolmandal sammul — makro ID, mida uuendame.

Järeldused

Lähenemine ülesande lahendusele standardsete funktsioonide kaudu on oluliselt keerukam ja aeganõudvam. Eriti kui tead programmeerimist ja saad kiiresti vajalikku loogikat skripti kirjutada.

Ilmselge plusspunkt selle lähenemise juures on lahenduse "ülekantavus" erinevate serverite vahel.

Isiklikult on mulle kummaline, et puudub võimalus HTTP-agentis pöörduda teiste elementide andmete poole ja sisestada need päringu või pealkirjade kehasse [ ZBXNEXT-5993].

Valmis malle saab laadida GitHubist.

Allikas: habr.com