কীভাবে জ্যাবিক্সকে বক্সের বাইরে তারকাচিহ্নের সাথে সংযুক্ত করবেন

পূর্ববর্তী নিবন্ধে "জ্যাবিক্স - ম্যাক্রো সীমানা প্রসারিত করা" আমি আপনাকে বলেছি কিভাবে একটি অনুমোদন সেশন গ্রহণ করতে হয় এবং এটিকে স্থানীয় হোস্ট ম্যাক্রোতে প্রতিস্থাপন করতে হয়। এই প্রবন্ধে আমি আপনাকে বলব কিভাবে বাহ্যিক স্ক্রিপ্ট এবং সফ্টওয়্যার ছাড়াই Asterisk-এর সাথে Zabbix সংযোগ করতে হয়।

অতিরিক্ত সফ্টওয়্যার বা স্ক্রিপ্ট ইনস্টল না করে এই দুটি সিস্টেমের "বন্ধু তৈরি" করার ধারণাটি অনেক আগে জন্মগ্রহণ করেছিল। একটি দ্রুত গুগলিংয়ের ফলে অনেকগুলি সম্ভাব্য সমাধান পাওয়া গেছে, এটি সবই এই সত্যে ফুটে উঠেছে যে সার্ভারে স্ক্রিপ্টগুলি (Pyha, Bash, Python, ইত্যাদি) আপলোড করুন এবং আপনি খুশি হবেন। আমি বাহ্যিক স্ক্রিপ্ট ছাড়া এবং মনিটরিং এবং PBX সহ সার্ভারে অতিরিক্ত সফ্টওয়্যার ইনস্টল না করে - "বাক্সের বাইরে" পর্যবেক্ষণ বাস্তবায়ন করতে চেয়েছিলাম।

আমি এটির সাথে মোট 4 কার্যদিবস কাটিয়েছি, তবে ফলাফলটি মূল্যবান ছিল। এএমআই ইন্টারফেসের মাধ্যমে কাজ করা, নিম্ন-স্তরের সনাক্তকরণ, ট্রিগার এবং সবচেয়ে গুরুত্বপূর্ণভাবে, পিবিএক্স এবং অন্যান্য সমস্ত সেটিংস সংযোগ করতে এখন প্রায় 15 মিনিট সময় লাগে।

Zabbix 4.4 উপলব্ধ, Asterisk সংস্করণ 100 এর প্রায় 13 টুকরা। কিছু পিবিএক্স ফ্রিপিবিএক্স ওয়েব ইন্টারফেসের সাথে আসে, কিছু খালি কনসোল সহ, একগুচ্ছ কৌশল এবং ডায়ালপ্ল্যানের মাধ্যমে ইন্টিগ্রেশন।

PBX থেকে ডেটা গ্রহণ করা হচ্ছে

প্রথম এবং প্রধান বিষয় যা সমাধান করা দরকার তা হল সহকর্মী এবং এসআইপি নিবন্ধন সম্পর্কে ডেটা প্রাপ্ত করা। এই উদ্দেশ্যে, PBX এর AGI, AMI, ARI এবং SSH কনসোল ইন্টারফেস রয়েছে। সুস্পষ্ট কারণে, আমি অতিরিক্ত মডিউল বিবেচনা করিনি।

প্রথমে আমাদের বের করতে হবে এই আগী, আমি, আরি কি...

• AGI - ডায়ালপ্ল্যানে স্ক্রিপ্ট ব্যবহার করে। প্রধানত কল পরিচালনার জন্য ব্যবহৃত হয়।
• AMI - সমস্ত প্রয়োজনীয় তথ্য প্রদান করতে পারে, পোর্ট 5038 এর মাধ্যমে কাজ করে, টেলনেটের মতো। আমাদের উপযুক্ত!
• ARI - আধুনিক, ফ্যাশনেবল, JSON। অনেক সম্ভাবনা আছে, Zabbix এর জন্য ডেটা বিন্যাস বোধগম্য, কিন্তু আমার জন্য কোন প্রধান জিনিস নেই: আপনি সিপ নিবন্ধন নিয়ন্ত্রণ করতে পারবেন না। আরেকটি অসুবিধা হল যে সমবয়সীদের জন্য অনলাইন/অফলাইন মাত্র দুটি রাজ্য রয়েছে, যদিও আরও রাজ্য রয়েছে এবং নির্ণয়ের সময় সেগুলি বিবেচনায় নেওয়া কার্যকর।
• SSH সবকিছু করতে পারে, কিন্তু কখনও কখনও এটি "নিরাপত্তার কারণে" অনুমোদিত হয় না। বিবেচনা ভিন্ন হতে পারে, আমি সেগুলিতে যাব না।

যাইহোক, এর সমস্ত ঘাটতি সহ, ARI সমস্ত পর্যবেক্ষণ প্রয়োজনের 90% কভার করে।

Zabbix এবং Telnet - আমার হতাশা

আমি এএমআই ভালোভাবে জানি; এক সময় আমি দূরবর্তী অফিস, কল ম্যানেজমেন্ট ইত্যাদির মাধ্যমে বিভাগের সাথে কথোপকথনে ক্ষতির ট্র্যাকিং প্রয়োগ করেছি। টেলনেটের সাথে, সবকিছু খুব স্পষ্ট: সংযোগ খুলুন, কমান্ড পাঠান এবং প্রতিক্রিয়া পড়ুন। আমি তাই করেছি, কিন্তু ফলাফল আমাকে হতাশ করেছে।

জ্যাবিক্সে টেলনেট লিনাক্স কনসোলের মতো নয়, এটি একটু সহজ এবং মানসম্মত অনুমোদনের জন্য যেমন লগইন/পাসওয়ার্ডের জন্য তৈরি। অনুমোদনের যুক্তি ভিন্ন হলে, এবং লগইন/পাসওয়ার্ড জোড়ার জন্য কোন অনুরোধ না থাকলে, একটি ত্রুটি ঘটে। অনুমোদনের প্রয়োজনীয়তা বাইপাস করার নিরর্থক প্রচেষ্টার পরে, টেলনেট মডিউলের সোর্স কোডটি দেখার জন্য এটি কার্যকর ছিল।

আমি বুঝতে পেরেছি যে একটি ঐতিহ্যগত লগইন এবং পাসওয়ার্ড অনুরোধ না হওয়া পর্যন্ত, আমি এগিয়ে যাব না। শুধু মজা করার জন্য, আমি কোড থেকে অনুমোদন সম্পর্কিত সবকিছু সরিয়ে দিয়েছি এবং সবকিছু পুনরায় একত্রিত করেছি। কাজ করে! কিন্তু এটি প্রয়োজনীয়তা পূরণ করে না। এগিয়ে যান…

আসুন অনুসন্ধানে ফিরে আসি

আমি আবার এআরআই ডকুমেন্টেশনটি আবার পড়লাম, অতিরিক্ত পরীক্ষা চালিয়েছি - এখানে কোন চুমুক নিবন্ধন নেই। ভোজ আছে, কথোপকথন আছে, ব্রীচ আছে, কিন্তু কোন নিবন্ধন নেই। এক পর্যায়ে আমি এমনকি ভেবেছিলাম, আমাদের কি সত্যিই শকুন নিবন্ধনের দরকার আছে?

একটি মজার কাকতালীয়ভাবে, এই মুহুর্তে আউটগোয়িং কলগুলির সমস্যা সহ ব্যবহারকারীর কাছ থেকে আরেকটি অনুরোধ আসে। সমস্যাটি ছিল যে সিপ নিবন্ধনটি জমে ছিল এবং কেবল মডিউলটি পুনরায় বুট করার মাধ্যমে সমাধান করা হয়েছিল।

asterisk -rx "sip reload"

ওয়েবে এএমআই অ্যাক্সেস করা দুর্দান্ত হবে: এটি সমস্ত সমস্যার সমাধান করবে, আমি ভেবেছিলাম। আমি এই দিকে খনন শুরু করি এবং আক্ষরিক অর্থে প্রথম অনুসন্ধান লাইনটি অফিসিয়াল অ্যাস্টারিস্ক ডকুমেন্টেশনের দিকে নিয়ে যায়, যা বলে যে আমার কাজের জন্য একটি বিকল্প রয়েছে ওয়েব সক্ষম ফাইলে /etc/asterisk/manager.conf, যা বিভাগে হ্যাঁ সেট করা প্রয়োজন [সাধারণ]

এর পরে, নিয়মিত ওয়েবের মাধ্যমে ফর্মের অনুরোধ http://ats:8089/mxml?action=SIPshowregistry আমরা সব প্রয়োজনীয় তথ্য পেতে.

FreePBX ইন্টারফেস ব্যবহার করার সময়, আপনি ওয়েবের মাধ্যমে এই বিকল্পটি সক্ষম করতে পারবেন না; আপনাকে manager.conf ফাইলে পরিবর্তন করে কনসোলের মাধ্যমে এটি সক্ষম করতে হবে। ওয়েবের মাধ্যমে কনফিগারেশন পরিবর্তন করা হলে FreePBX এটি মুছে দেয় না।

আমি দীর্ঘ সময়ের জন্য বিভিন্ন ধরণের অ্যাস্ট্রিস্ক ইন্টিগ্রেশনের সাথে কাজ করেছি, কিন্তু আমি কোথাও উল্লেখিত এই বৈশিষ্ট্যটি দেখিনি। আমি অবাক হয়েছিলাম যে কেউ 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 ফর্ম্যাটে। আমাদের উপযুক্ত!

তারপর আমি ভেবেছিলাম: "এটাই সমাধান! এখন সবকিছু প্রস্তুত হবে! সহজ-পিজি লেবু 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>

প্রতিক্রিয়াতে প্রচুর আবর্জনা রয়েছে, তাই প্রিপ্রসেসিংয়ে আমরা টেমপ্লেট দ্বারা এটি ফিল্টার করি এক্সপ্যাথ: //প্রতিক্রিয়া/জেনারিক[@হোস্ট]
তারপর মজা শুরু হয়। সনাক্তকরণের সাথে কাজ করতে এবং গতিশীলভাবে উপাদান তৈরি করতে, প্রতিক্রিয়া অবশ্যই JSON ফর্ম্যাটে হতে হবে। XML স্বয়ংক্রিয় সনাক্তকরণের জন্য সমর্থিত নয়।

XML কে JSON এ রূপান্তর করতে, আমাকে স্বয়ংক্রিয় প্রতিস্থাপনের সাথে কিছুটা খেলতে হয়েছিল, যার জন্য আমি JS এ একটি স্ক্রিপ্ট তৈরি করেছি

একটি আকর্ষণীয় পয়েন্ট: এটিএস প্রতিক্রিয়াতে, সমস্ত পরামিতি একক উদ্ধৃতি দ্বারা বেষ্টিত হয় এবং টেমপ্লেট প্রয়োগ করার পরে //প্রতিক্রিয়া/জেনারিক[@হোস্ট] তারা ডবল বেশী দ্বারা প্রতিস্থাপিত হয়.

উপাদান তৈরি করতে, আমরা XML প্রতিক্রিয়া (এখন JSON) থেকে ভেরিয়েবল ব্যবহার করি।

এসআইপি রেজিস্ট্রি

সিপ রেজিস্ট্রেশনের জন্য আমরা তিনটি ভেরিয়েবল ব্যবহার করি: ব্যবহারকারীর নাম, নিমন্ত্রণকর্তা, বন্দর. আমি উপাদানটির নাম দিয়ে খুশি ছিলাম [ইমেল সুরক্ষিত]: 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}"]/@ অবস্থা)
রেজিস্ট্রেশন স্ট্যাটাসের জন্য, আমি টেক্সট স্ট্যাটাস ব্যবহার করিনি, কিন্তু জাভাস্ক্রিপ্ট ব্যবহার করে সংখ্যাসূচক আকারে রূপান্তর করেছি:

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)

দ্বিতীয় উপাদানের জন্য আমি আলাদা করতে জাভাস্ক্রিপ্ট ব্যবহার করেছি প্রতিক্রিয়া সময় পিয়ার স্ট্যাটাস থেকে, যেহেতু তারা একসাথে সংরক্ষণ করা হয়:

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

উপসংহার

বাক্সের বাইরের একটি সমাধান জটিল হতে পারে এবং অবিলম্বে স্পষ্ট নয়। বিভিন্ন সিস্টেমের মধ্যে নমনীয়তা এবং বহনযোগ্যতা বৃদ্ধি করে

সুখী এবং সহজ একীকরণ সবাই! সেট আপ করার জন্য টেমপ্লেট এবং নির্দেশাবলী GitHub.

উত্স: www.habr.com