Kuidas Zabbix'i seadistada Asterisk'iga "kastist välja"

Eelmisel artiklil «Zabbix — laiendame makro piire» Ma rääkisin, kuidas saada autoriseerimise sessiooni ja sisestada see kohalikku hosti makrosse. Selles artiklis jagan, kuidas Zabbixit Asteriskiga sõbrustada ilma väliste skriptide ja tarkvarata.

Idee need kaks süsteemi „sõbrustada“ tekkis ammu, ilma et oleks vaja paigaldada lisatarkvara ja skripte. Kiire Google'iga otsimine andis hulgaliselt lahendusi, kuid kõik viitas sellele, et laadige serverisse skriptid (PHP, bash, Python jms) ja ongi õnn käes. Mina tahtsin aga teostada jälgimist „välja pakitud” — ilma väliste skriptide ja lisatarkvara paigaldamiseta jälgimis- ja PBX-serverisse.

Töötasin selle kallal kokku 4 tööpäeva, kuid tulemus oli seda väärt. Töö AMI liidese kaudu, madala taseme tuvastamine, triggereid ja mis peamine, PBX-i ühendamiseks ja kõikide muude seadistuste jaoks kulub nüüd vaid 15 minutit.

Käes on Zabbix 4.4 ja umbes 100 Asterisk 13 versiooni. Mõned PBX-id tulevad koos FreePBX veebiliidesega, teised palja konsooli, hulga nipide ja dial-plaani kaudu integreerimisega.

Saame andmeid PBX-ist

Esimene ja peamine asi, mida peab lahendama — saada andmeid peeride ja SIP registreerimiste kohta. Selleks on PBX-is olemas AGI, AMI, ARI ja SSH konsooli liidesed. Täiendavaid module ei kaalunud selge põhjuse tõttu.

Esiteks, tuleb aru saada, mis need AGI, AMI, ARI… on.

• AGI — skriptide kasutamine dial-plaanis. Peamiselt kasutatakse kõnede juhtimiseks.
• AMI — suudab anda kogu vajaliku teabe, töötab pordi 5038 kaudu nagu Telnet. See sobib meile!
• ARI — moodsalt, stiilselt, JSON-vormingus. Palju võimalusi, andmevorming arusaadaval kujul Zabbixile, kuid minu jaoks on puudu peamine: SIP registreerimist ei saa kontrollida. Veel üks miinus — peeride kohta on ainult kaks olekut: online/offline, kuigi olekuid on rohkem ja neid on kasulik diagnostika jaoks arvesse võtta.
• SSH — suudab kõike, kuid mõnikord ei anta seda „turvakaalutlustel“. Tõenäoliselt on kaalutlusi erinevaid, ei hakka neid arutama.

Siiski, vaatamata oma puudustele katab ARI 90% kõikidest jälgimise vajadustest.

Zabbix ja Telnet — minu pettumus

Ma tean AMI-d hästi, omal ajal rakendasin kõnede kaotuste jälgimist kaugkontorite jagunemisega, kõnede haldamist jne. Telneti puhul on kõik samuti selge: avad ühenduse, saadad käsud ja loed vastuse. Nii ma teginkin, kuid tulemus pettis mind.

Zabbixis on Telnet pisut erinev kui Linuxi konsoolis; see on veidi lihtsam ja kohandatud standardse autentimise jaoks, nagu kasutajanimi/parool. Kui autentimise loogika on teine ja kasutajanimi/parooli paari küsitakse, tekib viga. Pärast mitmeid ebaõnnestunud katseid autentimisnõude ümber minna, hakkasin uurima Telneti mooduli lähtekoodi.

Mõistsin, et seni kuni traditsioonilist kasutajanime ja parooli päringut ei toimu, ei edene edasi. Huvi pärast eemaldasitin koodist kõik, mis puudutas autentimist, ja kompileerisin kõik uuesti. See töötab! Kuid nõuetele see ei vasta. Jätkame...

Naaseme otsingu juurde

Lugesin uuesti ARI dokumentatsiooni, viisime läbi täiendavad katsetused - siin ei ole SIP registreerimisi. Peerid on olemas, kõned on olemas, sillad on olemas, registreerimisi pole. Mingil hetkel mõtlesin isegi, kas me vajame üldse SIP registreerimisi?

Tohutul kombel saabub sel hetkel jälle kasutajalt päring, millel on probleem väljakutsutud kõnedega. Probleem oli SIP registreerimise hangumisega ja lahendati tavapärase mooduli taaskäivitamisega.

asterisk -rx "sip reload"

Oleks tore, kui saaksin AMI-d veebist kasutada: see lahendaks kõik probleemid, mõtlesin ma. Hakkan uurima seda suunda ja järjekordne otsing viib mind Asterisk ametlikule dokumentatsioonile, kus öeldakse, et minu vajaduste jaoks on olemas valik webenabled failis /etc/asterisk/manager.conf, mille peab seadistama väärtusele YES, jaotises [general]

Pärast seda saadame tavalise veebipäringu kujul http://ats:8089/mxml?action=SIPshowregistry saame kogu vajaliku teabe.

FreePBX-liidese kasutamisel ei saa seda valikut veebist sisse lülitada; see tuleb aktiveerida konsoolist, muutes faili manager.conf. FreePBX ei kustuta seda, kui muudetakse konfiguratsiooni veebis.

Kaua töötan erinevate Asterisk integratsioonidega, pole kunagi näinud, et keegi oleks maininud seda funktsiooni. Mind üllatas, et keegi ei kirjuta sellest suhtlemismeetodist PBXiga. Isegi eriti vaatasin infot selle teema kohta: praktiliselt mitte midagi ei ole või on kasutatud täiesti teiste ülesannete tarbeks.

WEB AMI - mis asi see on?

Valiku lisamine webenabled faili manager.conf avad avatud täieliku juurdepääsu määramise ACI kaudu veebis. Kõik käsud, mis on kergesti kättesaadavad tavapärase AMI kaudu, on nüüd veebis saadaval, samuti saab kuulata ACI üritusi socket'i kaudu. Töö põhimõte ei erine konsol AMI-st.

https://ats:8089/manager — veebileht lihtsa liidese jaoks, testide ja käsitsi päringute saatmiseks. Kõik vastused vormindatakse loetavaks HTML-välja.
https://ats:8089/rawman — ainult tekstiline väljund, formaat sarnaneb konsol AMI-ga.
https://ats:8089/mxml — ainult tekstiline väljund, XML-formaadis. See sobib meile!

Siin mõtlesin: "Noh, see on lahendus! Nüüd on kõik valmis! Lihtne nagu pirn," aga rõõmustamiseks oli veel vara. Vajaliku info saamiseks piisab GET-päringu kasutamisest koos vajaliku tegevusega. tegevus, mis tagastab vastuseks xml, kus on kõikide registreeringute loetelu ja nende olek. See kõik on suurepärane, kuid vajame autoriseerimist koos seansi salvestamisega cookie's. Kui testid brauseris, ei mõtle sa sellele protsessile.

Autoriseerimisprotsess

Alguses pöördume aadressile http://ats:8089/mxml?action=login&username=zabbix&secret=zabbix, millele server saadab meile autoriseerimise seansi cookie. Nii näeb välja HTTP-päring:

https://ats:8089/mxml?action=login&username=zabbix&secret=zabbix

Host: ats:8089
User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:77.0) Gecko/20100101 Firefox/77.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,*/*;q=0.8
Accept-Language: et-EE,et;q=0.8,en-US;q=0.5,en;q=0.3
Accept-Encoding: gzip, deflate, br
DNT: 1
Connection: keep-alive
Upgrade-Insecure-Requests: 1

Vastus:

GET: HTTP/1.1 200 OK
Server: Asterisk/13.29.2
Date: Thu, 18 Jun 2020 17:41:19 GMT
Cache-Control: no-cache, no-store
Content-type: text/xml
Set-Cookie: mansession_id="6f5de42c"; Version=1; Max-Age=600
Pragma: SuppressEvents
Content-Length: 146

Selle töötamiseks on vajalik mansession_id="6f5de42c", st autoriseerimise cookie ise.
Sisu tuleb vaid kontrollida, kas vastus "Authentication accepted" on olemas. Edasi, kõikide ACI-serverile tehtud päringute puhul peame lisama päringusse autoriseerimise cookie.

https://ats:8089/mxml?action=SIPpeers

Host: ats:8089
Connection: close
Cookie: mansession_id="6f5de42c"

Kuidas saada autoriseerimise cookie ja kasutada seda muudes päringutes, loe siit: "Zabbix - ulatub makro piire üle»

Zabbixis jälgimiselementide loomise jaoks kasutan automaatset avastamist.

Automaatne avastamine

Kui soovid registreeringute automaatset avastamist ja peer'ide olekute jälgimist, pöördu aadressile: https://ats:8089/mxml?action=SIPshowregistry või https://ats:8089/mxml?action=SIPpeers

Vastus, mille ACI meile saadab, on XML:

...









...

Vastuses on palju prügi, seetõttu filtreerime me eelprotsessimisel seda mustri järgi. XPath: //response/generic[@host]
Edasi algab kõige huvitavam. Et töötada avastamise ja dünaamiliste elementide loomisega, peab vastus olema JSON formaadis. XML ei toeta automaatset avastamist.

XML-i JSON-iks muutmiseks pidin veidi mängima automaatvahetusega, mille jaoks tegin JS-i skripti.

Huvitav punkt, et vastuses on kõik parameetrid ühekordsete jutumärkidega, ja pärast mustri rakendamist. //response/generic[@host] need muudetakse kahekordseteks.

Elementide loomiseks kasutame XML vastusest (nüüd JSON) muutujaid.

SIP Registry

SIP registreerimise jaoks kasutame kolme muutujaid: username, host, port. Mulle sobis elemendi nimi 111111@login.mtt.ru:5060, olukordi, kus tuli kasutada kõiki viit muutujat, ei leidnud.

Peamine element, mis saab teavet kõigi registreerimiste kohta, Asterisk — AMI SIPshowregistry. Kord minutis teeb ta GET päringu aadressile https://ats:8089/mxml?action=SIPshowregistry, seejärel edastatakse XML vastuse andmed kõikidele sõltuvatele elementidele analüüsimiseks. Iga registreerimise element loodi sellele sõltuvaks. See on mugav, kuna saame ajakohast teavet ühe päringuga, mitte igaühe jaoks eraldi. Selle rakenduse puhul on üks oluline puudus — koormus protsessorile.

Testimisel kuni 100 sõltuva elemendi puhul ei täheldanud ma koormust, kuid 1700 elemendi korral andis see märgatava 15-sekundilise koormuse protsessorile. Pidage seda meeles, kui teil on palju sõltuvaid elemente.

Alternatiiv koormuse "jaotamiseks" või elementide küsitluse erineva sageduse seadmiseks võiks olla töötlemise loogika viimine igasse elementi eraldi.

Saadud teavet ma peamises elemendis ei hoia. Esiteks, ei näe selles vajadust, ja teiseks, kui vastus ületab 64K, lõikab Zabbix selle ära.

Kuna sõltuva elemendi jaoks kasutame täielikku XML vastust, peame eeltöötluses saama selle elemendi väärtuse. Selle kaudu XPath see tehakse nii:
string(//response/generic[@event="RegistryEntry"][@username="{#SIP_REGISTRY_USERNAME}"][@host="{#SIP_REGISTRY_HOST}"][@port="{#SIP_REGISTRY_PORT}"]/@state)
Registreerimise staatuste jaoks ei kasutanud tekstilisi staatusi, vaid muutsin need numbriliseks kujuks JavaScripti abil:

switch(value) {
  case 'Registered':
    return 1;
  case 'Unregistered':
    return 0;
  default:
    return -1;
}

SIP Peers

Sarnaselt SIP-registratsioonidega on peamine element Asterisk — AMI SIPshowregistry, millele lisatakse sõltuvad elemendid.

Siin luuakse kaks sõltuvat elementi:

• Pira staatus tekstivormingus
• Seadmest saadud vastuse aeg — kui staatus on OK, siis kirjutatakse seadme vastuse aeg, muidu „-1“

Elementi tee on juba veidi lihtsam XPath:

string(//response/generic[@objectname="{#SIP_PEER_OBEJECTNAME}"]/@status)

Teise elemendi puhul kasutasin JavaScripti, et eraldada vastuse aeg pira staatusest, kuna need talletatakse koos:

if(value.substring(0,2) == 'OK'){
	return value.match(/(d+)/gm);
}
else {
	return -1;
}

Kokkuvõte

Lahendus „kastist välja“ võib olla keeruline ja mitte kohe arusaadav. Kasvab paindlikkus ja üleviimise lihtsus erinevate süsteemide vahel.

Kena ja sujuvat integreerimist kõigile! Mall ja seadistamise juhend on GitHub.

Allikas: habr.com