ज़ैबिक्स को बॉक्स से बाहर एस्टरिस्क के साथ कैसे कनेक्ट करें

पिछले एक लेख में "ज़ैबिक्स - स्थूल सीमाओं का विस्तार" मैंने आपको बताया कि प्राधिकरण सत्र कैसे प्राप्त करें और इसे स्थानीय होस्ट मैक्रो में कैसे बदलें। इस लेख में मैं आपको बताऊंगा कि ज़ैबिक्स को बाहरी स्क्रिप्ट और सॉफ़्टवेयर के बिना एस्टरिस्क से कैसे जोड़ा जाए।

अतिरिक्त सॉफ़्टवेयर या स्क्रिप्ट इंस्टॉल किए बिना, इन दोनों प्रणालियों को "दोस्त बनाने" का विचार बहुत पहले पैदा हुआ था। एक त्वरित गूगलिंग से कई संभावित समाधान मिले, यह सब इस तथ्य पर आधारित था कि स्क्रिप्ट (पाइहा, बैश, पायथन, आदि में) को सर्वर पर अपलोड करें, और आप खुश होंगे। मैं मॉनिटरिंग को "आउट ऑफ द बॉक्स" लागू करना चाहता था - बाहरी स्क्रिप्ट के बिना और मॉनिटरिंग और पीबीएक्स के साथ सर्वर पर अतिरिक्त सॉफ़्टवेयर स्थापित करना।

मैंने इसके साथ कुल 4 कार्य दिवस बिताए, लेकिन परिणाम इसके लायक था। एएमआई इंटरफ़ेस, निम्न-स्तरीय पहचान, ट्रिगर्स और सबसे महत्वपूर्ण बात, पीबीएक्स और अन्य सभी सेटिंग्स को कनेक्ट करने में अब लगभग 15 मिनट लगते हैं।

ज़ैबिक्स 4.4 उपलब्ध है, एस्टरिस्क संस्करण 100 के लगभग 13 टुकड़े। कुछ पीबीएक्स फ्रीपीबीएक्स वेब इंटरफेस के साथ आते हैं, कुछ नंगे कंसोल, डायलप्लान के माध्यम से कई युक्तियों और एकीकरण के साथ आते हैं।

पीबीएक्स से डेटा प्राप्त करना

पहला और मुख्य बिंदु जिसे हल करने की आवश्यकता है वह है समकक्षों और एसआईपी पंजीकरणों के बारे में डेटा प्राप्त करना। इस उद्देश्य के लिए, पीबीएक्स में एजीआई, एएमआई, एआरआई और एसएसएच कंसोल इंटरफेस हैं। स्पष्ट कारणों से, मैंने अतिरिक्त मॉड्यूल पर विचार नहीं किया।

सबसे पहले हमें यह पता लगाना होगा कि ये एजीआई, एमी, एरी क्या हैं...

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

हालाँकि, अपनी सभी कमियों के साथ, ARI सभी निगरानी आवश्यकताओं का 90% कवर करता है।

ज़ैबिक्स और टेलनेट - मेरी निराशा

मैं एएमआई को अच्छी तरह से जानता हूं; एक समय में मैंने दूरस्थ कार्यालयों, कॉल प्रबंधन आदि द्वारा डिवीजन के साथ बातचीत में घाटे की ट्रैकिंग लागू की थी। टेलनेट के साथ, सब कुछ बहुत स्पष्ट है: कनेक्शन खोलें, आदेश भेजें और प्रतिक्रिया पढ़ें। मैंने यही किया, लेकिन परिणाम ने मुझे निराश किया।

ज़ैबिक्स में टेलनेट लिनक्स कंसोल के समान नहीं है, यह थोड़ा सरल है और लॉगिन/पासवर्ड जैसे मानक प्राधिकरण के लिए तैयार किया गया है। यदि प्राधिकरण तर्क भिन्न है, और लॉगिन/पासवर्ड जोड़ी के लिए कोई अनुरोध नहीं है, तो एक त्रुटि उत्पन्न होती है। प्राधिकरण आवश्यकता को दरकिनार करने के निरर्थक प्रयासों के बाद, टेलनेट मॉड्यूल के स्रोत कोड को देखना उपयोगी था।

मुझे एहसास हुआ कि जब तक पारंपरिक लॉगिन और पासवर्ड अनुरोध नहीं होगा, मैं आगे नहीं बढ़ूंगा। केवल मनोरंजन के लिए, मैंने कोड से प्राधिकरण से संबंधित सभी चीज़ों को हटा दिया और सभी चीज़ों को फिर से जोड़ दिया। काम करता है! लेकिन यह आवश्यकताओं को पूरा नहीं करता. आगे बढ़ो…

आइए खोज पर वापस लौटें

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

एक अजीब संयोग से, इसी समय उपयोगकर्ता की ओर से आउटगोइंग कॉल की समस्या के साथ एक और अनुरोध आता है। समस्या यह थी कि सिप पंजीकरण रुक रहा था और इसे केवल मॉड्यूल को रीबूट करके हल किया गया था।

asterisk -rx "sip reload"

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

इसके बाद फॉर्म की रेगुलर वेब रिक्वेस्ट के जरिए http://ats:8089/mxml?action=SIPshowregistry हमें सभी आवश्यक जानकारी मिलती है।

FreePBX इंटरफ़ेस का उपयोग करते समय, आप वेब के माध्यम से इस विकल्प को सक्षम नहीं कर सकते हैं; आपको मैनेजर.कॉन्फ़ फ़ाइल में परिवर्तन करके कंसोल के माध्यम से इसे सक्षम करने की आवश्यकता है। जब वेब के माध्यम से कॉन्फ़िगरेशन परिवर्तन किए जाते हैं तो FreePBX इसे मिटाता नहीं है।

मैंने लंबे समय तक विभिन्न प्रकार के एस्टरिस्क एकीकरणों के साथ काम किया है, लेकिन मैंने इस सुविधा का उल्लेख कहीं भी नहीं देखा है। मुझे आश्चर्य हुआ कि कोई भी पीबीएक्स के साथ बातचीत करने की इस पद्धति का वर्णन नहीं करता है। इस विषय पर जानकारी खोजना विशेष रूप से उपयोगी था: व्यावहारिक रूप से कुछ भी नहीं है या इसका उपयोग पूरी तरह से अलग कार्यों के लिए किया गया था।

वेब एएमआई - किस तरह का जानवर?

एक विकल्प जोड़ा जा रहा है वेबनेबल दायर करना प्रबंधक.conf वेब के माध्यम से एटीएस प्रबंधन तक पूर्ण पहुंच प्रदान की गई। नियमित एएमआई के माध्यम से उपलब्ध सभी कमांड अब वेब पर हैं, आप सॉकेट के माध्यम से पीबीएक्स से घटनाओं को सुन सकते हैं। ऑपरेशन का सिद्धांत कंसोल एएमआई से अलग नहीं है। इस विकल्प को सक्रिय करने के बाद, आप निम्नलिखित पते पर पीबीएक्स से संपर्क कर सकते हैं:

https://ats:8089/manager - परीक्षण और मैन्युअल रूप से अनुरोध भेजने के लिए एक सरल इंटरफ़ेस वाला एक वेब पेज। सभी प्रतिक्रियाएँ पठनीय HTML में स्वरूपित हैं। निगरानी के लिए बहुत उपयुक्त नहीं है.
https://ats:8089/rawman - केवल टेक्स्ट आउटपुट, कंसोल एएमआई के समान प्रारूप
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", अर्थात प्राधिकरण कुकी ही।
सामग्री आपको केवल उत्तर के लिए जांचने की आवश्यकता है "प्रमाणीकरण स्वीकार किया गया" इसके बाद, पीबीएक्स सर्वर पर सभी कॉलों के लिए, हमें अनुरोध में एक प्राधिकरण कुकी जोड़ने की आवश्यकता होगी।

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

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

प्राधिकरण कुकी कैसे प्राप्त करें और अन्य अनुरोधों में इसका उपयोग कैसे करें, यहां पढ़ें: "ज़ैबिक्स - स्थूल सीमाओं का विस्तार»

ज़ैबिक्स में ट्रैकिंग तत्व बनाने के लिए मैं ऑटो डिटेक्शन का उपयोग करूंगा।

स्वतः पता लगाना

पंजीकरणों का स्वचालित रूप से पता लगाने और सहकर्मी राज्यों को ट्रैक करने के लिए, आपको निम्नलिखित पते पर संपर्क करना होगा: 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) से वेरिएबल का उपयोग करते हैं।

एसआईपी रजिस्ट्री

सिप पंजीकरण के लिए हम तीन चर का उपयोग करते हैं: उपयोगकर्ता नाम, मेजबान, बंदरगाह. मैं तत्व के नाम से खुश था [ईमेल संरक्षित]: 5060, मुझे ऐसी कोई स्थिति नहीं मिली जहां आपको सभी पांच चरों का उपयोग करने की आवश्यकता हो।

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

100 आश्रित तत्वों तक का परीक्षण करते समय, मैंने लोड पर ध्यान नहीं दिया, लेकिन 1700 तत्वों के साथ, इसने प्रोसेसर पर ध्यान देने योग्य 15 सेकंड का लोड दिया। यदि आपके पास बड़ी संख्या में आश्रित तत्व हैं तो इसे ध्यान में रखें।

किसी तत्व के लिए लोड को "फैलाने" या अलग-अलग मतदान आवृत्तियों को सेट करने के विकल्प के रूप में, आप प्रसंस्करण तर्क को प्रत्येक तत्व में अलग से स्थानांतरित कर सकते हैं।

मैं प्राप्त जानकारी को मुख्य तत्व में संग्रहीत नहीं करता हूँ। सबसे पहले, मुझे इसकी आवश्यकता नहीं दिखती है, और दूसरी बात, यदि प्रतिक्रिया 64K से अधिक है, तो ज़ैबिक्स इसे काट देता है।

चूँकि हम निर्भर तत्व के लिए पूर्ण XML प्रतिक्रिया का उपयोग करते हैं, इसलिए हमें प्रीप्रोसेसिंग में इस तत्व का मूल्य प्राप्त करने की आवश्यकता है। के माध्यम से एक्सपाथ यह इस प्रकार किया गया है:
स्ट्रिंग(//प्रतिक्रिया/जेनेरिक[@event='रजिस्ट्रीएंट्री'][@username='{#SIP_REGISTRY_USERNAME}''][@host='{#SIP_REGISTRY_HOST}''][@port='{#SIP_REGISTRY_PORT}']/@ राज्य)
पंजीकरण स्थितियों के लिए, मैंने टेक्स्ट स्थितियों का उपयोग नहीं किया, बल्कि जावास्क्रिप्ट का उपयोग करके उन्हें संख्यात्मक रूप में परिवर्तित किया:

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

एसआईपी सहकर्मी

एसआईपी पंजीकरण के अनुरूप, तारांकन चिह्न का एक मुख्य तत्व है - एएमआई एसआईपीशोरजिस्ट्री, जिसमें आश्रित लोगों को जोड़ा जाता है।

इससे दो आश्रित तत्व बनते हैं:

• पाठ रूप में समकक्ष स्थिति
• डिवाइस प्रतिक्रिया समय - यदि स्थिति ठीक है, तो डिवाइस प्रतिक्रिया समय लिखा है, अन्यथा "-1"

तत्व का मार्ग स्वयं थोड़ा सरल है एक्सपाथ:

स्ट्रिंग(//प्रतिक्रिया/जेनेरिक[@ऑब्जेक्टनाम='{#SIP_PEER_OBEJECTNAME}']/@status)

दूसरे तत्व को अलग करने के लिए मैंने जावास्क्रिप्ट का उपयोग किया प्रतिक्रिया समय सहकर्मी स्थिति से, क्योंकि वे एक साथ संग्रहीत हैं:

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

निष्कर्ष

आउट-ऑफ़-द-बॉक्स समाधान जटिल हो सकता है और तुरंत स्पष्ट नहीं हो सकता है। विभिन्न प्रणालियों के बीच लचीलापन और पोर्टेबिलिटी बढ़ाता है

सभी को खुश और आसान एकीकरण! सेटअप के लिए टेम्पलेट और निर्देश GitHub.

स्रोत: www.habr.com