Alpha.Community

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

Диагностика работы

Служебные сигналы соединения с БД Alpha.Historian

Модуль истории динамически создаёт служебные сигналы:

  • контроля связи с Alpha.Historian (при подключении по TCP);
  • блокировки регионов хранилища Alpha.Historian от удаления (при подключении по TCP);
  • контроля связи с БД Alpha.Historian (при подключении по DCOM).

Контроль связи с Alpha.Historian

При подключении к БД Alpha.Historian по TCP (рекомендуемое подключение) Модуль истории создаёт служебные сигналы контроля связи с Alpha.Historian.

Тег узла служебных сигналов контроля связи с Alpha.Historian имеет вид:

Service.Modules.<Имя модуля>.Storages.<Имя хранилища>.<Имя БД>

Сигнал Тип Описание сигнала
Connected

bool

Состояние сессии записи в БД Alpha.Historian:

  • True - есть открытая сессия;
  • False - нет открытой сессии.
Папка Queue
CurrentWriteQueueSize

double

Текущий размер данных, ожидающих сохранения на диск, кБ.

FileSize

uint8

Размер файла очереди данных, кБ.
NumCommittedRecords

uint8

Число записей в очереди, сохраненных на диск.
NumRecords

uint8

Число записей в очереди.
ShrinkBound

uint8

Минимальная граница, по которую файл журнала может быть усечён, кБ.
UsedSpace

uint8

Использованное пространство файла очереди, %.

Блокировка регионов хранилища Alpha.Historian от удаления

При подключении к БД Alpha.Historian по TCP Модуль истории позволяет сохранять блокировки временных интервалов на стороне БД Alpha.Historian:

  1. Модуль истории создаёт для каждой БД служебные сигналы, с помощью которых задаются свойства блокировки и подаётся команда записи.
  2. По команде записи блокировки Модуль истории считывает свойства блокировки из служебных сигналов и сохраняет запись о блокировке в файловую очередь.

  3. Запись о блокировке из файловой очереди сохраняется в БД Alpha.Historian.

Тег узла служебных сигналов имеет вид:

Service.Modules.<Имя модуля>.Storages.Historian.<Имя хранилища>.<Имя БД>.<IntervalLock>

Сигнал Тип Описание сигнала
Description

string

Описание создаваемой блокировки.

High

uint8

Верхняя граница блокируемого временного интервала в формате FILETIME по времени UTC.

LastError

string

Описание ошибки последней операции записи, если она была неуспешной.
LastResult

bool

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

  • True - запись блокировки выполнена успешно;
  • False - запись блокировки не выполнена.
Low

uint8

Нижняя граница блокируемого временного интервала в формате FILETIME по времени UTC.
WriteLock

bool

Команда:

  • True - запись блокировки.

Для подачи команды записи блокировки:

  1. Укажите значения свойств блокировки, задав значения служебных сигналов Description, Low, High.

  2. Cигналу WriteLock задайте значение True.

Контроль связи с БД Alpha.Historian

При подключении к БД Alpha.Historian по DCOM Модуль истории создаёт служебные сигналы контроля связи с БД.

Тег узла служебных сигналов контроля связи с БД имеет вид:

Service.Modules.<Имя модуля>.Storages.<Имя хранилища>.<Имя БД>.Channel <Номер канала>

Сигнал Тип Описание сигнала
ConnectionState

bool

Наличие связи по каналу:

  • True - связь по каналу установлена;
  • False - связь по каналу отсутствует.
Host

string

Имя хоста БД.

Служебные сигналы соединения с БД PostgreSQL или MS SQL Server

В зависимости от значения параметра хранилища Очередь данных Модуль истории динамически создаёт служебные сигналы контроля связи с БД PostgreSQL или MS SQL Server:

  • для оперативной очереди данных;
  • для файловой очереди данных.

Оперативная очередь данных

При подключении к БД PostgreSQL или MS SQL Server и значении Оперативная параметра хранилища Очередь данных Модуль истории создаёт служебные сигналы контроля связи с БД.

Тег узла служебных сигналов контроля связи с БД имеет вид:

Service.Modules.<Имя модуля>.Storages.<Имя БД>.Connections

При подключении к БД PostgreSQL папки Read, WriteEvents и WriteValues отображаются в дереве служебных сигналов в зависимости от настройки параметра хранилища Режим работы с хранилищем и параметра базы данных Тип использования.

Модуль истории может сохранять в БД MS SQL Server только историю значений, поэтому при подключении к БД MS SQL Server в дереве служебных сигналов отображается только папка WriteValues.

Чтение истории значений и событий - папка Read:

Сигнал Тип Описание сигнала
Connected

bool

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

  • True - связь установлена;
  • False - связь отсутствует.

Запись истории событий - папка WriteEvents:

Сигнал Тип Описание сигнала
Connected

bool

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

  • True - связь установлена;
  • False - связь отсутствует.
Папка Queue
UnprocessedItemsCount

uint8

Число записей в очереди.

Запись истории значений - папка WriteValues:

Сигнал Тип Описание сигнала
Connected

bool

Наличие связи по каналу при записи истории значений:

  • True - связь установлена;
  • False - связь отсутствует.
Папка Queue
UnprocessedItemsCount

uint8

Число записей в очереди.

Файловая очередь данных

При подключении к БД PostgreSQL или MS SQL Server и значении Файловая параметра хранилища Очередь данных Модуль истории создаёт служебные сигналы контроля связи с БД, аналогичные оперативной очереди данных. Отличается только содержимое папки WriteValues/Queue.

Сигнал Тип Описание сигнала
Папка Queue
CurrentWriteQueueSize

double

Текущий размер данных, ожидающих сохранения на диск, Кб.

NumCommittedRecords

uint8

Число записей в очереди, сохраненных на диск.
NumRecords

uint8

Число записей в очереди.

Служебные сигналы контроля и управления основными параметрами модуля

Полный тег стандартных служебных сигналов контроля и управления основными параметрами модуля имеет вид:

Service.Modules.<Имя модуля>

Сигнал Тип Описание сигнала

Active

Bool

Активность модуля:

  • True – запущен;
  • False – остановлен.

Соответствует значению параметра Активность. Управляется служебным сигналом Active.Set

FrameLogEnable

Bool

Ведение журнала работы:

  • True – ведется;
  • False – не ведётся.

Соответствует значению параметра Вести журнал работы модуля. Управляется служебным сигналом FrameLogEnable.Set

SystemLogTraceLevel

Uint4

Уровень детализации журнала работы:

  • 1 – Предупреждения и аварийные сообщения;
  • 2 – Информационные сообщения;
  • 3 – Отладочные сообщения.

Соответствует значению параметра Уровень трассировки в журнал приложений. Управляется служебным сигналом SystemLogTraceLevel.Set

Id String Идентификатор модуля в конфигурации Alpha.Server

Статистика

Статистическая информация о работе модуля отображается на вкладке Статистика сервисного приложения Конфигуратор, а также в сервисном приложении Статистика.

Чтобы просмотреть параметры статистики модуля, подключитесь к Alpha.Server и выберите модуль в дереве статистики.

Статистика модуля при сохранении данных в Alpha.Historian

Статистика модуля (в составе Alpha.Server):

Параметр Описание
Общие параметры
Идентификатор модуля Идентификатор модуля в конфигурации Alpha.Server.
Имя модуля Название модуля в конфигурации Alpha.Server.
Исполняемый файл Имя исполняемого файла модуля в каталоге установки Alpha.Server.
Версия Версия Модуля истории.
Активность Признак активности модуля (запущен или остановлен).
Вести журнал работы модуля Ведение журнала сообщений о работе модуля.
Уровень детализации журнала работы Типы сообщений, которые фиксируются в журнал приложений.
Предельный размер лога кадров Размер файла в мегабайтах для записи журнала работы модуля.
Время старта

Время запуска модуля.

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

Количество значений, принятых к сохранению в историю.

В параметре учитывается Количество повторно сохраненных записей и не учитываются Количество отброшенных фильтрами значений.

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

Статистика хранилища (в составе Alpha.Server):

Параметр Описание
Общие параметры
Псевдоним хранилища Название хранилища.
Короткое имя БД очереди Название хранилища очереди данных.
Каталог очереди данных Папка для размещения файлов очереди данных.

Статистика БД (в составе Alpha.Server):

Параметр Описание
Соединение
Количество открытых каналов Количество открытых каналов соединения с БД.
Состояние очереди записи
Число записей в очереди Количество значений в очереди.
Число записей в очереди, сохраненных на диск Количество значений очереди, сохраненных на диск.
Текущий размер данных, ожидающих сохранения на диск, Кб Общих размер данных в килобайтах, ожидающих сохранения на диск.
Размер файла очереди данных, Кб Максимальный размер файла очереди данных в килобайтах.
Использованное пространство файла очереди, % Процент использованного пространства файла очереди данных.
Минимальная граница, по которую файл журнала может быть усечён, Кб Размер файла журнала в килобайтах, до которого он может быть усечён.
Общие параметры
Короткое имя БД Имя БД в хранилище.
Имя экземпляра хранилища Название экземпляра хранилища.
Хост (имя машины) IP-адрес или сетевое имя компьютера с хранилищем.

Статистика хранилища (в составе Alpha.AccessPoint):

Параметр Описание
Соединение
Активная база База данных в составе хранилища, которая в текущий момент используется для чтения данных.
Общие параметры
Псевдоним хранилища Название хранилища.

Статистика БД (в составе Alpha.AccessPoint):

Параметр Описание
Соединение
Состояние соединения с Alpha.Historian.Server Текущее состояние соединения с хранилищем.
Сессия работы с БД
Состояние сессии Текущее состояние сессии работы с БД.
Общие параметры
Короткое имя БД Имя БД в хранилище.
Имя экземпляра хранилища Название экземпляра хранилища.
Хост (имя машины) IP-адрес или сетевое имя компьютера с хранилищем.

Статистика модуля при сохранении данных в PostgreSQL и MS SQL Server

Статистика модуля:

Параметр Описание
Дополнительные параметры
Размер буфера значений Максимальное количество значений в буфере.
Заполненность буфера значений, % Процент заполненности буфера значений.

Остальные параметры соответствуют параметрам статистики модуля при сохранении данных в Alpha.Historian.

Статистика БД:

Параметр Описание
Общие параметры
Расположение хранилица Имя компьютера, на котором расположено хранилище.
Соединение
Состояние Текущее состояние соединения с БД.
Ошибка соединения Текст ошибки соединения с БД.

Журнал работы модуля

Журнал работы модуля сохраняется в файл <имя модуля>.aplog по умолчанию:

  • в ОС Windows в папке C:\Program Files\Automiq\Alpha.Server\Logs;
  • в ОС семейства Linux в директории /opt/Automiq/Alpha.Server/Logs.

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