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

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

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

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

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

हम पीबीएक्स से डेटा प्राप्त करते हैं

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

सबसे पहले हमें यह पता लगाना होगा कि ये अगी, अमी, अरी... क्या हैं।

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

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

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

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

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

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

खोज पर वापस जाएँ

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

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

asterisk -rx "sip reload"

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

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

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

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

वेब एमी - यह किस प्रकार का जानवर है?

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

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>

वहां काम करने के लिए आपको चाहिए हवेली_आईडी="6f5de42c", अर्थात प्राधिकरण कुकी स्वयं।
सामग्री को केवल उत्तर की उपस्थिति के लिए जांचने की आवश्यकता है "प्रमाणीकरण स्वीकार किया गया". इसके बाद, PBX सर्वर के सभी अनुरोधों के लिए, हमें अनुरोध में एक प्राधिकरण कुकी जोड़ने की आवश्यकता होगी।

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

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

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

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) से चर का उपयोग करते हैं।

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

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

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

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

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

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

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

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

एसआईपी पीयर्स

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

यहां दो आश्रित तत्व बनाए गए हैं:

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

तत्व तक पहुँचने का मार्ग पहले से ही थोड़ा सरल है एक्सपाथ:

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

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

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

निष्कर्ष

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

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

स्रोत: www.habr.com