wamazeka / yeastar-tg-zabbix

Template for monitoring SIM's in Yeastar TG gateways and balance checking on RU operators

yeastar-zabbix

Template for monitoring SIM's in Yeastar TG-series (TG200, TG400, TG800, TG1600) gateways and balance checking on RU operators

Main script and ideas from @AcidVenom More about in article on Habr

Make some comments in script and little remarks. For XML template add balance check & graphs for RU GSM operators.

Что отслеживает:

• ICMP пинг и отклик через присоединенный шаблон по умолчанию,
• Статус сим-карты в шлюзе (зарегистрирована, ошибка),
• Настройки регистрации в сети (смс-центр, оператор, роуминг, IMSI),
• Качество связи (уровень сигнала)
• Баланс средств на сим-карте (только для 4 российских операторов и второй ревизии железа)

Как работает:

После создания узла сети в Zabbix начинается мониторинг оборудования через ICMP пинг.

Далее, вступает в дело Discovery правило, по IP адресу и данным к API через внешний скрипт yeastar-discovery.sh происходит обращение к AMI Asterisk с помощью netcat, которая просто печатает запрос в порт. Возвращается JSON со списком портов.

Пример discovery ответа

{
"data": [
  {
    "{#ID}": "2",
    "{#NUM}": "1",
    "{#POWER}": "Power on",
    "{#STATUS}": "Up"
  },
  {
    "{#ID}": "3",
    "{#NUM}": "2",
    "{#POWER}": "Undetected SIM Card",
    "{#STATUS}": "Up"
  }
]
}

ID отличается от NUM т.к. внутренняя нумерация в Asterisk другая

Фильтр отбрасывает выключенные порты или где не обнаружена сим-карта. Итого, через LLD создаются элементы данных только для активных сим-карт. Периодически, как и любое LLD правило запускается вновь для обнаружения новых сим-карт в шлюзе.

Каждые 10-15 минут проверяется состояние обнаруженных симок через запрос состояния по каждому порту. Тоже через скрипт.

Пример ответа по конкретному порту

Asterisk Call Manager/1.1
Response: Success
Message: Authentication accepted

Response: Follows
Privilege: SMSCommand
D-channel: 2
Status: Power on, Provisioned, Up, Active,Standard
Type: CPE
Manufacturer: SIMCOM_Ltd
Model Name: SIMCOM_SIM800
Model IMEI: 894005028759112
Model CBAND:  EGSM_MODE,ALL_BAND
Revision: 1308B08SIM800M32
Network Name: Bee Line GSM
Network Status: Registered (Home network)
Signal Quality (0,31): 13
SIM IMSI: 251225532128772
SIM SMS Center Number: [phone]
Send SMS Center Number: Undefined
Last event: USSD received
State: READY
Last send AT: AT+CREG?\r\n--END COMMAND--

Response: Goodbye
Message: Thanks for all the fish.

В исходном шаблоне был лишь один активный элемент данных и зависимые от него, которые парсили нужные куски из текста. Добавлены в скрипт элементы с проверкой баланса, в шаблон тоже. Также, с запросом SMS на

Элемент для проверки баланса использует тот же самый запрос к внешнему скрипту по отдельному графику, выдирает из ответа номер СМС-центра, по которому можно однозначно определить оператора связи сим-карты и в скрипте выбирает USSD запрос для проверки баланса на сим-карте. Можно добавлять свои соответствия номера СМС центра и USSD для проверки баланса!

По данным строятся графики, установлены триггеры на падение баланса, в т.ч. на подозрительно большие списания, для проверки наличия ненужных платных услуг от оператора.

Using

1. Add yeastar-discovery.sh in /usr/lib/zabbix/externalscripts/
2. Import yeastar-zabbix-template.xml in Zabbix
3. Add template to host
4. Add macros {$TGAPI.PASS} and {$TGAPI.USER} to host
5. For balance checking add {$TGAPI.IP} to host (DEPRECATED)

TODO:

• add trunk names and numbers to Zabbix autofinding. Do it with SSH script or SSH agent (zbx) with

sqlite3 -csv /persistent/var/lib/asterisk/db/MyPBX.sqlite "select * from gsmtrunk;"

• Rework all autoprovision. Creation elements with number and long history, maybe only with numbers, for passtrhough history when changing port\gateway? Think, should to do all in SH script, not in XML JS ZBX script