બોક્સની બહાર Asterisk સાથે Zabbix ને કેવી રીતે કનેક્ટ કરવું

પાછલા લેખમાં "ઝેબિક્સ - મેક્રો સીમાઓ વિસ્તરી રહી છે" મેં તમને કહ્યું કે અધિકૃતતા સત્ર કેવી રીતે મેળવવું અને તેને સ્થાનિક હોસ્ટ મેક્રોમાં કેવી રીતે બદલવું. આ લેખમાં હું તમને કહીશ કે બાહ્ય સ્ક્રિપ્ટ્સ અને સૉફ્ટવેર વિના એસ્ટરિસ્ક સાથે Zabbix ને કેવી રીતે કનેક્ટ કરવું.

વધારાના સોફ્ટવેર અથવા સ્ક્રિપ્ટ્સ ઇન્સ્ટોલ કર્યા વિના, આ બે સિસ્ટમોને "મિત્રો બનાવવા" નો વિચાર લાંબા સમય પહેલા જન્મ્યો હતો. ઝડપી ગૂગલિંગથી ઘણા સંભવિત ઉકેલો મળ્યા, તે બધા એ હકીકત પર ઉકળે છે કે સર્વર પર સ્ક્રિપ્ટો (પાયહા, બાશ, પાયથોન, વગેરેમાં) અપલોડ કરો, અને તમે ખુશ થશો. હું "બૉક્સની બહાર" મોનિટરિંગને અમલમાં મૂકવા માંગતો હતો - બાહ્ય સ્ક્રિપ્ટ વિના અને મોનિટરિંગ અને પીબીએક્સ સાથે સર્વર પર વધારાના સોફ્ટવેર ઇન્સ્ટોલ કર્યા વિના.

મેં આની સાથે કુલ 4 કામકાજના દિવસો વિતાવ્યા, પરંતુ પરિણામ તે યોગ્ય હતું. AMI ઈન્ટરફેસ દ્વારા કામ કરવું, નીચા સ્તરની શોધ, ટ્રિગર્સ અને સૌથી અગત્યનું, PBX અને અન્ય તમામ સેટિંગ્સને કનેક્ટ કરવામાં હવે લગભગ 15 મિનિટ લાગે છે.

Zabbix 4.4 ઉપલબ્ધ છે, Asterisk આવૃત્તિ 100 ના લગભગ 13 ટુકડાઓ. કેટલાક PBXs FreePBX વેબ ઈન્ટરફેસ સાથે આવે છે, કેટલાક એકદમ કન્સોલ સાથે, યુક્તિઓનો સમૂહ અને ડાયલપ્લાન દ્વારા એકીકરણ સાથે આવે છે.

PBX માંથી ડેટા પ્રાપ્ત કરી રહ્યું છે

પહેલો અને મુખ્ય મુદ્દો જેને ઉકેલવાની જરૂર છે તે છે સાથીદારો અને SIP રજિસ્ટ્રેશન વિશેનો ડેટા મેળવવો. આ હેતુ માટે, PBX પાસે AGI, AMI, ARI અને SSH કન્સોલ ઇન્ટરફેસ છે. સ્પષ્ટ કારણોસર, મેં વધારાના મોડ્યુલોને ધ્યાનમાં લીધા નથી.

પહેલા આપણે એ જાણવાની જરૂર છે કે આ અગી, અમી, અરી શું છે...

• AGI - ડાયલપ્લાનમાં સ્ક્રિપ્ટનો ઉપયોગ કરીને. મુખ્યત્વે કોલ મેનેજમેન્ટ માટે વપરાય છે.
• AMI - તમામ જરૂરી માહિતી પ્રદાન કરી શકે છે, પોર્ટ 5038 દ્વારા કામ કરે છે, ટેલનેટની જેમ. અમને અનુકૂળ!
• ARI - આધુનિક, ફેશનેબલ, JSON. ત્યાં ઘણી શક્યતાઓ છે, Zabbix માટે ડેટા ફોર્મેટ સમજી શકાય તેવું છે, પરંતુ મારા માટે ત્યાં કોઈ મુખ્ય વસ્તુ નથી: તમે sip નોંધણીને નિયંત્રિત કરી શકતા નથી. અન્ય ગેરલાભ એ છે કે સાથીદારો માટે માત્ર બે જ રાજ્યો ઓનલાઈન/ઓફલાઈન છે, જો કે ત્યાં વધુ રાજ્યો છે અને નિદાન કરતી વખતે તેને ધ્યાનમાં લેવું ઉપયોગી છે.
• SSH બધું જ કરી શકે છે, પરંતુ કેટલીકવાર "સુરક્ષા કારણો" ને લીધે તેને મંજૂરી આપવામાં આવતી નથી. વિચારણાઓ અલગ હોઈ શકે છે, હું તેમાં જઈશ નહીં.

જો કે, તેની તમામ ખામીઓ સાથે, ARI તમામ મોનિટરિંગ જરૂરિયાતોના 90% આવરી લે છે.

Zabbix અને Telnet - મારી નિરાશા

હું AMIને સારી રીતે જાણું છું; એક સમયે મેં રિમોટ ઑફિસો, કૉલ મેનેજમેન્ટ વગેરે દ્વારા વિભાજન સાથેની વાતચીતમાં નુકસાનનું ટ્રેકિંગ અમલમાં મૂક્યું હતું. ટેલનેટ સાથે, બધું પણ ખૂબ જ સ્પષ્ટ છે: કનેક્શન ખોલો, આદેશો મોકલો અને પ્રતિસાદ વાંચો. મેં તે જ કર્યું, પરંતુ પરિણામએ મને નિરાશ કર્યો.

ઝબ્બિક્સમાં ટેલનેટ એ લિનક્સ કન્સોલ જેવું નથી, તે થોડું સરળ અને લોગિન/પાસવર્ડ જેવા પ્રમાણભૂત અધિકૃતતા માટે અનુરૂપ છે. જો અધિકૃતતા તર્ક અલગ હોય, અને લોગિન/પાસવર્ડ જોડી માટે કોઈ વિનંતી ન હોય, તો ભૂલ થાય છે. અધિકૃતતાની જરૂરિયાતને બાયપાસ કરવાના નિરર્થક પ્રયાસો પછી, ટેલનેટ મોડ્યુલના સ્ત્રોત કોડને જોવાનું ઉપયોગી હતું.

મને સમજાયું કે જ્યાં સુધી પરંપરાગત લોગિન અને પાસવર્ડની વિનંતી નહીં થાય ત્યાં સુધી હું આગળ વધીશ નહીં. માત્ર આનંદ માટે, મેં કોડમાંથી અધિકૃતતા સંબંધિત બધું દૂર કર્યું અને બધું ફરીથી એસેમ્બલ કર્યું. કામ કરે છે! પરંતુ તે જરૂરિયાતોને પૂર્ણ કરતું નથી. આગળ વધો…

ચાલો શોધ પર પાછા ફરીએ

મેં ફરીથી ARI દસ્તાવેજો ફરીથી વાંચ્યા, વધારાના પરીક્ષણો ચલાવ્યા - અહીં કોઈ સિપ નોંધણીઓ નથી. ત્યાં મિજબાનીઓ છે, વાતચીત છે, ત્યાં બ્રીચ છે, પરંતુ ત્યાં કોઈ નોંધણી નથી. અમુક સમયે મેં એવું પણ વિચાર્યું કે, શું આપણને ખરેખર ગીધની નોંધણીની જરૂર છે?

એક રમુજી સંયોગ દ્વારા, આ ક્ષણે વપરાશકર્તા તરફથી બીજી વિનંતી આવે છે, જેમાં આઉટગોઇંગ કોલ્સ સાથે સમસ્યા છે. સમસ્યા એ હતી કે sip રજીસ્ટ્રેશન ઠંડું હતું અને ફક્ત મોડ્યુલને રીબૂટ કરીને હલ કરવામાં આવ્યું હતું.

asterisk -rx "sip reload"

વેબ પર AMI ને એક્સેસ કરવું સરસ રહેશે: તે બધી સમસ્યાઓ હલ કરશે, મેં વિચાર્યું. હું આ દિશામાં ખોદવાનું શરૂ કરું છું, અને શાબ્દિક રીતે પ્રથમ શોધ લાઇન સત્તાવાર એસ્ટેરિસ્ક દસ્તાવેજીકરણ તરફ દોરી જાય છે, જે કહે છે કે મારા કાર્યો માટે એક વિકલ્પ છે. વેબ સક્ષમ ફાઇલમાં /etc/asterisk/manager.conf, જે વિભાગમાં, YES પર સેટ કરવાની જરૂર છે [સામાન્ય]

આ પછી, ફોર્મની નિયમિત વેબ વિનંતી દ્વારા http://ats:8089/mxml?action=SIPshowregistry અમે તમામ જરૂરી માહિતી મેળવીએ છીએ.

FreePBX ઇન્ટરફેસનો ઉપયોગ કરતી વખતે, તમે વેબ દ્વારા આ વિકલ્પને સક્ષમ કરી શકતા નથી; તમારે manager.conf ફાઇલમાં ફેરફાર કરીને કન્સોલ દ્વારા તેને સક્ષમ કરવાની જરૂર છે. જ્યારે વેબ દ્વારા રૂપરેખાંકન ફેરફારો કરવામાં આવે ત્યારે FreePBX તેને ભૂંસી નાખતું નથી.

મેં લાંબા સમયથી વિવિધ પ્રકારના એસ્ટેરિસ્ક એકીકરણ સાથે કામ કર્યું છે, પરંતુ મેં આ સુવિધાનો ઉલ્લેખ ક્યાંય જોયો નથી. મને આશ્ચર્ય થયું કે પીબીએક્સ સાથે ક્રિયાપ્રતિક્રિયા કરવાની આ પદ્ધતિનું કોઈ વર્ણન કરતું નથી. આ વિષય પરની માહિતી શોધવા માટે તે ખાસ કરીને ઉપયોગી હતું: વ્યવહારીક રીતે કંઈ નથી અથવા તેનો ઉપયોગ સંપૂર્ણપણે અલગ કાર્યો માટે થતો હતો.

વેબ AMI - કેવા પ્રકારનું જાનવર?

વિકલ્પ ઉમેરી રહ્યા છીએ વેબ સક્ષમ ફાઈલ કરવા માટે manager.conf વેબ દ્વારા ATS મેનેજમેન્ટને સંપૂર્ણ ઍક્સેસ પ્રદાન કરે છે. નિયમિત AMI દ્વારા ઉપલબ્ધ તમામ આદેશો હવે વેબ પર છે, તમે સોકેટ દ્વારા PBX માંથી ઇવેન્ટ્સ સાંભળી શકો છો. ઓપરેશનનો સિદ્ધાંત કન્સોલ AMI થી અલગ નથી. આ વિકલ્પને સક્રિય કર્યા પછી, તમે નીચેના સરનામે PBX નો સંપર્ક કરી શકો છો:

https://ats:8089/manager - પરીક્ષણ અને મેન્યુઅલી વિનંતીઓ મોકલવા માટે સરળ ઈન્ટરફેસ સાથેનું વેબ પેજ. બધા પ્રતિસાદો વાંચી શકાય તેવા HTML માં ફોર્મેટ કરેલ છે. દેખરેખ માટે ખૂબ જ યોગ્ય નથી.
https://ats:8089/rawman - માત્ર ટેક્સ્ટ આઉટપુટ, કન્સોલ AMI જેવું જ ફોર્મેટ
https://ats:8089/mxml - માત્ર ટેક્સ્ટ આઉટપુટ, XML ફોર્મેટમાં. અમને અનુકૂળ!

પછી મેં વિચાર્યું: “આ ઉકેલ છે! હવે બધું તૈયાર થઈ જશે! સરળ-પીઝી લેમન સ્ક્વિઝી," પરંતુ આનંદ કરવા માટે તે ખૂબ જ વહેલું હતું. અમને જરૂરી માહિતી મેળવવા માટે, જરૂરી કાર્યવાહી સાથે GET વિનંતીનો ઉપયોગ કરવા માટે તે પૂરતું છે ક્રિયા, જે જવાબમાં તમામ રજીસ્ટ્રેશન અને તેમની સ્થિતિની યાદી સાથે xml પરત કરે છે. આ બધું સરસ છે, પરંતુ તમારે કૂકીમાંથી સત્ર યાદ રાખવા માટે અધિકૃતતાની જરૂર છે. જ્યારે તમે બ્રાઉઝરમાં પરીક્ષણ કરો છો, ત્યારે તમે આ પ્રક્રિયા વિશે વિચારતા નથી.

અધિકૃતતા પ્રક્રિયા

પહેલા આપણે સરનામું કહીએ છીએ http://ats:8089/mxml?action=login&username=zabbix&secret=zabbix, જવાબમાં, સર્વર અમને અધિકૃતતા સત્ર સાથે કૂકી મોકલે છે. 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

જવાબ:

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>

તમારે ત્યાં કામ કરવાની જરૂર છે mansession_id="6f5de42c", એટલે કે અધિકૃતતા કૂકી પોતે.
સામગ્રી તમારે ફક્ત જવાબ માટે તપાસવાની જરૂર છે "પ્રમાણીકરણ સ્વીકાર્યું" આગળ, PBX સર્વર પરના તમામ કૉલ્સ માટે, અમને વિનંતીમાં અધિકૃતતા કૂકી ઉમેરવાની જરૂર પડશે.

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

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

અધિકૃતતા કૂકી કેવી રીતે મેળવવી અને અન્ય વિનંતીઓમાં તેનો ઉપયોગ કેવી રીતે કરવો તે અહીં વાંચો: “Zabbix - મેક્રો સીમાઓ વિસ્તરી રહી છે»

Zabbix માં ટ્રેકિંગ તત્વો બનાવવા માટે હું ઓટો ડિટેક્શનનો ઉપયોગ કરીશ.

ઓટો ડિટેક્શન

નોંધણીઓને આપમેળે શોધવા અને પીઅર સ્ટેટ્સને ટ્રૅક કરવા માટે, તમારે નીચેના સરનામાંનો સંપર્ક કરવાની જરૂર છે: https://ats:8089/mxml?action=SIPshowregistry અથવા https://ats:8089/mxml?action=SIPpeers

જવાબમાં, PBX અમને XML પ્રતિસાદ આપે છે:

<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>

પ્રતિભાવમાં ઘણો કચરો છે, તેથી પ્રીપ્રોસેસિંગમાં અમે તેને ટેમ્પલેટ દ્વારા ફિલ્ટર કરીએ છીએ એક્સપથ: //પ્રતિસાદ/સામાન્ય[@હોસ્ટ]
પછી મજા શરૂ થાય છે. શોધ સાથે કામ કરવા અને ગતિશીલ રીતે ઘટકો બનાવવા માટે, પ્રતિસાદ JSON ફોર્મેટમાં હોવો આવશ્યક છે. XML સ્વતઃ શોધ માટે સમર્થિત નથી.

XML ને JSON માં કન્વર્ટ કરવા માટે, મારે ઓટો રિપ્લેસમેન્ટ સાથે થોડું રમવું પડ્યું, જેના માટે મેં JS માં સ્ક્રિપ્ટ બનાવી

એક રસપ્રદ મુદ્દો: ATS પ્રતિસાદમાં, બધા પરિમાણો એક અવતરણથી ઘેરાયેલા છે, અને નમૂના લાગુ કર્યા પછી //પ્રતિસાદ/સામાન્ય[@હોસ્ટ] તેઓ ડબલ રાશિઓ દ્વારા બદલવામાં આવે છે.

તત્વો બનાવવા માટે, અમે XML પ્રતિસાદ (હવે JSON) માંથી ચલોનો ઉપયોગ કરીએ છીએ.

SIP રજિસ્ટ્રી

સિપ રજીસ્ટ્રેશન માટે અમે ત્રણ ચલોનો ઉપયોગ કરીએ છીએ: વપરાશકર્તા નામ, યજમાન, પોર્ટ. તત્વના નામથી હું ખુશ હતો [ઇમેઇલ સુરક્ષિત]: 5060, મને એવી કોઈ પરિસ્થિતિ મળી નથી કે જ્યાં તમારે પાંચેય ચલોનો ઉપયોગ કરવાની જરૂર હોય.

મુખ્ય તત્વ જે તમામ નોંધણીઓ વિશે માહિતી મેળવે છે, ફૂદડી - AMI SIPshowregistry. એક મિનિટમાં એકવાર તે GET વિનંતી કરે છે https://ats:8089/mxml?action=SIPshowregistry, જે પછી પ્રતિસાદ XML ડેટા પાર્સિંગ માટે તમામ આશ્રિત તત્વોને પસાર કરવામાં આવે છે. દરેક નોંધણી માટે હું તેના પર નિર્ભર એક તત્વ બનાવું છું. આ અનુકૂળ છે કારણ કે અમને એક વિનંતીમાં અપ-ટૂ-ડેટ માહિતી મળે છે, અને દરેક વિનંતી માટે અલગથી નહીં. આ અમલીકરણમાં નોંધપાત્ર ખામી છે - પ્રોસેસર પરનો ભાર.

100 આશ્રિત તત્વોનું પરીક્ષણ કરતી વખતે, મેં લોડની નોંધ લીધી ન હતી, પરંતુ 1700 તત્વો સાથે, આનાથી પ્રોસેસર પર નોંધપાત્ર 15 સેકન્ડનો ભાર મળ્યો. જો તમારી પાસે મોટી સંખ્યામાં આશ્રિત તત્વો હોય તો આને ધ્યાનમાં રાખો.

લોડને "ફેલાવો" અથવા કોઈ તત્વ માટે અલગ-અલગ પોલિંગ ફ્રીક્વન્સીઝ સેટ કરવાના વિકલ્પ તરીકે, તમે પ્રોસેસિંગ લોજિકને દરેક ઘટક પર અલગથી ખસેડી શકો છો.

હું પ્રાપ્ત માહિતીને મુખ્ય તત્વમાં સંગ્રહિત કરતો નથી. પ્રથમ, મને આની જરૂર દેખાતી નથી, અને બીજું, જો પ્રતિસાદ 64K કરતાં વધુ છે, તો ઝબ્બીક્સ તેને કાપી નાખે છે.

અમે આશ્રિત તત્વ માટે સંપૂર્ણ XML પ્રતિભાવનો ઉપયોગ કરતા હોવાથી, અમારે પ્રીપ્રોસેસિંગમાં આ તત્વની કિંમત મેળવવાની જરૂર છે. દ્વારા એક્સપથ તે આ જેમ કરવામાં આવે છે:
સ્ટ્રિંગ(//response/generic[@event="RegistryEntry"][@username="{#SIP_REGISTRY_USERNAME}"][@host="{#SIP_REGISTRY_HOST}"][@port="{#SIP_REGISTRY_PORT}"]/@ રાજ્ય)
નોંધણી સ્થિતિઓ માટે, મેં ટેક્સ્ટ સ્ટેટસનો ઉપયોગ કર્યો નથી, પરંતુ JavaScript નો ઉપયોગ કરીને તેમને સંખ્યાત્મક સ્વરૂપમાં રૂપાંતરિત કર્યા છે:

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

SIP સાથીદારો

SIP નોંધણીઓ સાથે સામ્યતા દ્વારા, Asterisk - AMI SIPshowregistry નું મુખ્ય તત્વ છે, જેમાં આશ્રિત લોકો ઉમેરવામાં આવે છે.

આ બે આશ્રિત તત્વો બનાવે છે:

• ટેક્સ્ટ ફોર્મમાં પીઅર સ્ટેટસ
• ઉપકરણ પ્રતિસાદ સમય - જો સ્થિતિ બરાબર છે, તો ઉપકરણ પ્રતિસાદ સમય લખાયેલ છે, અન્યથા "-1"

તત્વનો માર્ગ થોડો સરળ છે એક્સપથ:

શબ્દમાળા(//response/generic[@objectname="{#SIP_PEER_OBEJECTNAME}"]/@status)

બીજા તત્વ માટે મેં અલગ કરવા માટે JavaScript નો ઉપયોગ કર્યો પ્રતિભાવ સમય પીઅર સ્ટેટસમાંથી, કારણ કે તેઓ એકસાથે સંગ્રહિત છે:

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

નિષ્કર્ષ

આઉટ-ઓફ-ધ-બોક્સ સોલ્યુશન જટિલ હોઈ શકે છે અને તરત જ સ્પષ્ટ થઈ શકતું નથી. વિવિધ સિસ્ટમો વચ્ચે સુગમતા અને સુવાહ્યતા વધારે છે

દરેકને ખુશ અને સરળ એકીકરણ! સેટઅપ માટે ટેમ્પલેટ અને સૂચનાઓ GitHub.

સોર્સ: www.habr.com