कसरी Zabbix लाई Asterisk बाट बक्स बाहिर जडान गर्ने

अघिल्लो लेखमा "Zabbix - म्याक्रो सीमाहरू विस्तार गर्दै" मैले तपाइँलाई कसरी प्राधिकरण सत्र प्राप्त गर्ने र यसलाई स्थानीय होस्ट म्याक्रोमा प्रतिस्थापन गर्ने भनेर बताएको छु। यस लेखमा म तपाइँलाई बाह्य स्क्रिप्ट र सफ्टवेयर बिना Asterisk सँग Zabbix कसरी जडान गर्ने भनेर बताउनेछु।

यी दुई प्रणालीहरूको "साथी बनाउने" विचार धेरै पहिले जन्मिएको थियो, अतिरिक्त सफ्टवेयर वा स्क्रिप्टहरू स्थापना नगरी। द्रुत गुगलिङले धेरै सम्भावित समाधानहरू निकाल्यो, यो सबै तथ्यमा उमालेको छ कि स्क्रिप्टहरू (Pyha, Bash, Python, आदि) सर्भरमा अपलोड गर्नुहोस्, र तपाईं खुसी हुनुहुनेछ। बाह्य स्क्रिप्ट बिना र निगरानी र PBX को साथ सर्भरमा अतिरिक्त सफ्टवेयर स्थापना बिना - म "बक्स बाहिर" अनुगमन कार्यान्वयन गर्न चाहन्थें।

मैले यससँग कुल 4 कार्य दिनहरू बिताएँ, तर परिणाम यसको लायक थियो। AMI इन्टरफेस, निम्न-स्तर पत्ता लगाउने, ट्रिगरहरू, र सबैभन्दा महत्त्वपूर्ण कुरा, PBX र अन्य सबै सेटिङहरू जडान गर्न अब लगभग 15 मिनेट लाग्छ।

Zabbix 4.4 उपलब्ध छ, Asterisk संस्करण 100 को लगभग 13 टुक्रा। केही PBX हरू FreePBX वेब इन्टरफेसका साथ आउँछन्, केही बेयर कन्सोलको साथ, ट्रिक्सहरूको गुच्छा र डायलप्लान मार्फत एकीकरण।

PBX बाट डाटा प्राप्त गर्दै

पहिलो र मुख्य बिन्दु जुन समाधान गर्न आवश्यक छ साथीहरू र SIP दर्ताहरूको बारेमा डाटा प्राप्त गर्दै। यस उद्देश्यका लागि, PBX सँग AGI, AMI, ARI र SSH कन्सोल इन्टरफेसहरू छन्। स्पष्ट कारणहरूको लागि, मैले अतिरिक्त मोड्युलहरू विचार गरेन।

पहिले हामीले यी अगी, अमी, अरि के हुन् भनेर पत्ता लगाउनु पर्छ ...

• AGI - डायलप्लानमा लिपिहरू प्रयोग गर्दै। मुख्य रूपमा कल व्यवस्थापनको लागि प्रयोग गरिन्छ।
• AMI - सबै आवश्यक जानकारी प्रदान गर्न सक्छ, पोर्ट 5038 मार्फत काम गर्दछ, टेलनेट जस्तै। हामीलाई सुहाउँछ!
• ARI - आधुनिक, फैशनेबल, JSON। त्यहाँ धेरै सम्भावनाहरू छन्, डाटा ढाँचा Zabbix को लागि बुझ्न योग्य छ, तर मेरो लागि त्यहाँ कुनै मुख्य कुरा छैन: तपाईं sip दर्ता नियन्त्रण गर्न सक्नुहुन्न। अर्को हानि यो हो कि साथीहरूको लागि त्यहाँ केवल दुई राज्यहरू अनलाइन/अफलाइन छन्, यद्यपि त्यहाँ थप राज्यहरू छन् र निदान गर्दा तिनीहरूलाई ध्यानमा राख्नु उपयोगी छ।
• SSH ले सबै कुरा गर्न सक्छ, तर कहिलेकाहीँ "सुरक्षा कारणहरू" को कारणले यसलाई अनुमति दिइँदैन। विचार फरक हुन सक्छ, म ती मा जाने छैन।

यद्यपि, यसका सबै कमजोरीहरूसँग, ARI ले सबै अनुगमन आवश्यकताहरूको 90% समेट्छ।

Zabbix र Telnet - मेरो निराशा

मलाई एएमआई राम्ररी थाहा छ; एक पटक मैले रिमोट अफिसहरू, कल व्यवस्थापन, इत्यादिद्वारा विभाजनसँग कुराकानीमा घाटा ट्र्याकिङ लागू गरें। टेलनेटको साथ, सबै कुरा पनि स्पष्ट छ: जडान खोल्नुहोस्, आदेशहरू पठाउनुहोस् र प्रतिक्रिया पढ्नुहोस्। मैले त्यही गरेँ, तर नतिजाले मलाई निराश बनायो।

Zabbix मा टेलनेट लिनक्स कन्सोलमा जस्तै छैन, यो अलि सरल छ र लगइन/पासवर्ड जस्ता मानक प्राधिकरणको लागि अनुकूल छ। यदि प्राधिकरण तर्क फरक छ, र लगइन/पासवर्ड जोडीको लागि कुनै अनुरोध छैन भने, त्रुटि हुन्छ। प्राधिकरण आवश्यकता बाइपास गर्न व्यर्थ प्रयास पछि, यो Telnet मोड्युल को स्रोत कोड हेर्न उपयोगी थियो।

मैले बुझें कि परम्परागत लगइन र पासवर्ड अनुरोध नभएसम्म म अगाडि बढ्ने छैन। केवल रमाइलोको लागि, मैले कोडबाट प्राधिकरणसँग सम्बन्धित सबै कुरा हटाएँ र सबै कुरा पुन: जम्मा गरें। कामहरू! तर यसले आवश्यकताहरू पूरा गर्दैन। अघि बढ…

खोजीमा फर्कौं

मैले एआरआई कागजात पुन: पढें, अतिरिक्त परीक्षणहरू चलाएँ - यहाँ कुनै सिप दर्ताहरू छैनन्। त्यहाँ भोजहरू छन्, त्यहाँ कुराकानीहरू छन्, त्यहाँ ब्रीचहरू छन्, तर त्यहाँ कुनै दर्ताहरू छैनन्। कहिलेकाहीँ मैले सोचेँ, के हामीलाई साँच्चै गिद्ध दर्ता चाहिन्छ?

हास्यास्पद संयोगले, यस क्षणमा प्रयोगकर्ताबाट अर्को अनुरोध आउँछ, बहिर्गमन कलहरूमा समस्याको साथ। समस्या यो थियो कि सिप रेजिष्ट्रेसन जमेको थियो र केवल मोड्युल रिबुट गरेर समाधान गरिएको थियो।

asterisk -rx "sip reload"

वेबमा AMI पहुँच गर्न यो राम्रो हुनेछ: यसले सबै समस्याहरू समाधान गर्नेछ, मैले सोचें। म यस दिशामा खन्न थाल्छु, र शाब्दिक रूपमा पहिलो खोज रेखाले आधिकारिक एस्टेरिस्क कागजातमा जान्छ, जसले भन्छ कि मेरो कार्यहरूको लागि विकल्प छ। वेब सक्षम फाइलमा /etc/asterisk/manager.conf, जसलाई खण्डमा YES मा सेट गर्न आवश्यक छ [सामान्य]

यस पछि, फारमको नियमित वेब अनुरोध मार्फत http://ats:8089/mxml?action=SIPshowregistry हामी सबै आवश्यक जानकारी प्राप्त गर्छौं।

FreePBX इन्टरफेस प्रयोग गर्दा, तपाइँ वेब मार्फत यो विकल्प सक्षम गर्न सक्नुहुन्न; तपाइँले manager.conf फाइलमा परिवर्तन गरेर कन्सोल मार्फत सक्षम गर्न आवश्यक छ। वेब मार्फत कन्फिगरेसन परिवर्तन गर्दा FreePBX ले यसलाई मेटाउँदैन।

मैले लामो समयसम्म विभिन्न प्रकारका Asterisk एकीकरणसँग काम गरेको छु, तर मैले यो सुविधा कहिँ पनि देखेको छैन। म छक्क परें कि कसैले पनि PBX सँग अन्तरक्रिया गर्ने यो विधि वर्णन गर्दैन। यो विशेष गरी यस विषयमा जानकारी खोज्न उपयोगी थियो: त्यहाँ व्यावहारिक रूपमा केहि छैन वा यो पूर्ण रूपमा फरक कार्यहरूको लागि प्रयोग गरिएको थियो।

WEB AMI - कस्तो प्रकारको जनावर?

विकल्प थप्दै वेब सक्षम फाइल गर्न manager.conf वेब मार्फत ATS व्यवस्थापनमा पूर्ण पहुँच प्रदान गरियो। नियमित AMI मार्फत उपलब्ध सबै आदेशहरू अब वेबमा छन्, तपाईंले सकेट मार्फत PBX बाट घटनाहरू सुन्न सक्नुहुन्छ। सञ्चालन को सिद्धान्त कन्सोल AMI देखि फरक छैन। यो विकल्प सक्रिय गरेपछि, तपाइँ निम्न ठेगानाहरूमा PBX लाई सम्पर्क गर्न सक्नुहुन्छ:

https://ats:8089/manager - परीक्षण र म्यानुअल रूपमा अनुरोधहरू पठाउनको लागि सरल इन्टरफेस भएको वेब पृष्ठ। सबै प्रतिक्रियाहरू पढ्न योग्य HTML मा ढाँचा गरिएका छन्। अनुगमनका लागि धेरै उपयुक्त छैन।
https://ats:8089/rawman - पाठ आउटपुट मात्र, कन्सोल AMI जस्तै ढाँचा
https://ats:8089/mxml - पाठ आउटपुट मात्र, XML ढाँचामा। हामीलाई सुहाउँछ!

त्यसपछि मैले सोचे: "यो समाधान हो! अब सबै तयार हुनेछ! Easy-peezy lemon squeezey," तर यो रमाइलो गर्न धेरै चाँडो थियो। हामीलाई आवश्यक जानकारी प्राप्त गर्न, आवश्यक कार्यको साथ 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>

प्रतिक्रियामा धेरै फोहोर छ, त्यसैले पूर्वप्रक्रियामा हामी यसलाई टेम्प्लेटद्वारा फिल्टर गर्छौं XPath: //response/generic[@host]
त्यसपछि रमाइलो सुरु हुन्छ। पत्ता लगाउन र गतिशील रूपमा तत्वहरू सिर्जना गर्न काम गर्न, प्रतिक्रिया JSON ढाँचामा हुनुपर्छ। XML स्वतः पत्ता लगाउने लागि समर्थित छैन।

XML लाई JSON मा रूपान्तरण गर्न, मैले अटो रिप्लेसमेन्टको साथ अलिकति खेल्नुपर्ने थियो, जसको लागि मैले JS मा स्क्रिप्ट बनाएको छु।

एउटा चाखलाग्दो बिन्दु: ATS प्रतिक्रियामा, सबै प्यारामिटरहरू एकल उद्धरणले घेरिएका छन्, र टेम्प्लेट लागू गरेपछि //response/generic[@host] तिनीहरू दोहोरो द्वारा प्रतिस्थापित छन्।

तत्वहरू सिर्जना गर्न, हामी XML प्रतिक्रिया (अहिले JSON) बाट चरहरू प्रयोग गर्छौं।

SIP रजिस्ट्री

सिप रेजिष्ट्रेसनको लागि हामी तीन चरहरू प्रयोग गर्छौं: प्रयोगकर्ता नाम, पाहुना, पोर्ट। म तत्व को नाम संग खुशी थिए [ईमेल सुरक्षित]: 5060, मैले कुनै पनि अवस्था फेला पारेको छैन जहाँ तपाइँ सबै पाँच चरहरू प्रयोग गर्न आवश्यक छ।

सबै दर्ता बारे जानकारी प्राप्त गर्ने मुख्य तत्व, Asterisk - AMI SIPshowregistry। एक मिनेटमा यसले GET अनुरोध गर्दछ https://ats:8089/mxml?action=SIPshowregistry, जस पछि प्रतिक्रिया XML डाटा पार्सिङ को लागी सबै निर्भर तत्वहरु लाई पास गरिन्छ। प्रत्येक दर्ताको लागि म यसमा निर्भर तत्व सिर्जना गर्छु। यो सुविधाजनक छ किनभने हामी एक अनुरोधमा अद्यावधिक जानकारी प्राप्त गर्छौं, र प्रत्येक अनुरोधको लागि अलग-अलग होइन। यो कार्यान्वयन एक महत्वपूर्ण कमी छ - प्रोसेसर मा लोड।

100 निर्भर तत्वहरू सम्म परीक्षण गर्दा, मैले लोडलाई याद गरेन, तर 1700 तत्वहरूसँग, यसले प्रोसेसरमा उल्लेखनीय 15 सेकेन्ड लोड दियो। यदि तपाईसँग धेरै संख्यामा निर्भर तत्वहरू छन् भने यसलाई ध्यानमा राख्नुहोस्।

लोडलाई "स्प्रेड आउट" गर्ने विकल्पको रूपमा वा कुनै तत्वका लागि फरक-फरक मतदान आवृत्तिहरू सेट गर्ने विकल्पको रूपमा, तपाइँ प्रशोधन तर्कलाई प्रत्येक तत्वमा अलग-अलग सार्न सक्नुहुन्छ।

मैले प्राप्त जानकारी मुख्य तत्वमा भण्डारण गर्दिन। पहिलो, म यसको आवश्यकता देख्दिन, र दोस्रो, यदि प्रतिक्रिया 64K भन्दा बढी छ भने, Zabbix ले यसलाई काट्छ।

हामीले निर्भर तत्वको लागि पूर्ण XML प्रतिक्रिया प्रयोग गर्ने हुनाले, हामीले पूर्व-प्रक्रियामा यो तत्वको मूल्य प्राप्त गर्न आवश्यक छ। मार्फत XPath यो यस्तो भयो:
string(//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"

तत्व आफैमा बाटो अलि सरल छ XPath:

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

दोस्रो तत्वको लागि मैले छुट्याउन जाभास्क्रिप्ट प्रयोग गरें प्रतिक्रिया समय सहकर्मी स्थितिबाट, तिनीहरू सँगै भण्डारण गरिएका हुनाले:

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

निष्कर्षमा

बक्स बाहिरको समाधान जटिल र तुरुन्तै स्पष्ट नहुन सक्छ। विभिन्न प्रणालीहरू बीच लचिलोपन र पोर्टेबिलिटी बढाउँछ

सबैलाई खुशी र सजिलो एकीकरण! सेटअपको लागि टेम्प्लेट र निर्देशनहरू GitHub.

स्रोत: www.habr.com