बॉक्सच्या बाहेर Asterisk सह Zabbix कसे कनेक्ट करावे

मागील लेखात "झॅबिक्स - मॅक्रो सीमांचा विस्तार करणे" मी तुम्हाला ऑथोरायझेशन सेशन कसे मिळवायचे आणि ते स्थानिक होस्ट मॅक्रोमध्ये कसे बदलायचे ते सांगितले. या लेखात मी तुम्हाला सांगेन की बाह्य स्क्रिप्ट आणि सॉफ्टवेअरशिवाय ऍस्टरिस्कसह Zabbix कसे कनेक्ट करावे.

अतिरिक्त सॉफ्टवेअर किंवा स्क्रिप्ट स्थापित न करता, या दोन प्रणालींमध्ये "मित्र बनवण्याची" कल्पना फार पूर्वी जन्माला आली होती. जलद गुगलिंगमुळे अनेक संभाव्य निराकरणे मिळाली, हे सर्व या वस्तुस्थितीकडे वळले की स्क्रिप्ट (Pyha, Bash, Python, इ. मध्ये) सर्व्हरवर अपलोड करा आणि तुम्हाला आनंद होईल. मला बाह्य स्क्रिप्टशिवाय आणि मॉनिटरिंग आणि PBX सह सर्व्हरवर अतिरिक्त सॉफ्टवेअर स्थापित न करता - "बॉक्सच्या बाहेर" मॉनिटरिंग लागू करायचे होते.

मी यासह एकूण 4 कामकाजाचे दिवस घालवले, परंतु त्याचा परिणाम योग्य होता. AMI इंटरफेस, लो-लेव्हल डिटेक्शन, ट्रिगर आणि सर्वात महत्त्वाचे म्हणजे, PBX आणि इतर सर्व सेटिंग्ज कनेक्ट करण्यासाठी आता सुमारे 15 मिनिटे लागतात.

Zabbix 4.4 उपलब्ध आहे, Asterisk आवृत्ती 100 चे सुमारे 13 तुकडे. काही पीबीएक्स फ्रीपीबीएक्स वेब इंटरफेससह येतात, काही बेअर कन्सोलसह, अनेक युक्त्या आणि डायलप्लॅनद्वारे एकत्रीकरणासह येतात.

PBX कडून डेटा प्राप्त करत आहे

पहिला आणि मुख्य मुद्दा ज्याचे निराकरण करणे आवश्यक आहे तो म्हणजे समवयस्क आणि SIP नोंदणींबद्दल डेटा मिळवणे. या उद्देशासाठी, PBX मध्ये AGI, AMI, ARI आणि SSH कन्सोल इंटरफेस आहेत. स्पष्ट कारणांमुळे, मी अतिरिक्त मॉड्यूल्सचा विचार केला नाही.

प्रथम आपण हे अगी, अमी, अरि काय आहेत हे शोधून काढले पाहिजे...

• AGI - डायलप्लॅनमध्ये स्क्रिप्ट वापरणे. मुख्यतः कॉल व्यवस्थापनासाठी वापरले जाते.
• AMI - सर्व आवश्यक माहिती प्रदान करू शकते, पोर्ट 5038 द्वारे कार्य करते, टेलनेट प्रमाणेच. आम्हाला सूट!
• ARI - आधुनिक, फॅशनेबल, JSON. बर्याच शक्यता आहेत, डेटा स्वरूप Zabbix साठी समजण्यासारखे आहे, परंतु माझ्यासाठी कोणतीही मुख्य गोष्ट नाही: आपण सिप नोंदणी नियंत्रित करू शकत नाही. आणखी एक तोटा असा आहे की समवयस्कांसाठी फक्त दोन राज्ये ऑनलाइन/ऑफलाइन आहेत, जरी तेथे अधिक राज्ये आहेत आणि निदान करताना ते विचारात घेणे उपयुक्त आहे.
• SSH सर्वकाही करू शकते, परंतु काहीवेळा "सुरक्षा कारणांमुळे" परवानगी दिली जात नाही. विचार भिन्न असू शकतात, मी त्यात जाणार नाही.

तथापि, त्याच्या सर्व कमतरतांसह, ARI सर्व देखरेखीच्या गरजांपैकी 90% कव्हर करते.

Zabbix आणि Telnet - माझी निराशा

मला AMI चांगलं माहीत आहे; एकेकाळी मी रिमोट ऑफिस, कॉल मॅनेजमेंट इत्यादींद्वारे विभागणी केलेल्या संभाषणांमध्ये झालेल्या नुकसानाचा मागोवा घेणे लागू केले. टेलनेटसह, सर्वकाही अगदी स्पष्ट आहे: कनेक्शन उघडा, आदेश पाठवा आणि प्रतिसाद वाचा. मी तेच केले, पण निकालाने माझी निराशा केली.

Zabbix मधील टेलनेट लिनक्स कन्सोल प्रमाणे नाही, ते थोडे सोपे आहे आणि लॉगिन/पासवर्ड सारख्या मानक अधिकृततेसाठी तयार केले आहे. अधिकृतता तर्क भिन्न असल्यास, आणि लॉगिन/पासवर्ड जोडीसाठी कोणतीही विनंती नसल्यास, एक त्रुटी येते. अधिकृतता आवश्यकता बायपास करण्याच्या व्यर्थ प्रयत्नांनंतर, टेलनेट मॉड्यूलचा स्त्रोत कोड पाहणे उपयुक्त ठरले.

मला समजले की जोपर्यंत पारंपारिक लॉगिन आणि पासवर्डची विनंती होत नाही तोपर्यंत मी पुढे जाणार नाही. फक्त मनोरंजनासाठी, मी कोडमधून अधिकृततेशी संबंधित सर्व काही काढून टाकले आणि सर्वकाही पुन्हा एकत्र केले. कार्य करते! पण ते गरजा पूर्ण करत नाही. पुढे जा…

चला शोधाकडे परत जाऊया

मी एआरआय दस्तऐवजीकरण पुन्हा वाचले, अतिरिक्त चाचण्या केल्या - येथे कोणतीही सिप नोंदणी नाही. मेजवानी आहेत, संभाषणे आहेत, ब्रीच आहेत, परंतु नोंदणी नाहीत. कधीतरी मला असंही वाटलं, की गिधाडांच्या नोंदणीची गरज आहे का?

एका मजेदार योगायोगाने, या क्षणी आउटगोइंग कॉलमध्ये समस्या असलेल्या वापरकर्त्याकडून दुसरी विनंती आली. समस्या अशी होती की सिप नोंदणी गोठली होती आणि फक्त मॉड्यूल रीबूट करून सोडवली गेली.

asterisk -rx "sip reload"

वेबवरून AMI मध्ये प्रवेश करणे चांगले होईल: यामुळे सर्व समस्यांचे निराकरण होईल, मला वाटले. मी या दिशेने खोदण्यास सुरवात करतो, आणि अक्षरशः पहिली शोध ओळ अधिकृत एस्टेरिस्क दस्तऐवजीकरणाकडे जाते, जे म्हणते की माझ्या कार्यांसाठी एक पर्याय आहे वेब सक्षम फाइल मध्ये /etc/asterisk/manager.conf, जे विभागामध्ये होय वर सेट करणे आवश्यक आहे [सामान्य]

यानंतर, फॉर्मची नियमित वेब विनंतीद्वारे http://ats:8089/mxml?action=SIPshowregistry आम्हाला सर्व आवश्यक माहिती मिळते.

FreePBX इंटरफेस वापरताना, तुम्ही वेबद्वारे हा पर्याय सक्षम करू शकत नाही; तुम्हाला manager.conf फाइलमध्ये बदल करून कन्सोलद्वारे सक्षम करणे आवश्यक आहे. जेव्हा वेबद्वारे कॉन्फिगरेशन बदल केले जातात तेव्हा FreePBX ते मिटवत नाही.

मी बर्याच काळापासून विविध प्रकारच्या Asterisk इंटिग्रेशनसह काम केले आहे, परंतु मी या वैशिष्ट्याचा उल्लेख कुठेही पाहिलेला नाही. मला आश्चर्य वाटले की पीबीएक्सशी संवाद साधण्याच्या या पद्धतीचे कोणीही वर्णन करत नाही. या विषयावरील माहिती शोधणे विशेषतः उपयुक्त होते: व्यावहारिकदृष्ट्या काहीही नाही किंवा ते पूर्णपणे भिन्न कार्यांसाठी वापरले गेले.

वेब एएमआय - कोणत्या प्रकारचे पशू?

एक पर्याय जोडत आहे वेब सक्षम दाखल करण्याचा manager.conf वेबद्वारे एटीएस व्यवस्थापनास पूर्ण प्रवेश प्रदान केला. नियमित AMI द्वारे उपलब्ध सर्व आदेश आता वेबवर आहेत, तुम्ही PBX वरून सॉकेटद्वारे इव्हेंट ऐकू शकता. ऑपरेशनचे सिद्धांत कन्सोल एएमआयपेक्षा वेगळे नाही. हा पर्याय सक्रिय केल्यानंतर, तुम्ही खालील पत्त्यांवर 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 मध्ये स्क्रिप्ट बनवली

एक मनोरंजक मुद्दा: एटीएस प्रतिसादात, सर्व पॅरामीटर्स एकल अवतरणांनी वेढलेले आहेत आणि टेम्पलेट लागू केल्यानंतर //प्रतिसाद/सामान्य[@होस्ट] ते दुहेरीने बदलले आहेत.

घटक तयार करण्यासाठी, आम्ही XML प्रतिसाद (आता JSON) मधील व्हेरिएबल्स वापरतो.

SIP नोंदणी

सिप नोंदणीसाठी आम्ही तीन व्हेरिएबल्स वापरतो: वापरकर्ता नाव, यजमान, पोर्ट. तत्वाच्या नावाने मला आनंद झाला [ईमेल संरक्षित]: 5060, मला अशी कोणतीही परिस्थिती आढळली नाही जिथे तुम्हाला सर्व पाच व्हेरिएबल्स वापरण्याची आवश्यकता आहे.

सर्व नोंदणींबद्दल माहिती प्राप्त करणारा मुख्य घटक, Asterisk - AMI SIPshowregistry. मिनिटातून एकदा ते GET विनंती करते https://ats:8089/mxml?action=SIPshowregistry, ज्यानंतर प्रतिसाद XML डेटा सर्व अवलंबून घटकांना पार्सिंगसाठी पास केला जातो. प्रत्येक नोंदणीसाठी मी त्यावर अवलंबून असलेला घटक तयार करतो. हे सोयीचे आहे कारण आम्हाला एका विनंतीमध्ये अद्ययावत माहिती मिळते, प्रत्येक विनंतीसाठी स्वतंत्रपणे नाही. या अंमलबजावणीमध्ये एक महत्त्वपूर्ण कमतरता आहे - प्रोसेसरवरील भार.

100 अवलंबित घटकांची चाचणी करताना, मला लोड लक्षात आले नाही, परंतु 1700 घटकांसह, यामुळे प्रोसेसरवर 15 सेकंदाचा भार दिसून आला. तुमच्याकडे मोठ्या संख्येने अवलंबून घटक असल्यास हे लक्षात ठेवा.

लोड “स्प्रेड आउट” करण्याचा पर्याय म्हणून किंवा घटकासाठी भिन्न पोलिंग फ्रिक्वेन्सी सेट करण्यासाठी, तुम्ही प्रक्रिया तर्कशास्त्र प्रत्येक घटकावर स्वतंत्रपणे हलवू शकता.

मी प्राप्त केलेली माहिती मुख्य घटकामध्ये साठवत नाही. प्रथम, मला याची आवश्यकता दिसत नाही आणि दुसरे म्हणजे, जर प्रतिसाद 64K पेक्षा जास्त असेल तर Zabbix ते कापून टाकते.

आम्‍ही आश्रित घटकासाठी पूर्ण 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