Zabbix をすぐに Asterisk に接続する方法

前回の記事で 「Zabbix - マクロ境界の拡大」 認証セッションを受信し、それをローカル ホスト マクロに置き換える方法を説明しました。 この記事では、外部スクリプトやソフトウェアを使用せずに Zabbix と Asterisk を接続する方法を説明します。

追加のソフトウェアやスクリプトをインストールせずに、これら XNUMX つのシステムを「友達にする」というアイデアはずっと前に生まれました。 簡単にグーグルで検索すると、考えられる解決策が数多く見つかりました。結局のところ、スクリプト (Pyha、Bash、Python など) をサーバーにアップロードするということになります。これで満足できるでしょう。 私は、外部スクリプトを使用せず、監視と PBX を備えたサーバーに追加のソフトウェアをインストールすることなく、「すぐに使える」監視を実装したいと考えていました。

これに合計 4 営業日を費やしましたが、結果はそれだけの価値がありました。 AMI インターフェイス、低レベル検出、トリガー、そして最も重要な PBX の接続とその他すべての設定の作業には、約 15 分かかります。

Zabbix 4.4 が利用可能で、Asterisk バージョン 100 が約 13 個あります。 一部の PBX には FreePBX Web インターフェイスが付属しており、一部の PBX には裸のコンソール、多くのトリックとダイヤルプランによる統合が付属しています。

PBXからデータを受信する

解決する必要がある最初の主要な点は、ピアと SIP 登録に関するデータを取得することです。 この目的のために、PBX には AGI、AMI、ARI、および SSH コンソール インターフェイスが備わっています。 明らかな理由から、追加のモジュールは考慮しませんでした。

まず、これらの agi、ami、ari が何であるかを理解する必要があります...

• AGI - ダイヤルプランでスクリプトを使用します。 主に通話管理に使用されます。
• AMI - 必要な情報をすべて提供でき、Telnet と同様にポート 5038 経由で動作します。 私たちに合ってます！
• ARI - モダンでファッショナブルな JSON。 多くの可能性があり、データ形式は Zabbix にとって理解可能ですが、私にとって重要なことはありません。SIP 登録を制御できないということです。 もう XNUMX つの欠点は、ピアにはオンライン/オフラインの XNUMX つの状態しかないことです。ただし、状態はさらに多く、診断時にそれらを考慮するのが有益です。
• SSH はすべてを実行できますが、「セキュリティ上の理由」により許可されない場合があります。 考慮事項は異なるかもしれませんが、ここでは触れません。

ただし、さまざまな欠点はありますが、ARI はすべての監視ニーズの 90% をカバーします。

Zabbix と Telnet - 残念です

私は AMI のことをよく知っており、かつてはリモート オフィスごとの部門との会話における損失の追跡、通話管理などを実装していました。 Telnet を使用すると、接続を開いてコマンドを送信し、応答を読み取るなど、すべてが非常に明確になります。 それが私がやったことですが、結果は私をがっかりさせました。

Zabbix の Telnet は Linux コンソールと同じではなく、少しシンプルで、ログイン/パスワードなどの標準的な認証に合わせて調整されています。 認可ロジックが異なり、ログイン/パスワードのペアの要求がない場合、エラーが発生します。 認可要件を回避しようとしても無駄でしたが、Telnet モジュールのソース コードを確認すると役に立ちました。

従来のログインとパスワードの要求が行われるまでは先に進めないことに気づきました。 楽しみのために、コードから認証に関連するものをすべて削除し、すべてを再構築してみました。 効く！ しかし、それは要件を満たしていません。 どうぞ…

検索に戻りましょう

ARI ドキュメントをもう一度読み直し、追加のテストを実行しました。ここには SIP 登録がありません。 祝宴があり、会話があり、ズボンが履かれていますが、登録はありません。 ある時点で、ハゲタカの登録は本当に必要なのかとさえ考えました。

面白い偶然ですが、この時点で、発信通話に問題がある別のリクエストがユーザーから届きました。 問題は、SIP 登録がフリーズすることであり、モジュールを再起動するだけで解決されました。

asterisk -rx "sip reload"

Web 経由で AMI にアクセスできたら素晴らしいでしょう。そうすればすべての問題が解決されると思いました。 この方向に調査を開始すると、文字通り検索の最初の行で公式の Asterisk ドキュメントにたどり着きます。そこには、私のタスクにオプションがあることが記載されています。 ウェブ化可能 ファイル内 /etc/アスタリスク/manager.confセクションで YES に設定する必要があります。 [全般的]

この後、フォームの通常の Web リクエストを通じて、 http://ats:8089/mxml?action=SIPshowregistry 必要な情報はすべて入手できます。

FreePBX インターフェイスを使用する場合、Web 経由でこのオプションを有効にすることはできません。manager.conf ファイルを変更して、コンソール経由で有効にする必要があります。 FreePBX は、Web 経由で設定変更が行われた場合でも、それを消去しません。

私は長い間さまざまな種類の Asterisk 統合に取り組んできましたが、この機能について言及されているのをどこにも見たことがありません。 PBX と対話するこの方法を誰も説明していないことに驚きました。 このトピックに関する情報を探すことは特に役に立ちました。事実上何もないか、まったく別のタスクに使用されていました。

WEB AMI - どんな獣ですか?

オプションの追加 ウェブ化可能 ファイルへ マネージャー.conf Web 経由で ATS 管理への完全なアクセスを提供しました。 通常の AMI を通じて使用できるすべてのコマンドは Web 上にあり、ソケット経由で PBX からのイベントをリッスンできます。 動作原理はコンソール AMI と変わりません。 このオプションを有効にすると、次のアドレスで PBX に連絡できます。

https://ats:8089/manager — リクエストをテストして手動で送信するためのシンプルなインターフェイスを備えた Web ページ。 すべての応答は、読み取り可能な HTML 形式でフォーマットされます。 モニタリングにはあまり適していません。
https://ats:8089/rawman — テキスト出力のみ、コンソール AMI と同様の形式
https://ats:8089/mxml - XML 形式のテキスト出力のみ。 私たちに合ってます！

そこで私はこう思いました。「これで解決だ！」 これですべての準備が整いました。 簡単にピージーなレモン絞り」、しかし喜ぶのはまだ早かった。 必要な情報を取得するには、必要なアクションを含む GET リクエストを使用するだけで十分です。 アクション、応答として、すべての登録とそのステータスのリストを含む xml が返されます。 これはすべて素晴らしいことですが、Cookie からセッションを記憶するには認証が必要です。 ブラウザでテストするときは、このプロセスについて考えません。

認可プロセス

まずは住所を指定します http://ats:8089/mxml?action=login&username=zabbix&secret=zabbix応答として、サーバーは認証セッションを含む Cookie を送信します。 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>

そこで働くために必要なのは マンセッションID="6f5de42c"、つまり認可 Cookie 自体です。
答えを確認するだけで十分な内容」認証が受け入れられました」 次に、PBX サーバーへのすべての呼び出しについて、リクエストに認証 Cookie を追加する必要があります。

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

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

認証 Cookie を取得して他のリクエストで使用する方法については、こちらをご覧ください。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 登録には XNUMX つの変数を使用します。 ユーザ名, host, ポート。 元素の名前に満足しました [メール保護]：5060, XNUMX つの変数すべてを使用する必要がある状況は見つかりませんでした。

すべての登録に関する情報を受け取るメイン要素、 アスタリスク - AMI SIPshowregistry。 XNUMX分にXNUMX回、GETリクエストを送信します。 https://ats:8089/mxml?action=SIPshowregistry、その後、応答 XML データが解析のためにすべての依存要素に渡されます。 登録ごとに、それに依存する要素を作成します。 これは、最新の情報をリクエストごとに個別に受け取るのではなく、XNUMX 回のリクエストで受け取るので便利です。 この実装には、プロセッサへの負荷という重大な欠点があります。

最大 100 個の依存要素をテストするときは負荷に気づきませんでしたが、1700 個の要素では、プロセッサに 15 秒の顕著な負荷がかかりました。 多数の依存要素がある場合は、このことに留意してください。

負荷を「分散」したり、要素に異なるポーリング頻度を設定したりするオプションとして、処理ロジックを各要素に個別に移動できます。

受け取った情報はmain要素には格納しません。 第一に、これの必要性がわかりません。第二に、応答が 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 という主要な要素があり、それに依存する要素が追加されます。

これにより、XNUMX つの依存要素が作成されます。

• テキスト形式のピアステータス
• デバイスの応答時間 - ステータスが OK の場合はデバイスの応答時間が書き込まれ、それ以外の場合は「-1」が書き込まれます。

要素自体へのパスは少し単純です XPath:

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

XNUMX 番目の要素では、JavaScript を使用して分離しました。 応答時間 それらは一緒に保存されるため、ピアステータスから次のようになります。

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

まとめ

すぐに使えるソリューションは複雑で、すぐには理解できない場合があります。 異なるシステム間の柔軟性と移植性が向上します。

皆さん、楽しく簡単に統合してください! テンプレートと設定手順 GitHubの.

出所： habr.com