기본적으로 Zabbix를 Asterisk와 연결하는 방법

이전 기사에서 "Zabbix - 매크로 경계 확장" 인증 세션을 받아 로컬 호스트 매크로로 대체하는 방법을 알려드렸습니다. 이 기사에서는 외부 스크립트 및 소프트웨어 없이 Zabbix를 Asterisk와 연결하는 방법을 설명합니다.

이 두 시스템을 "친구로 만들"려는 아이디어는 추가 소프트웨어나 스크립트를 설치하지 않고 오래 전에 탄생했습니다. 빠른 인터넷 검색을 통해 가능한 많은 솔루션이 나왔고, 이는 모두 스크립트(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, ari가 무엇인지 알아내야 합니다.

• AGI - 다이얼플랜에서 스크립트를 사용합니다. 주로 통화 관리에 사용됩니다.
• AMI - 필요한 모든 정보를 제공할 수 있으며 Telnet과 유사하게 포트 5038을 통해 작동합니다. 우리에게 어울린다!
• ARI - 현대적이고 패셔너블한 JSON입니다. 많은 가능성이 있으며 Zabbix에서는 데이터 형식을 이해할 수 있지만 저에게는 중요한 것이 없습니다. Sip 등록을 제어할 수 없습니다. 또 다른 단점은 동료의 경우 온라인/오프라인 두 가지 상태만 있다는 점입니다. 하지만 더 많은 상태가 있어 진단 시 이를 고려하는 것이 유용합니다.
• SSH는 모든 작업을 수행할 수 있지만 "보안상의 이유로" 허용되지 않는 경우도 있습니다. 고려 사항은 다를 수 있으므로 다루지 않겠습니다.

그러나 모든 단점에도 불구하고 ARI는 모든 모니터링 요구 사항의 90%를 담당합니다.

Zabbix와 Telnet - 실망스럽습니다

저는 AMI를 잘 알고 있으며, 한때 원격 사무실별 부서와의 대화에서 손실 추적, 통화 관리 등을 구현했습니다. Telnet을 사용하면 모든 것이 매우 명확해집니다. 연결을 열고 명령을 보내고 응답을 읽는 것입니다. 그렇게 했는데 결과가 실망스럽네요.

Zabbix의 Telnet은 Linux 콘솔과 동일하지 않으며 로그인/비밀번호와 같은 표준 인증에 맞게 좀 더 간단하고 맞춤화되었습니다. 인증 로직이 다르고 로그인/비밀번호 쌍에 대한 요청이 없으면 오류가 발생합니다. 인증 요구 사항을 우회하려는 헛된 시도 후에 Telnet 모듈의 소스 코드를 살펴보는 것이 유용했습니다.

나는 전통적인 로그인과 비밀번호 요청이 있을 때까지 앞으로 나아갈 수 없다는 것을 깨달았습니다. 재미삼아 코드에서 인증과 관련된 모든 것을 제거하고 다시 조립했습니다. 공장! 그러나 요구 사항을 충족하지 않습니다. 계속하세요…

검색으로 돌아가자

ARI 문서를 다시 읽고 추가 테스트를 실행했습니다. 여기에는 SIP 등록이 없습니다. 잔치가 있고, 대화가 있고, 반바지가 있지만 등록은 없습니다. 어느 순간 독수리 등록이 꼭 필요한가 하는 생각까지 들었습니다.

우연의 일치로 이 순간 사용자로부터 발신 전화에 문제가 있는 또 다른 요청이 도착했습니다. 문제는 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 - 어떤 종류의 짐승인가?

옵션 추가 웹 지원 파일로 Manager.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: //응답/일반[@host]
그런 다음 재미가 시작됩니다. 감지 작업을 수행하고 요소를 동적으로 생성하려면 응답이 JSON 형식이어야 합니다. 자동 감지에는 XML이 지원되지 않습니다.

XML을 JSON으로 변환하려면 JS에서 스크립트를 만든 자동 교체를 약간 사용해야 했습니다.

흥미로운 점: ATS 응답에서 모든 매개변수는 작은따옴표로 묶여 있으며 템플릿을 적용한 후에는 //응답/일반[@host] 그들은 이중으로 대체됩니다.

요소를 생성하기 위해 XML 응답(현재 JSON)의 변수를 사용합니다.

SIP 레지스트리

Sip 등록에는 세 가지 변수를 사용합니다. 사용자 이름, 주인, 포트. 요소 이름이 마음에 들었습니다. [이메일 보호]: 5060, 다섯 가지 변수를 모두 사용해야 하는 상황은 찾지 못했습니다.

모든 등록에 대한 정보를 받는 주요 요소로, 별표 - AMI SIPshowregistry. XNUMX분에 한 번씩 GET 요청을 보냅니다. https://ats:8089/mxml?action=SIPshowregistry, 그 후에는 응답 XML 데이터가 구문 분석을 위해 모든 종속 요소에 전달됩니다. 각 등록에 대해 이에 종속되는 요소를 만듭니다. 각 요청에 대해 별도로 수신하는 것이 아니라 하나의 요청으로 최신 정보를 수신하므로 편리합니다. 이 구현에는 프로세서에 대한 부하라는 중요한 단점이 있습니다.

최대 100개의 종속 요소를 테스트할 때 로드를 발견하지 못했지만 1700개의 요소를 사용하면 프로세서에 눈에 띄는 15초 로드가 발생했습니다. 종속 요소가 많은 경우 이 점을 염두에 두십시오.

로드를 "확산"하거나 요소에 대해 서로 다른 폴링 빈도를 설정하는 옵션으로 처리 논리를 각 요소로 개별적으로 이동할 수 있습니다.

받은 정보를 기본 요소에 저장하지 않습니다. 첫째, 이것이 필요하지 않다고 생각하고, 둘째, 응답이 64K 이상이면 Zabbix가 이를 차단합니다.

종속 요소에 대해 전체 XML 응답을 사용하므로 전처리에서 이 요소의 값을 가져와야 합니다. 을 통해 xpath 그것은 다음과 같이 이루어졌습니다 :
문자열(//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가 있으며 여기에 종속 요소가 추가됩니다.

그러면 다음 두 가지 종속 요소가 생성됩니다.

• 텍스트 형식의 피어 상태
• 장치 응답 시간 - 상태가 OK이면 장치 응답 시간이 기록되고, 그렇지 않으면 “-1”입니다.

요소 자체에 대한 경로는 조금 더 간단합니다. xpath:

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

두 번째 요소의 경우 JavaScript를 사용하여 분리했습니다. 응답 시간 함께 저장되므로 피어 상태에서:

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

결론

기본 제공 솔루션은 복잡하고 즉시 명확하지 않을 수 있습니다. 서로 다른 시스템 간의 유연성과 이식성을 높입니다.

모두가 행복하고 쉽게 통합할 수 있습니다! 설정을 위한 템플릿 및 지침 GitHub의.

출처 : habr.com