Триггеры

Триггеры — это механизм анализа строк лога в Senta, позволяющий автоматически выполнять действия при обнаружении определённых условий.

Основное назначение триггеров — контроль состояния потока и автоматическая перезагрузка стрима при обнаружении проблем.

В системе предусмотрено два типа триггеров:

Статические
Динамические (кастомные)

Статические триггеры

Статические триггеры встроены в систему. В данный момент доступен один статический триггер — триггер анализа битрейта.

Статический триггер битрейта

Имеет фиксированный ID = 1
Предустановлен в системе
Нельзя удалить
Можно назначать и снимать с каналов

Принцип работы

Несмотря на название, триггер не анализирует и не сравнивает значения битрейта — он вообще не измеряет параметры потока какими-либо сторонними средствами (например, ffprobe). Единственный источник данных для него — текстовый вывод прогресса, который печатает сам процесс ffmpeg: триггер следит за полем time= в этом выводе (временная метка последнего обработанного кадра). Если эта метка перестаёт продвигаться от строки к строке лога — значит, ffmpeg завис, хотя процесс формально ещё работает, — и триггер расценивает это как зависание стрима.

В таком случае триггер автоматически выполняет перезагрузку стрима.

Как назначить статический триггер

Перейдите на страницу Триггеры
Выберите триггер Битрейт
В списке каналов отметьте галочками нужные каналы
Сохраните изменения

После этого выбранные каналы будут автоматически контролироваться по битрейту.

Динамические (кастомные) триггеры

Динамические триггеры позволяют создавать собственные правила анализа логов.

Система может:

искать вхождение подстроки в строке лога
проверять строку лога по регулярному выражению

При совпадении условия выполняется заданное действие (например, перезагрузка стрима).

Создание кастомного триггера

Чтобы создать новый триггер:

Перейдите на страницу Триггеры
Нажмите Добавить триггер
Укажите название триггера
При необходимости включите опцию Регулярное выражение
Введите текст для поиска в поле Сопоставление подстроки (или Регулярное выражение, если включили эту опцию выше — подпись поля меняется соответственно)
Сохраните триггер
Выберите список стримов, к которым нужно применить данный триггер

После сохранения триггер начнёт анализировать логи выбранных потоков.