როგორ დააკავშიროთ Zabbix ასტერისკთან ყუთიდან

წინა სტატიაში "Zabbix - მაკრო საზღვრების გაფართოება" მე გითხარით, როგორ მიიღოთ ავტორიზაციის სესია და ჩაანაცვლოთ იგი ლოკალურ მასპინძელ მაკროში. ამ სტატიაში მე გეტყვით, თუ როგორ დააკავშიროთ Zabbix Asterisk-თან გარე სკრიპტებისა და პროგრამული უზრუნველყოფის გარეშე.

ამ ორი სისტემის „დამეგობრების“ იდეა დიდი ხნის წინ დაიბადა, დამატებითი პროგრამული უზრუნველყოფის ან სკრიპტების დაყენების გარეშე. სწრაფმა გუგლმა მრავალი შესაძლო გამოსავალი გამოიღო, ეს ყველაფერი იქამდე მივიდა, რომ ატვირთეთ სკრიპტები (Pyha, Bash, Python და ა.შ.) სერვერზე და თქვენ ბედნიერი იქნებით. მე მსურდა მონიტორინგის განხორციელება ”გარედან” - გარე სკრიპტების გარეშე და სერვერზე დამატებითი პროგრამული უზრუნველყოფის დაყენება მონიტორინგით და PBX-ით.

ამით სულ 4 სამუშაო დღე გავატარე, მაგრამ შედეგი ღირდა. AMI ინტერფეისით მუშაობა, დაბალი დონის გამოვლენა, ტრიგერები და რაც მთავარია, PBX-ისა და ყველა სხვა პარამეტრის დაკავშირება ახლა დაახლოებით 15 წუთი სჭირდება.

Zabbix 4.4 ხელმისაწვდომია, დაახლოებით 100 ცალი Asterisk ვერსია 13. ზოგიერთ PBX-ს გააჩნია FreePBX ვებ ინტერფეისი, ზოგს შიშველი კონსოლი, მთელი რიგი ხრიკები და ინტეგრაცია აკრიფეთ გეგმის საშუალებით.

PBX-დან მონაცემების მიღება

პირველი და მთავარი, რაც გადასაწყვეტია, არის მონაცემების მოპოვება თანატოლების და SIP რეგისტრაციის შესახებ. ამ მიზნით PBX-ს აქვს AGI, AMI, ARI და SSH კონსოლის ინტერფეისები. გასაგები მიზეზების გამო, მე არ განვიხილე დამატებითი მოდულები.

ჯერ უნდა გავარკვიოთ, რა არის ეს აგი, ამი, არი...

• AGI - სკრიპტების გამოყენებით ციფრულ გეგმაში. ძირითადად გამოიყენება ზარების მართვისთვის.
• AMI - შეუძლია მიაწოდოს ყველა საჭირო ინფორმაცია, მუშაობს 5038 პორტით, Telnet-ის მსგავსი. გვერგება!
• ARI - თანამედროვე, მოდური, JSON. ბევრი შესაძლებლობა არსებობს, მონაცემთა ფორმატი გასაგებია Zabbix-ისთვის, მაგრამ ჩემთვის მთავარი არ არის: თქვენ ვერ აკონტროლებთ sip რეგისტრაციას. კიდევ ერთი მინუსი არის ის, რომ თანატოლებისთვის არსებობს მხოლოდ ორი მდგომარეობა ონლაინ/ოფლაინ, თუმცა უფრო მეტი მდგომარეობაა და გამოსადეგია მათი გათვალისწინება დიაგნოსტიკის დროს.
• SSH-ს შეუძლია ყველაფერი გააკეთოს, მაგრამ ზოგჯერ ეს დაუშვებელია „უსაფრთხოების მიზეზების გამო“. მოსაზრებები შეიძლება განსხვავებული იყოს, მათზე არ შევალ.

თუმცა, ყველა თავისი ნაკლოვანებით, ARI ფარავს მონიტორინგის საჭიროებების 90%-ს.

Zabbix და Telnet - ჩემი იმედგაცრუება

მე კარგად ვიცი AMI; ერთ დროს განვახორციელე დანაკარგების თვალყურის დევნება სამმართველოსთან საუბარში დისტანციური ოფისებით, ზარების მენეჯმენტით და ა.შ. Telnet-ით ყველაფერი ასევე ძალიან ნათელია: გახსენით კავშირი, გაგზავნეთ ბრძანებები და წაიკითხეთ პასუხი. ასეც მოვიქეცი, მაგრამ შედეგმა იმედი გამიცრუა.

Telnet Zabbix-ში არ არის იგივე, რაც Linux-ის კონსოლში, ის ოდნავ მარტივია და მორგებულია სტანდარტული ავტორიზაციისთვის, როგორიცაა შესვლა/პაროლი. თუ ავტორიზაციის ლოგიკა განსხვავებულია და არ არის მოთხოვნა შესვლა/პაროლის წყვილის შესახებ, ჩნდება შეცდომა. ავტორიზაციის მოთხოვნის გვერდის ავლით უშედეგო მცდელობის შემდეგ, სასარგებლო იყო Telnet მოდულის წყაროს კოდის ნახვა.

მივხვდი, რომ სანამ არ იქნება ტრადიციული შესვლა და პაროლის მოთხოვნა, წინ არ წავალ. უბრალოდ გასართობად, კოდიდან ამოვიღე ავტორიზაციასთან დაკავშირებული ყველაფერი და ყველაფერი თავიდან ავკრიფე. მუშაობს! მაგრამ ის არ აკმაყოფილებს მოთხოვნებს. Განაგრძე…

დავუბრუნდეთ ძიებას

მე ხელახლა გადავიკითხე ARI-ს დოკუმენტაცია, ჩავატარე დამატებითი ტესტები - აქ არ არის სიპ რეგისტრაცია. არის ქეიფები, არის საუბრები, არის ბრიჯები, მაგრამ რეგისტრაცია არ არის. რაღაც მომენტში ისიც ვიფიქრე, მართლა გვჭირდება თუ არა ულვაშის რეგისტრაცია?

სასაცილო დამთხვევით, ამ მომენტში მომხმარებლისგან კიდევ ერთი მოთხოვნა მოდის, გამავალი ზარების პრობლემა. პრობლემა ის იყო, რომ sip რეგისტრაცია იყინებოდა და მოგვარდა უბრალოდ მოდულის გადატვირთვით.

asterisk -rx "sip reload"

მშვენიერი იქნება AMI-ზე წვდომა ინტერნეტში: ეს გადაჭრის ყველა პრობლემას, ვფიქრობდი. მე ვიწყებ ამ მიმართულებით თხრას და ფაქტიურად პირველი საძიებო ხაზი მივყავართ ოფიციალურ Asterisk დოკუმენტაციამდე, რომელიც ამბობს, რომ არსებობს ჩემი ამოცანების ვარიანტი ვებ ჩართულია ფაილში /etc/asterisk/manager.conf, რომელიც უნდა დაყენდეს YES-ზე, განყოფილებაში [ზოგადი]

ამის შემდეგ, ფორმის რეგულარული ვებ მოთხოვნის საშუალებით http://ats:8089/mxml?action=SIPshowregistry ჩვენ ვიღებთ ყველა საჭირო ინფორმაციას.

FreePBX ინტერფეისის გამოყენებისას, თქვენ არ შეგიძლიათ ამ პარამეტრის ჩართვა ინტერნეტის საშუალებით; თქვენ უნდა ჩართოთ იგი კონსოლის მეშვეობით manager.conf ფაილში ცვლილებების შეტანით. FreePBX არ წაშლის მას, როდესაც კონფიგურაციის ცვლილებები ხდება ინტერნეტის საშუალებით.

მე დიდი ხნის განმავლობაში ვმუშაობდი Asterisk-ის სხვადასხვა სახის ინტეგრაციებთან, მაგრამ არსად მინახავს ეს ფუნქცია ნახსენები. გამიკვირდა, რომ არავინ აღწერს PBX-თან ურთიერთობის ამ მეთოდს. განსაკუთრებით სასარგებლო იყო ამ თემაზე ინფორმაციის მოძიება: პრაქტიკულად არაფერია ან გამოიყენებოდა სრულიად განსხვავებული ამოცანებისთვის.

WEB AMI - როგორი მხეცი?

ვარიანტის დამატება ვებ ჩართულია შეიტანოს მენეჯერი.conf უზრუნველყოფდა ATS მენეჯმენტზე სრულ წვდომას ინტერნეტის საშუალებით. ყველა ბრძანება, რომელიც ხელმისაწვდომია ჩვეულებრივი AMI-ის საშუალებით, ახლა არის ინტერნეტში, შეგიძლიათ მოუსმინოთ მოვლენებს PBX-დან სოკეტის საშუალებით. მოქმედების პრინციპი არაფრით განსხვავდება კონსოლის AMI-სგან. ამ პარამეტრის გააქტიურების შემდეგ შეგიძლიათ დაუკავშირდეთ 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>

პასუხში ბევრი ნაგავია, ამიტომ წინასწარ დამუშავებისას მას ვფილტრავთ შაბლონის მიხედვით XPath: //response/generic[@host]
შემდეგ იწყება გართობა. ამოცნობასთან მუშაობისთვის და ელემენტების დინამიურად შესაქმნელად, პასუხი უნდა იყოს JSON ფორმატში. XML არ არის მხარდაჭერილი ავტომატური აღმოჩენებისთვის.

XML JSON-ად გადასაყვანად მომიწია ცოტა ავტომატური ჩანაცვლებით თამაში, რისთვისაც JS-ში გავაკეთე სკრიპტი

საინტერესო პუნქტი: ATS პასუხში, ყველა პარამეტრი გარშემორტყმულია ერთი ბრჭყალებით და შაბლონის გამოყენების შემდეგ //response/generic[@host] ისინი შეიცვალა ორმაგი.

ელემენტების შესაქმნელად, ჩვენ ვიყენებთ ცვლადებს XML პასუხიდან (ახლა JSON).

SIP რეესტრი

Sip რეგისტრაციისთვის ჩვენ ვიყენებთ სამ ცვლადს: მომხმარებლის სახელი, მასპინძელი, პორტი. გამიხარდა ელემენტის სახელი [ელ.ფოსტით დაცულია]: 5060მე ვერ ვიპოვე სიტუაციები, სადაც ხუთივე ცვლადი უნდა გამოიყენოთ.

მთავარი ელემენტი, რომელიც იღებს ინფორმაციას ყველა რეგისტრაციის შესახებ, ვარსკვლავი - AMI SIP-ის ჩვენება რეესტრი. წუთში ერთხელ ის აკეთებს 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)

მეორე ელემენტისთვის გამოვიყენე JavaScript გამოსაყოფად რეაგირების დრო თანატოლების სტატუსიდან, რადგან ისინი ერთად ინახება:

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

დასკვნა

ყუთიდან გამოსული ხსნარი შეიძლება იყოს რთული და არა დაუყოვნებლივ გამჭვირვალე. ზრდის მოქნილობას და პორტაბელურობას სხვადასხვა სისტემებს შორის

ბედნიერი და მარტივი ინტეგრაცია ყველას! შაბლონი და დაყენების ინსტრუქციები GitHub.

წყარო: www.habr.com