Веб-интерфейс устройства мониторинга¶

Table of contents
Веб-интерфейс устройства мониторинга

Назначение¶

Веб-интерфейс предназначен для управления устройствами мониторинга. Позволяет устанавливать параметры тюнеров (источники сигнала, качество и режим записи аудиоданных, период хранения аудиоданных и лог-файлов), а также прослушать и загрузить записанный аудиоматериал, слушать эфир, настраивать потоковое вещание в сети интернет для каждого канала.

Настройка¶

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

Учетная запись администратора:
login: admin
pass: changeme
Учетная запись пользователя:
login: user
pass: changeme

Чтобы сменить пароль учетной записи, необходимо подключиться к устройству ТР-707 по ssh и в консоле ввести команду:

sudo htpasswd -b /etc/fmtapper/users.pwd username password

Общее описание веб-интерфейса¶

В верхней части страниц веб-интерфейса всегда присутствует информационная строка.

Здесь содержатся следующие пункты:

Логотип "Тракт" — при нажатии загружается Стартовая страница.
Тюнеры — кнопка предназначена для перехода в раздел работы с тюнерами. Когда этот раздел активен, кнопка выделена зеленым цветом. При нажатии на нее загружается Стартовая страница.
Сервис — нажатие на кнопку позволяет перейти в раздел Сервис, где доступны три раздела: Настройки, Очистка и Логи. Кнопка при этом также выделяется зеленым цветом.
Id — идентификатор инсталляции, автоматически генерируемый скриптом установки fmtapper.
Время сервера — текущее время сервера.
Ntp сервис: активен — идентификатор активности Ntp сервиса. Если он не активен, надпись приобретает красный цвет.
Пользователь — логин пользователя.
Выйти — позволяет завершить сессию пользователя. После выхода можно авторизоваться под другим пользователем.

Далее содержимое страниц будет меняться в зависимости от выбранного раздела.

Стартовая страница¶

После авторизации будет загружена стартовая страница, отображающая текущее состояние тюнеров и загрузку системы.

Список тюнеров¶

Информация о текущем состоянии тюнеров представлена в виде таблицы со следующими столбцами:

Id — уникальный идентификатор тюнера.
Указывается вручную, может состоять из латинских букв, цифр и символа нижнего подчеркивания. ID задается один раз при создании и не может быть изменен в дальнейшем.
Имя — наименование тюнера, указывается произвольно.
Необходимо для удобного визуального именования тюнера. Может состоять из букв русского и латинского алфавита, цифр, символа нижнего подчеркивания, может содержать пробелы в имени.
Id канала - уникальный идентификатор канала записи.
Указывается вручную, может состоять из латинских букв, цифр и символа нижнего подчеркивания. Необходим для разделения записей из разных источников для одной радиостанции. Может быть изменен в дальнейшем.
Источник сигнала — тип источника сигнала. Возможны четыре варианта:
- Неуправляемое звуковое устройство — простая звуковая карта, без дополнительного тюнера. Она не настраивается;
- Управляемое звуковое устройство — внешнее звуковое USB-устройство (тюнер);
- Блок тюнеров — устройство, содержащие несколько FM-тюнеров (например, 4-х канальный FM-тюнер ТР-705);
- Интернет-радио — в качестве источника данных используется сервер интернет-вещания, например Icecast.

Частота FM — частота в FM диапазоне.

Трансляция — состояние трансляции сигнала в текущий момент. Возможны три значения:
- Включена — трансляция сигнала включена. При этом в разделе Основные настройки тюнера будет доступна функция прослушки;
- Выключена — трансляция сигнала выключена;
- Статус не известен — данное сообщение появляется, в случае, когда тюнер остановлен или произошла ошибка, из-за которой нельзя узнать состояние параметра.

Запись — состояние записи аудиоматериала в текущий момент. Возможны три значения:
- Активна — запись производится;
- Не активна — запись выключена;
- Статус не известен — данное сообщение появляется в случае, когда произошла ошибка, из-за которой нельзя узнать состояние параметра.

Режим записи — установленный режим записи аудиоматериала. Возможны два варианта:
- Фрагментами, Постоянно - запись фрагментов, указанных в Настройках записи;
- Фрагментами, Расписание - запись фрагментов, указанных в Настройках записи в соответствии с расписаниями;
- Непрерывно, Расписание - непрерывная запись аудио в один файл в соответствии с расписаниями;
- Непрерывно, Постоянно - непрерывная запись аудио в один файл.

Качество приема — здесь расположен индикатор уровня сигнала. Чем выше уровень сигнала, тем лучше качество. Значение отображается только для блока тюнеров.
SNR, MP - значения отношения сигнал/шум и Multipath. Чем больше значение сигнал/шум, тем более чистый звук принимает тюнер. Multipath - это величина многолучевого распространения, показывающая точность приема радиосигнала;
Pilot - наличие пилот-тона в сигнале;
Valid - показатель "валидности" сигнала: может ли данная частота быть автоматически определена радиоприемником при сканировании FM-диапазона;
Громкость — индикатор уровня громкости звука.
Статус — текущее состояние тюнера. Возможны три значения:
- Запущен — тюнер работает;
- Остановлен — работа тюнера остановлена пользователем;
- Ошибка — работа тюнера невозможна в результате ошибки.

Ошибка — здесь содержится информация об ошибках, из-за которых невозможен запуск тюнера или прекращена его работа.

Добавить тюнер можно с помощью кнопки Добавить тюнер, расположенной над списком.

Загрузка системы¶

Загрузка центрального процессора (CPU) и выделение оперативной памяти (RAM) показаны в виде графика: доля от общего объема (в процентах) относительно временной шкалы (в часах).

Информация о загрузке дисков представлена в виде таблицы, содержащей следующие столбцы:

Устройство — наименование устройства (раздела диска).
Точка монтирования — наименование каталога в файловой системе, в который монтируется раздел.
Всего, Гб — общий размер устройства, в гигабайтах.
Использовано, Гб — используемый объем, в гигабайтах.
Использовано, % — доля используемого объема, в процентах.

Профиль тюнера¶

Данная страница предназначена для настройки тюнера. Чтобы открыть ее, необходимо левой клавишей мыши выбрать соответствующий тюнер в столбце Id Списка тюнеров.

В верхней части страницы отображается текущее состояние выбранного тюнера:

Здесь содержится следующая информация:

Трансляция — состояние трансляции в текущий момент (Включена, Выключена, Статус не известен).
Запись — состояние записи аудиоматериала в текущий момент (Активна, Не активна, Статус не известен).
Режим записи — установленный режим записи аудиоматериала ("Фрагментами, Постоянно", "Фрагментами, Расписание", "Непрерывно, Расписание", "Непрерывно, Постоянно").
Громкость — индикатор уровня громкости звука.
Статус — текущее состояние тюнера (Запущен, Остановлен, Ошибка).
Ошибка — здесь содержится информация об ошибках, из-за которых невозможен запуск тюнера или прекращена его работа.

Далее располагаются разделы настроек. В нижней части страницы находятся кнопки:

Сохранить — сохранить изменения в настройках профиля тюнера.
Остановить — остановить тюнер.
Удалить — удалить профиль тюнера.

При изменении настроек может появится сообщение о необходимости перезагрузить сервис записи:

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

Экспорт/импорт конфигурации¶

Здесь реализована возможность сохранения настроек профиля тюнера в архив и восстановления их.

С помощью кнопки Обзор… можно загрузить архив (.zip) с файлами конфигурации. Кнопка Восстановить позволяет применить настройки из архива к текущему профилю тюнера.
Кнопка Сохранить — сохраняет настройки профиля тюнера в архив (.zip).

Основные настройки¶

Id — серийный номер тюнера. Вводится только один раз и не может измениться в дальнейшем.
Имя — любое пользовательское название радиостанции.
Id канала — идентификатор канала, позволяющий в общем потоке выделить индивидуальный аудиотрафик приемника.

Вещание¶

Тип сервера — здесь в раскрывающемся списке надо выбрать тип сервера:
- ffserver — потоковый сервер для видео и радиовещания, поддерживающий несколько каналов данных;
- Icecast — потоковый медиасервер, который поддерживает Ogg (Vorbis и Theora), Opus, WebM и MP3 аудиопотоки.
URL трансляции — URL-адрес трансляции.
Слушать — здесь располагается плеер, позволяющий прослушать транслируемый сигнал. Если трансляция не включена, данный пункт отсутствует.
Выключить трансляцию — остановить трансляцию.

Настройки IceCast¶

Данный раздел настроек появится в случае, если в пункте Тип сервера вещания выбран IceCast.

URL трансляции — URL-адрес трансляции.
URL потока — URL-адрес потока.
Тип контента — здесь указывается информация, характеризующая содержимое потока. Значение определяется пользователем. Обязательно для заполнения.
Имя стрима — любое пользовательское наименование потока.
Жанр стрима — жанр радио (любое пользовательское наименование).
Описание стрима — любое пользовательское описание, которое затем будет отображаться на странице каталога IceCast-сервера.
User-agent — наименование подключаемой программы для ее идентификации. В данном случае — FMtapper 1.3.
Публичный стрим — если флажок установлен, то стрим будет отображаться в каталоге IceCast-сервера.
IceCast версии < 2.4 — здесь необходимо установить флажок, если используется более ранняя версия Icecast-сервера, чем 2.4.
Пароль — пароль на подключение для трансляции через Icecast-сервер. Пароль задаётся администратором IceCast сервера. Если он неправильный, то трансляция звука через сервер будет невозможна. Это поле обязательно для заполнения.

Настройка локального ffserver¶

Данный раздел настроек появится в случае, если в пункте Тип сервера вещания выбран ffserver.
Предназначен для организации локальной подслушки принимаемого тюнером сигнала. В базовой конфигурации система рассчитана на 6 каналов трансляции.

URL трансляции - http://localhost:8090/feed[1-6].ffm
где [1-6] - указывается номер потока, на который будет настроена трансляция
пример итоговой URL: http://localhost:8090/feed6.ffm

Источник сигнала¶

Параметры источника сигнала будут различаться в зависимости от того, какое используется устройство — Неуправляемое звуковое устройство, Управляемое звуковое устройство, Интернет-радио или Блок тюнеров.

Настройки источника сигнала Неуправляемого звукового устройства будут выглядеть так:

Здесь три параметра:

Тип устройства — в раскрывающемся списке выбирается тип используемого устройства, в данном случае — Неуправляемое звуковое устройство.
Имя — в раскрывающемся списке выбирается нужное устройство. Обязательно для заполнения.
Частота дискретизации — частота дискретизации устройства, Гц.

Настройки источника сигнала Управляемого звукового устройства будут выглядеть так:

Здесь четыре параметра:

Тип устройства — в раскрывающемся списке выбирается тип используемого устройства, в данном случае — Управляемое звуковое устройство.
Имя — в раскрывающемся списке выбирается нужное устройство, обязательно для заполнения.
Частота дискретизации — частота дискретизации устройства, Гц.
Частота FM-диапазона — частота в FM-диапазоне.

Настройки источника сигнала для Блока тюнеров следующие:

Тип устройства — в раскрывающемся списке выбирается тип используемого устройства: Блок тюнеров.
Хост — IP-адрес устройства (источника сигнала).
Частота FM-диапазона — частота в FM-диапазоне.
Частота дискретизации тюнера — частота дискретизации тюнера, Гц.

Настройка источника сигнала Интернет-радио будет выглядеть таким образом:

Здесь всего два параметра:

Тип устройства — в раскрывающемся списке выбирается тип используемого устройства, в данном случае — Интернет-радио.
URL потока — URL-адрес потока.

Настройки записи¶

Здесь настраиваются параметры записи аудиоданных с тюнера.

Битрейт выходного потока — битрейт потока данных (Кбит/с).
Частота дискретизации — частота дискретизации для записываемых аудиофайлов, Гц.
Моно — установленный в данном пункте флажок позволит произвести одноканальное кодирование.
Маска файла — здесь указывается маска пути записи файлов относительно каталога хранения файлов данного тюнера, задается автоматически.
Длина интервала — для режима записи фрагментами здесь указывается длина интервала между записями, в секундах.
Длина фрагмента — для режима записи фрагментами здесь указывается длительность записываемого фрагмента (в секундах). Для записи всего интервала, необходимо указать длительность фрагмента такой же, как длительность интервала.
Расписание — установленный здесь флажок позволит производить запись аудиоданных согласно расписанию.
Окно громкости — здесь задается интервал в секундах, на котором вычисляется уровень громкости для отображения в таблице списка тюнеров.

> Примечание 1. Режим записи фрагментами будет установлен только, если указаны оба параметра — и длина интервала, и длина фрагмента. Иначе запись будет происходить непрерывно.
> Запись всегда ведется от начала часа. После включения тюнера, первая запись начнется сразу, а все последующие будут скорректированы системой.
> Длина интервала указывает, через какое время система должна начать запись следующего фрагмента. Длина фрагмента указывает, сколько времени система будет записывать принимаемый сигнал.
> Пример: длина интервала - 1800, длина фрагмента - 600, система будет записывать эфир кусочками по 10 минут через каждые полчаса - 12:00:00-12:10:00, 12:30:00-12:40:00 и т.д.

> Примечание 2. Маска файла указывается для автоматической ротации записей. Доступные переменные и их назначение на примере маски /home/support/media/{{channel}}/{{year}}_{{month}}_{{day}}/{{hour}}_{{minute}}_{{second}}.mp3
> * notextile>{{channel}} - переменная возвращает Id канала, указанного для тюнера
> * notextile>{{year}} - переменная возвращает текущий год в формате "yyyy" (например: 2017)
> * notextile>{{month}} - переменная возвращает текущий месяц в формате "mm" (например: 01)
> * notextile>{{day}} - переменная возвращает текущий день в формате "dd" (например: 31)
> * notextile>{{hour}} - переменная возвращает текущий час в формате "HH" (например: 14)
> * notextile>{{minute}} - переменная возвращает текущую минуту в формате "MM" (например: 35)
> * notextile>{{second}} - переменная возвращает текущую секунду в формате "SS" (например: 59)

Настройки сервиса очистки¶

Время хранения аудиоматериалов — максимальное время хранения записанных аудиоданных (сутки, часы, минуты). Обязательно для заполнения.
Время хранения логов, сутки — максимальное время хранения лог-файлов (сутки).

Загрузка на сервер¶

Адрес удалённого хранилища - URL-адрес хранилища с указанием папки для хранения данных тюнера.
Имя пользователя - пользователь удаленного хранилища.
Пароль - пароль для доступа к удаленному хранилищу.
Загружать метаданные - установленный в данном пункте флажок позволит загружать метаданные (json файлы).
Интервал закачки - указывается время, через которые будет осуществлена передача данных в хранилище. Интервал указывается в формате ДД:ЧЧ:ММ.
Статус - отображение текущего состояния загрузки. Подробности загрузки можно посмотреть в логах.

Расписания¶

Данный раздел предназначен для создания и редактирования расписаний записи аудиофайлов.

Можно сформировать расписание, которое будет действовать По умолчанию, а также Расписания по дням недели или Расписания по датам. Для этого достаточно добавить временные интервалы (часы, минуты, секунды), во время которых будет производится запись аудиоданных.

> Примечание. Название расписания будет устанавливаться автоматически и соответствовать времени действия: "Расписание по умолчанию" будет наименоваться "default", "Расписание по дням недели" — "monday", "tuesday" и т.д., "Расписание по датам" — "год-месяц-день".

Аудио¶

Данная страница содержит список записанных аудиофайлов выбранного тюнера. Для того, чтобы открыть страницу, надо в списке тюнеров выбрать нужный профиль, а затем нажать кнопку Аудио.

Список содержит следующую информацию:

Имя — наименование файла или папки.
Размер, байт — размер файла, в байтах.
Изменен — дата и время изменения файла (год, месяц, день и часы, минуты, секунды).

Сразу после перехода на страницу в списке отображаются папки, содержащие записанные аудиофайлы. Название каждой папки — это дата записи (год, месяц, день).

Для просмотра списка файлов достаточно один раз нажать левой клавишей мыши по названию папки.

С помощью встроенного плеера любой файл из списка можно прослушать, а также скачать, нажав кнопку .
Чтобы вернуться к списку папок, надо нажать мышью на родительский каталог .

Логи¶

Данная страница содержит список лог-файлов текущего профиля тюнера. Чтобы перейти на нее, надо сначала выбрать в списке тюнеров нужный профиль, а затем нажать кнопку Логи.

Список содержит следующую информацию:

Имя — наименование файла.
Размер, байт — размер файла, в байтах.
Изменен — дата и время изменения файла (год, месяц, день и часы, минуты, секунды).

Лог-файлы списка можно просматривать или загружать с помощью кнопки Скачать .

Меню Сервис¶

Меню Сервис предназначено для корректировки настроек устройства, удаления старого аудиоматериала и просмотра лог-файлов. Для того, чтобы перейти в раздел Сервис, необходимо нажать на соответствующую кнопку, расположенную в верхней части страницы:

В открывшемся разделе три части: Настройки, Очистка и Логи

Настройки устройства¶

На этой вкладке можно выбрать используемый сетевой интерфейс и поменять его настройки, выбрать диапазон UDP-портов для блока тюнеров, а также отправить устройство на перезагрузку.

Настройка сервиса очистки¶

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

Время хранения логов сервиса очистки, сутки — период хранения лог-файлов сервиса очистки, в сутках.
Максимальный объем логов тюнеров, MB — максимально допустимый объем лог-файлов для всех тюнеров, Мегабайт. Если суммарный объём файлов превысит указанное здесь значение, наиболее старые файлы буду удалены, а в лог-файлы будет выведено предупреждение.
Максимальный объем аудиоматериалов, MB — максимально допустимый объем аудиофайлов для всех тюнеров, Мегабайт. Если суммарный объём файлов превысит указанное здесь значение, наиболее старые файлы буду удалены, а в лог-файлы будет выведено предупреждение.
Интервал проверки — период проверки суммарного объема аудиофайлов (часы, минуты, секунды).

Лог-файлы сервиса очистки¶

Логи записываются в отдельных файлах каждый день. Файл лога именуется в формате cleanup.log.ГГГГ-ММ-ДД. Список лог-файлов содержит следующие столбцы:

Имя — наименование файла;
Размер, байт — размер файла, в байтах;
Изменен — дата и время изменения файла (год, месяц, день и часы, минуты, секунды).