Conas Zabbix a nascadh le Réiltín as an mbosca

In alt roimhe seo "Zabbix - ag leathnú teorainneacha macra" Dúirt mé leat conas seisiún údaraithe a fháil agus é a chur in ionad macra óstach áitiúil. San Airteagal seo inseoidh mé duit conas Zabbix a nascadh le Asterisk gan scripteanna agus bogearraí seachtracha.

Rugadh an smaoineamh “cairde a dhéanamh” den dá chóras seo i bhfad ó shin, gan bogearraí nó scripteanna breise a shuiteáil. Fuarthas go leor réitigh fhéideartha le googling tapa, tháinig sé ar fad síos ar an bhfíric gur uaslódáil na scripteanna (i Pyha, Bash, Python, etc.) chuig an bhfreastalaí, agus beidh tú sásta. Bhí mé ag iarraidh monatóireacht a dhéanamh “as an mbosca” a chur i bhfeidhm - gan scripteanna seachtracha agus bogearraí breise a shuiteáil ar an bhfreastalaí le monatóireacht agus PBX.

Chaith mé 4 lá oibre san iomlán leis seo, ach b'fhiú an toradh é. Ag obair tríd an gcomhéadan AMI, braite leibhéal íseal, truicear, agus níos tábhachtaí fós, tógann sé thart ar 15 nóiméad chun an PBX agus gach socrú eile a nascadh.

Tá Zabbix 4.4 ar fáil, thart ar 100 píosa de leagan Réiltín 13. Tagann roinnt PBXanna leis an gcomhéadan gréasáin FreePBX, cuid acu le consól lom, a lán cleasanna agus comhtháthú trí phlean diail.

Ag fáil sonraí ón PBX

Is é an chéad phointe agus an príomhphointe nach mór a réiteach ná sonraí a fháil faoi chlárúcháin piaraí agus SIP. Chun na críche sin, tá comhéadain AGI, AMI, ARI agus SSH ag an PBX. Ar chúiseanna soiléire, níor bhreithnigh mé modúil bhreise.

Ar dtús caithfimid a dhéanamh amach cad iad na agi, ami, ari seo...

• AGI - ag baint úsáide as scripteanna sa dialplan. Úsáidtear go príomha le haghaidh bainistíochta glaonna.
• AMI - is féidir leis an fhaisnéis go léir is gá a sholáthar, oibríonn sé trí phort 5038, cosúil le Telnet. Oireann dúinn!
• ARI - nua-aimseartha, faiseanta, JSON. Tá go leor féidearthachtaí ann, tá an fhormáid sonraí intuigthe do Zabbix, ach domsa níl aon rud is mó: ní féidir leat an clárú sip a rialú. Míbhuntáiste eile is ea nach bhfuil ach dhá stát ar líne/as líne do chomhghleacaithe, cé go bhfuil níos mó stát ann agus tá sé úsáideach iad a chur san áireamh agus diagnóis á dhéanamh.
• Is féidir le SSH gach rud a dhéanamh, ach uaireanta ní cheadaítear é mar gheall ar “chúiseanna slándála”. D’fhéadfadh go mbeadh cúinsí difriúla, ní rachaidh mé isteach iontu.

Mar sin féin, lena heasnaimh ar fad, clúdaíonn ARI 90% de na riachtanais mhonatóireachta go léir.

Zabbix agus Telnet - mo díomá

Tá a fhios agam go maith ar AMI; Le Telnet, tá gach rud an-soiléir freisin: oscail an nasc, seol na horduithe agus léigh an freagra. Sin a rinne mé, ach chuir an toradh díomá orm.

Ní hionann Telnet Zabbix agus Telnet an chonsóil. LinuxTá sé beagán níos simplí agus deartha le haghaidh fíordheimhniú caighdeánach logála isteach/pasfhocal. Má tá an loighic fíordheimhnithe difriúil agus mura n-iarrtar péire logála isteach/pasfhocal, tarlaíonn earráid. Tar éis dom iarracht a dhéanamh an riachtanas fíordheimhnithe a sheachaint gan rath, thosaigh mé ag féachaint ar chód foinse an mhodúil Telnet.

Thuig mé go dtí go mbeidh iarratas traidisiúnta logáil isteach agus pasfhocal, ní bheidh mé ag dul ar aghaidh. Díreach le haghaidh spraoi, bhain mé gach rud a bhaineann le húdarú as an gcód agus atógadh gach rud. Oibríonn! Ach ní chomhlíonann sé na ceanglais. Lean ar aghaidh…

Fillfimid ar an gcuardach

Léigh mé na doiciméid ARI arís, rinne mé tástálacha breise - níl aon chlárúcháin sip anseo. Tá féastaí ann, tá comhráite ann, tá brístí ann, ach níl aon chlárúcháin ann. Ag pointe éigin shíl mé fiú, an bhfuil gá againn i ndáiríre clárú vulture?

Trí chomhtharlú greannmhar, ag an nóiméad seo a thagann iarratas eile ón úsáideoir, le fadhb le glaonna amach. Ba í an fhadhb ná go raibh an clárú sip reo agus gur réitíodh é ach an modúl a atosú.

asterisk -rx "sip reload"

Bheadh ​​sé iontach rochtain a fháil ar AMI ar an ngréasán: réiteodh sé sin na fadhbanna go léir, shíl mé. Tosaíonn mé ag tochailt sa treo seo, agus go litriúil mar thoradh ar an gcéad líne cuardaigh go dtí an doiciméadú oifigiúil Réiltín, a deir go bhfuil rogha ann do mo thascanna gréasánaithe i gcomhad /etc/asterisk/manager.conf, a chaithfear a shocrú go TÁ, sa roinn [ginearálta]

Tar éis seo, trí iarratas gréasáin rialta ar an bhfoirm http://ats:8089/mxml?action=SIPshowregistry faighimid an t-eolas riachtanach ar fad.

Agus an comhéadan FreePBX á úsáid agat, ní féidir leat an rogha seo a chumasú tríd an ngréasán; ní mór duit é a chumasú tríd an gconsól trí athruithe a dhéanamh ar an gcomhad manager.conf. Ní scriosann FreePBX é nuair a dhéantar athruithe cumraíochta tríd an ngréasán.

D'oibrigh mé le cineálacha éagsúla comhtháthú réiltín le fada an lá, ach ní fhaca mé an ghné seo luaite in áit ar bith. Bhí ionadh orm nach ndéanann aon duine cur síos ar an modh seo chun idirghníomhú leis an PBX. Bhí sé úsáideach fiú faisnéis a lorg ar an ábhar seo: níl rud ar bith beagnach nó baineadh úsáid as le haghaidh tascanna go hiomlán difriúil.

WEB AMI - cén cineál beithíoch?

Rogha a chur leis gréasánaithe a chomhdú bainisteoir.conf rochtain iomlán a sholáthar ar bhainistíocht ATS tríd an ngréasán. Tá gach ordú atá ar fáil trí AMI rialta ar an ngréasán anois, is féidir leat éisteacht le himeachtaí ón PBX trí soicéad. Níl prionsabal na hoibríochta difriúil ó thaobh an chonsóil AMI. Tar éis duit an rogha seo a ghníomhachtú, is féidir leat teagmháil a dhéanamh leis an PBX ag na seoltaí seo a leanas:

https://ats:8089/manager — leathanach gréasáin le comhéadan simplí chun iarratais a thástáil agus a sheoladh de láimh. Déantar gach freagra a fhormáidiú i HTML inléite. Níl sé an-oiriúnach le haghaidh monatóireachta.
https://ats:8089/rawman — aschur téacs amháin, formáid cosúil le consól AMI
https://ats:8089/mxml - aschur téacs amháin, i bhformáid XML. Oireann dúinn!

Ansin shíl mé: “Seo an réiteach! Anois beidh gach rud réidh! Fáscadh líomóide éasca-peezy,” ach bhí sé ró-luath chun lúcháir a dhéanamh. Chun an fhaisnéis a theastaíonn uainn a fháil, is leor iarratas GET a úsáid leis an ngníomh is gá gníomh, a thugann xml ar ais mar fhreagra le liosta de na clárúcháin go léir agus a stádas. Tá sé seo go hiontach ar fad, ach teastaíonn údarú uait chun an seisiún ón bhfianán a mheabhrú. Nuair a dhéanann tú tástáil sa bhrabhsálaí, ní smaoiníonn tú ar an bpróiseas seo.

Próiseas údaraithe

Ar dtús tugaimid aghaidh ar an seoladh http://ats:8089/mxml?action=login&username=zabbix&secret=zabbix, mar fhreagra, seolann an freastalaí fianán chugainn leis an seisiún údaraithe. Seo an chuma atá ar iarratas HTTP:

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: ru-RU,ru;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

Freagra:

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

<ajax-response>
<response type="object" id="unknown">
<generic response="Success" message="Authentication accepted"/>
</response>
</ajax-response>

Chun oibriú ann is gá duit mansession_id="6f5de42c", i.e. an fianán údaraithe féin.
Ábhar nach gá duit ach a sheiceáil le haghaidh an fhreagra"Glacadh le fíordheimhniú" Ansin, le haghaidh gach glao chuig an bhfreastalaí PBX, beidh orainn fianán údaraithe a chur leis an iarratas.

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

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

Léigh conas fianán údaraithe a fháil agus é a úsáid in iarratais eile anseo: “Zabbix - teorainneacha macra a leathnú»

Chun eilimintí rianaithe a chruthú in Zabbix úsáidfidh mé braite uathoibríoch.

Brath uathoibríoch

Chun clárúcháin a bhrath go huathoibríoch agus stáit piaraí a rianú, ní mór duit dul i dteagmháil leis an seoladh seo a leanas: https://ats:8089/mxml?action=SIPshowregistry nó https://ats:8089/mxml?action=SIPpeers

Mar fhreagra, seolann an PBX freagra XML chugainn:

<ajax-response>
<response type="object" id="unknown">
<generic response="Success" eventlist="start" message="Registrations will follow"/>
</response>
...
<response type="object" id="unknown">
<generic event="RegistryEntry" host="login.mtt.ru" port="5060" username="111111" domain="login.mtt.ru" domainport="5060" refresh="105" state="Registered" registrationtime="1592502142"/>
</response>
<response type="object" id="unknown">
<generic event="RegistryEntry" host="voip.uiscom.ru" port="5060" username="222222" domain="voip.uiscom.ru" domainport="5060" refresh="105" state="Registered" registrationtime="1592502142"/>
</response>
<response type="object" id="unknown">
<generic event="RegistryEntry" host="voip.uiscom.ru" port="5060" username="333333" domain="voip.uiscom.ru" domainport="5060" refresh="105" state="Registered" registrationtime="1592502142"/>
</response>
...
</ajax-response>

Tá go leor truflais sa fhreagra, mar sin le linn réamhphróiseála déanaimid é a scagadh trí theimpléad XPath: //response/generic[@host]
Ansin tosaíonn an spraoi. Chun oibriú le heilimintí a bhrath agus a chruthú go dinimiciúil, ní mór don fhreagra a bheith i bhformáid JSON. Ní thacaítear le XML le haghaidh braite uathoibríoch.

Chun XML a thiontú go JSON, bhí orm beagán a imirt le hathsholáthar uathoibríoch, agus rinne mé script dó i JS

Pointe suimiúil: sa fhreagra ATS, tá na paraiméadair go léir timpeallaithe ag comharthaí athfhriotail aonair, agus tar éis an teimpléad a chur i bhfeidhm //response/generic[@host] cuirtear cinn dhúbailte in ionad iad.

Chun eilimintí a chruthú, úsáidimid athróga ón bhfreagra XML (JSON anois).

Clárlann SIP

Le haghaidh clárúcháin sip úsáidimid trí athróg: ainm úsáideora, óstach, calafort. Bhí mé sásta le hainm an eilimint 111111@login.mtt.ru:5060, Níor aimsigh mé aon chás inar gá duit na cúig athróg go léir a úsáid.

Is í an phríomhghné a fhaigheann faisnéis faoi gach clárú,. Réiltín - AMI SIPshowregistry. Uair sa nóiméad déanann sé iarratas GET chuig https://ats:8089/mxml?action=SIPshowregistry, ina dhiaidh sin seoltar na sonraí freagartha XML chuig na heilimintí cleithiúnacha go léir le haghaidh parsála. Cruthaím eilimint do gach clárú atá ag brath air. Tá sé seo áisiúil mar go bhfaighimid faisnéis cothrom le dáta in aon iarratas amháin, agus ní le haghaidh gach iarratais ar leithligh. Tá míbhuntáiste suntasach ag an gcur chun feidhme seo - an t-ualach ar an bpróiseálaí.

Nuair a thástáil suas le 100 eilimint cleithiúnach, níor thug mé an t-ualach faoi deara, ach le 1700 eilimint, thug sé seo ualach suntasach 15 soicind ar an bpróiseálaí. Coinnigh seo i gcuimhne má tá líon mór eilimintí cleithiúnacha agat.

Mar rogha chun an t-ualach a “leathadh amach” nó minicíochtaí vótaíochta éagsúla a shocrú le haghaidh eilimint, is féidir leat an loighic próiseála a aistriú chuig gach eilimint ar leithligh.

Ní stórálaim an fhaisnéis a fuarthas sa phríomhghné. Ar an gcéad dul síos, ní fheicim go bhfuil gá leis seo, agus sa dara háit, má tá an freagra níos mó ná 64K, gearrann Zabbix as é.

Ós rud é go n-úsáidimid freagra XML iomlán don eilimint spleách, ní mór dúinn luach na heiliminte seo a fháil i réamhphróiseáil. Tríd XPath déantar é mar seo:
string(//response/generic[@event="RegistryEntry"][@username="{#SIP_REGISTRY_USERNAME}"][@host="{#SIP_REGISTRY_HOST}"][@port="{#SIP_REGISTRY_PORT}"]/@ luaigh)
Maidir le stádais chlárúcháin, níor úsáid mé stádais téacs, ach d'iompaigh mé go foirm uimhriúil iad ag baint úsáide as JavaScript:

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

Comhghleacaithe SIP

De réir analaí le clárúcháin SIP, tá príomhghné de Chlárlann Asterisk - AMI SIPshow, a gcuirtear cinn spleácha léi.

Cruthaíonn sé seo dhá eilimint spleácha:

• Stádas piaraí i bhfoirm téacs
• Am freagartha gléis - má tá an stádas ceart go leor, scríobhtar am freagartha an ghléis, nó mura bhfuil “-1”

Tá an cosán go dtí an eilimint féin beagán níos simplí XPath:

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

Don dara eilimint d'úsáid mé JavaScript chun scaradh am freagartha ón stádas piaraí, ós rud é go stóráiltear iad le chéile:

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

Conclúid

Is féidir le réiteach lasmuigh den bhosca a bheith casta agus ní soiléir láithreach. Méadaítear solúbthacht agus iniomparthacht idir córais éagsúla

Comhtháthú sona agus éasca gach duine! Teimpléad agus treoracha le haghaidh socrú GitHub.

Foinse: will.com