Руководство пользователя

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

Главное окно программы

На скриншоте ниже представлено Главное окно программы "Система приёма данных - Панель управления":

Responsive image

Оконная форма содержит следующие элементы:

  1. Панель меню.
  2. Поля со списками служб находящихся в статусе сбой.
  3. Кнопка выхода.

Панель меню

Скриншот меню-панели
Содержит следующие элементы :

  • Службы приема
  • Службы ретрансляции
  • Дополнительные сервисы
  • Лог системы
  • Кнопка выхода

Лог системы

screen

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


Конец временного периода задаётся таким же образом.

Чтобы вывести на экран историю событий за выбранный период, нажмите кнопку "Запросить".

В поле Дата фиксируется время, когда свершилось событие. Дата выводится в формате "Год-Месяц-День Часы:Минуты:Секунды".

В поле Текст выводится информация о событии в формате "Название службы - название события".

Основные разделы

Рабочая область программы содержит три информационных страницы:

каждая из которых подробно рассмотрена ниже.

Приём данных

На данной странице можно увидеть такую информацию, как: Список баз данных, Состояние сервера SPD, таблицу с зарегистрированными службами приема.
Таблица содержит информацию обо всех зарегистрированных службах:


Поля таблицы:
  • Название сервера.
  • Название сервиса.
  • Порт, по которому осуществляется соединение.
  • Online. Количество объектов, использующих сервис в данный момент времени.
  • SMS. Включено ли sms-оповещение для данного сервиса.
  • Лог. Включено ли логирование для данного сервиса.
  • Статус. В каком состоянии находится сервис.


Кнопки управления службами:
  • Запуск/остановка службы
  • Перезапуск службы
  • Просмотр лога работы службы
  • Удаление службы приема

Установка новой службы

Нажатие кнопки открывает новое окно, в котором пользователю предлагается ввести:

  • Системное имя службы*
  • Имя службы*
  • Протокол*
  • Порт*
  • Назначение службы
  • Есть необходимость ведения логов (Да\Нет)
  • Использовать SMS-оповещение (Да\Нет)
  • Вносить в протоколирование дополнительную информацию (Да\Нет)



Поля, отмеченные * обязательны к заполнению!


После выбора протокола в поле "Описание протокола" можно прочитать дополнительную информацию о данном протоколе.

Для завершения операции добавления службы, необходимо нажать на кнопку "Сохранить".

Удаление службы

Для удаления сервиса из системы приёма данных, необходимо выбрать сервис из списка, и нажать на кнопку "Удалить".

Изменение службы

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

Лог службы

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




Таблица содержит поля:
  • Дата. Временная отметка события в формате "День.Месяц.Год Часы:Минуты:Секунды".
  • Хост. IP-адрес объекта.
  • Исходный ID. Идентификатор объекта, сообщившего о событии.
  • Изменённый ID Идентификатор объекта, присвоенный ему системой сбора данных.
  • Данные Содержание сообщения.

Ретрансляция

На данной вкладке отображается информация о зарегистрированных в системе серверах ретрансляции.


Таблица содержит следующие поля:
  • Название. В данном поле отображается имя службы.
  • Протокол. В данном поле отображается протокол ретрансляции.
  • Всего. В данном поле отображается общее количество зарегистрированных объектов.
  • Активных. В данном поле отображается количество объектов Online.
  • Неактивных. В данном поле отображается количество объектов Offline.
  • Порог. В данном поле отображается значение процентного соотношения Активных объектов к общему их количеству, при котором срабатывает SMS-оповещение.
  • SMS. В данном поле отображается, включено ли SMS-оповещение для данного сервиса.
  • Лог. В данном поле отображается, включено ли логирование для данного сервиса.
  • Статус. В данном поле отображается текущий статус сервиса.


Также в таблице расположены кнопки:

Список объектов


В данном окне можно указать перечень объектов, данные которых будут передаваться сервисом ретрансляции. Сервер не будет ретранслировать данные, если список пуст.

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

В случае успешного добавления, вы увидите в таблице новую запись. Если записей слишком много, для поиска конкретного объекта в списке можно воспользоваться соответствующим полем поиска. Введите ID объекта (любой из двух: в базе или для отправки) и таблица будет автоматически обновлена под условие поиска.

Поля таблицы содержат следующую информацию:
  1. Дата внесения. Сюда записывается время добавления объекта в список.
  2. ID в базе. Идентификатор объекта в оригинальной базе данных.
  3. ID для отправки. Идентификатор объекта в базе данных, куда производится ретрансляция.
  4. Последняя точка. Здесь пишется временная отметка последней отправленной точки.
  5. Отправлено точек. В данной ячейке отображается число точек, отправленных сервисом ретрансляции за последние 24 часа. Каждые 24 часа счётчик обнуляется.

Если вам необходимо прервать ретрансляцию данных об объекте, то этот объект должен быть удалён из списка объектов ретрансляции.


Чтобы удалить объект из списка, выделите запись в таблице, содержащую ID данного объекта, щелчком левой кнопки мыши либо при помощи поля поиска. Затем нажмите кнопку Удалить. Подтвердите своё действие нажатием кнопки "Да". После удаления объекта, соответствующая строка таблицы исчезнет и ретрансляция данных об объекте будет остановлена. Возобновить процесс ретрансляции можно, повторно добавив объект в список.

Добавление нового сервиса ретрансляции

В открывшемся окне необходимо указать параметры нового сервиса:


Список полей:
  • Системное имя службы*. Наименование сервиса, которое будет использоваться системой. Нельзя изменить в дальнейшем.
  • Имя службы*. Наименование сервиса, которое предоставляется пользователю при выводе информации.
  • Протокол*. В данном поле необходимо указать коммуникационный протокол, по котором производится передача данных от автотрекеров.
  • Сервер приёма*. Из выпадающего списка необходимо выбрать сервер, на который будет осуществляться ретрансляция.
  • Минимальный порог*. В данном поле необходимо указать минимально допустимое соотношение Активных объектов к Общему числу объектов (в процентах, %). В случаях, когда данное значение будет опускаться ниже указанного порогового, система будет выдавать оповещение.
  • Количество потоков*. В данном поле необходимо указать число потоков, создаваемых при передаче данных. Значение по-умолчанию - 3.
  • Лимит запроса в базу*. В данном поле пользователь может указать максимальное количество строк, которое сервис может запросить из базы данных.
  • Количество точек в одном пакете*. В данном поле пользователь может указать, какое количество точек, характеризующих навигационные координаты объекта, сервер будет помещать в единицу передачи данных (пакет).
  • Таймаут ответа*. В данном поле необходимо указать время ожидания ответа от сервера в секундах. Если время ожидания превысит указанное значение, произойдёт повторная отправка пакета.
  • ID последней точки. В данном поле можно указать Идентификационный номер точки, обозначающей географическое положение объекта, с которой сервер начнёт ретрансляцию. По-умолчанию значение - 0, то есть ретрансляция будет вестись с самой первой точки, имеющейся в базе данных.


Поля, отмеченные "*" обязательны для заполнения, иначе сервер ретрансляции не будет добавлен!

Также существует возможность управлять поведением сервера ретрансляции путём выставления флагов:
  • SMS-оповещение. Флаг установлен - сервер будет отправлять оповещение через SMS при превышении порогового значения неактивных объектов. Флаг снят - SMS-оповещение использоваться не будет.
  • Запись лога. Если флаг установлен - сервер будет вести записи обо всех событиях приёма-передачи данных с указанием источника и временной отметки. Флаг снят - записи вестись не будут.
  • Разрешить дублирование объектов. Если флаг установлен - сервер может создавать копии одного и того же объекта с разным ID. Флаг снят - каждый объект хранится в базе в единственном экземпляре.


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

Удаление сервиса ретрансляции

При нажатии на кнопку будет выполнено удаление сервиса ретрансляции.

Настройки

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

Учтите, что изменить системное имя службы невозможно, изменение таких параметров как "Сервер приёма" и "Лимит запроса в базу" требуют перезапуска службы, а параметр ID последней точки доступен для изменения только когда служба отключена (Статус: Остановлена). Причём требуется остановка не только сервиса ретрансляции, но и того сервиса приёма данных, с которого производится ретрансляция.

Дополнительные сервисы


Таблица содержит следующую информацию о дополнительных сервисах:
  • Название службы, указанное при регистрации.
  • Сведения о работе службы.
  • Статус службы.


Также в табличной части содержатся основные кнопки управления:
  • Запуск/Остановка - Запуск/Остановка выбранного сервиса.
  • Перезапуск- Перезапуск выбранного сервиса.
  • Удалить - Удаление выбранного сервиса.


  • Сервис резервного копирования осуществляет копирование таблиц records, obj, objgr, suser. Таблицы синхронизируются каждый час. Недостающие записи восстанавливаются, но избыточные записи не удаляются. Для осуществления резервного копирования необходимо указать ряд параметров:
    • Хост. IP-адрес либо DNS-имя сервера, на котором расположена база данных.
    • Порт. Номер сетевого порта, на котором работает база данных.
    • Логин. Имя пользователя для доступа к БД.
    • Пароль. Парольная информация для доступа к БД.
    • БД. Название базы данных.
    • Последний ID. Идентификационный номер записи, с которой начинается копирование.
    • Шаг. Число записей БД, обрабатываемых сервисом за раз.
    • Принцип присвоения ID. Новый ID - каждой скопированной записи будет присвоен новый идентификатор. Копировать ID - каждой скопированной записи будет присвоен ID такой же, как у оригинала.