- PVSM.RU - https://www.pvsm.ru -
Zabbix – умный, гибкий, кастомизируемый – умеет все. Или почти все. Было бы странно, если бы он не мог подружиться с облачной телефонией, особенно когда у последней есть удобное HTTP API – пользуйся на здоровье. Сегодня мы наглядно покажем, как настроить Zabbix для звонков-уведомлений через Voximplant, что может быть очень кстати в экстренном случае («нет времени объяснять, нужно звонить – боевой сервер упал только что»).
За основу взят кадр из х/ф «Матрица» (The Matrix (1999), Warner Bros.)
Внимание: туториал подразумевает, что у вас уже есть работающий Zabbix и настроен Zabbix frontend. Первичная установка Zabbix не является целью этой статьи, любопытные/нуждающиеся в таком руководстве могут посмотреть официальную документацию [1] и/или погуглить.
В нашем примере используется
Никакого rocket science, сделаем очень простой мониторинг, который реагирует на появление файла /tmp/habrTriggerFile: когда такой файл появится, Zabbix обратится к Voximplant по HTTP API, сработает сценарий, который позвонит на указанный номер телефона, скажет «Внимание. На сервере был создан файл.» и положит трубку. Если удалить/переименовать файл, а потом вернуть его обратно, то снова будет звонок. Если ничего не делать, то будет только один звонок.
Зайдите в свой аккаунт [3] (или зарегистрируйтесь [4]) и создайте приложение [5] habr. Внутри приложения зайдите на вкладку Scenarios и создайте сценарий notification с таким кодом:
VoxEngine.addEventListener(AppEvents.Started, () => {
const call = VoxEngine.callPSTN("куда звоним", "ваш верифицированный номер телефона")
call.addEventListener(CallEvents.PlaybackFinished, () => {
VoxEngine.terminate()
})
call.addEventListener(CallEvents.Connected, () => {
setTimeout(
() => call.say("Внимание. На сервере был создан файл.", Language.RU_RUSSIAN_FEMALE),
1000
)
})
})
Этот сценарий можно запустить HTTP-запросом (и обойтись без покупки номера телефона). Не забудьте подставить в callPSTN номера телефонов: первый – кому будет звонить платформа, второй – это callerid, который высветится у вызываемого абонента; это может быть либо ваш личный номер, который прошел верификацию на платформе, или ранее купленный у Voximplant номер (внимание, виртуальные номера нельзя использовать). Сценарий звонит на номер, после соединения сообщает, что был создан файл и кладет трубку.
Сохраните сценарий и перейдите на вкладку Routing, чтобы создать правило:
Сохраните правило и – внимание – скопируйте его ID.
Далее вам понадобятся API keys, возьмите их в соответствующем разделе [6] главного меню.
Зная API keys и ID правила, вы можете подставить их в метод StartScenarios [7] нашего HTTP API, получится примерно так:
https://api.voximplant.com/platform_api/StartScenarios/?account_id=1&api_key=4ed5695e-4690-448r-95e8-3f8f0001287c&rule_id=28
Чуть позже мы используем этот запрос при настройке мониторинга, которую уже можно начинать.
Зайдите под своим пользователем (или под админом) в Zabbix frontend, далее в раздел Configuration – Hosts, нажмите Create host. В имени пропишите localhost, в groups укажите test group и нажмите внизу Add.
Теперь в списке хостов вы увидите как созданный по умолчанию Zabbix server, так и localhost. Отсюда же мы продолжим настройку.
Мониторинг Zabbix базируется на цепочке из 3 сущностей: Item – Trigger – Action. Все три звена – обязательные, поэтому необходимо последовательно создать каждое из них.
Item – это аккумулятор данных, а без данных мониторингу не на что будет реагировать. Чтобы создать Item, в списке хостов нажмите Items правее имени localhost. Также можно нажать на само имя хоста и на открывшемся экране перейти на вкладку Items – суть та же. Попав на вкладку Items, нажмите Create item в правом верхнем углу. Введите название – habr item, далее нажмите Add рядом с полем Key – листайте вниз, нам нужен стандартный ключ vfs.file.exists, выберите его и он подставится в поле Key. Замените file на актуальный путь, в нашем случае ключ получится таким: vfs.file.exists[/tmp/habrTriggerFile]. В поле Update interval поставьте 5s, чтобы мониторинг быстрее среагировал, когда мы создадим файл на хосте. Внизу страницы нажмите Add, и сразу же увидите новый item.
Триггеры оценивают собранные данные и при достижении указанного порога реагируют – запускают действие. Находясь на экране с созданным item, перейдите на вкладку Triggers:
Нажмите Create trigger, назовите его habr trigger. Значение для поля Expression удобно собрать с помощью конструктора – кнопка Add. Выставьте настройки как на скриншоте и кликните Insert:
Нажмите Add внизу страницы – готово, триггер создан.
Action – это действие, которое запускает сработавший триггер. Откройте вкладку Configuration – Actions, нажмите Create action. Название – внезапно – habr action. Ниже, в блоке New condition, оставьте все по умолчанию и допишите habr, в итоге получится условие Trigger name contains habr. Нажмите Add, чтобы добавить условие – оно тут же появится в блоке Conditions, см. скриншот:
Здесь же перейдите на вкладку Operations, затем в блоке Operations нажмите New, чтобы добавить действие. В Operation type выберите Remote command, появятся блок Target list и поле ввода Commands. В блоке Target list нажмите New, вам предложат цель по умолчанию – Current host, он-то вам и нужен – нажмите Add и цель появится в списке. В поле ввода вставьте curl + ранее сформированный запрос к Voximplant:
curl "https://api.voximplant.com/platform_api/StartScenarios/?account_id=1&api_key=4ed5695e-4690-448r-95e8-3f8f0001287c&rule_id=28"
Затем добавьте это действие (Add в виде ссылки), и только потом кликайте кнопку Add, чтобы завершить создание Action.
Важный момент: мы выбрали тип действия Remote command, который по умолчанию выключен в конфиге агента Zabbix. Чтобы исправить это, на хосте откройте конфиг и проставьте значение 1 для EnableRemoteCommands:
vi /etc/zabbix/zabbix_agentd.conf
// EnableRemoteCommands = 1
После этого перезапустите сервис агента:
service zabbix-agent restart
В панели Zabbix перейдите в раздел Monitoring – Problems. Скоро мы увидим здесь предупреждение, что сработал триггер.
На хосте создайте файл:
touch /tmp/habrTriggerFile
Через 5 секунд в панели Problems мы увидим новое сообщение; в столбце Status будет мигать PROBLEM, a если нажать на пиктограмму в столбце Actions, то будут видны подробности действия (скриншот кликабелен):
Попутно произойдет звонок на номер телефона, который мы указали в сценарии Voximplant.
За основу взят кадр из х/ф «Матрица» (The Matrix (1999), Warner Bros.)
Если переименовать файл,
mv /tmp/habrTriggerFile /tmp/habrTriggerFile_
то через 5 секунд статус проблемы станет RESOLVED.
Готово! Вы великолепны, потому что настроили цепочку взаимодействия хост–Zabbix–Voximplant и по тому же принципу можете настроить сколь угодно сложную логику для звонков-уведомлений.
Автор: nvpushkarskiy2
Источник [8]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/javascript/328815
Ссылки в тексте:
[1] официальную документацию: https://www.zabbix.com/documentation/4.2/manual/installation
[2] VDS: https://www.reg.ru/?rlink=reflink-717
[3] Зайдите в свой аккаунт: https://manage.voximplant.com/auth/
[4] зарегистрируйтесь: https://manage.voximplant.com/auth/sign_up
[5] приложение: https://manage.voximplant.com/applications
[6] в соответствующем разделе: https://manage.voximplant.com/settings/api_keys
[7] StartScenarios: https://voximplant.com/docs/references/httpapi/managing_scenarios#startscenarios
[8] Источник: https://habr.com/ru/post/465491/?utm_source=habrahabr&utm_medium=rss&utm_campaign=465491
Нажмите здесь для печати.