Alpha.Community

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

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

Служебные сигналы

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

  • отслеживания объёма полученных и отправленных данных по каждому устройству;
  • контроля процента загрузки планировщика задач по каждому устройству;
  • контроля состояния связи и времени ответа для каждого устройства;
  • контроля и управления основными параметрами модуля.

Отслеживание объёма полученных и отправленных данных

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

Service.Modules.<Имя модуля>.<Имя источника>.<Имя устройства>.DataExchangeCounter.<Имя сигнала>

Служебные сигналы отслеживания объёма полученных и отправленных данных:

Сигнал Тип Описание сигнала
MinimumUpdatePeriod uint1 Текущий минимальный период обновления счётчика. Устанавливается путём записи значения в служебный сигнал MinimumUpdatePeriod.Set.
CountReceivedByte uint8

Количество байт, которое получено от устройства с момента последнего сброса счётчика.

Подсчёт байт ведется по всем запросам.

При достижении максимального значения с учётом размерности uint8 значение будет сброшено до 0.

CountSentByte uint8

Количество байт, которое отправлено на устройство с момента последнего сброса счётчика.

Подсчёт байт ведется по всем запросам.

При достижении максимального значения с учётом размерности uint8 значение будет сброшено до 0.

LastResetTimestampFiletime uint8

Метка времени последнего сброса счётчика в формате Filetime.

LastResetTimestampString string

Метка времени последнего сброса счётчика в формате string.

Reset bool

Команда сброса счётчика:

  • True - сбросить счётчик.

Контроль процента загрузки планировщика задач

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

Service.Modules.<Имя модуля>.<Имя источника>.<Имя устройства>.Planner.UsagePercentage

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

Процент загруженности планировщика запросов:

  • 0 - отправка запросов не выполняется;
  • 100 и более - возможны пропуски в получении каждого значения переменной (значения могут быть получены модулем реже, чем изменяются в ПЛК).

Если процент загруженности планировщика превышает 70-80%, то загруженность близка к пределу и могут начаться пропуски.

Контроль состояния связи и времени ответа устройства

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

Service.Modules.<Имя модуля>.<Имя источника>.<Имя устройства>.<Имя сигнала>

Служебные сигналы устройства:

Сигнал Тип Описание сигнала
LastReadException uint1 Код исключения при чтении данных контроллера. Описание исключения при чтении данных контроллера отображается в значении служебного сигнала LastReadException.Description.
LastWriteException uint1 Код исключения при записи данных в контроллер. Описание исключения при записи данных в контроллер отображается в значении служебного сигнала LastWriteException.Description.
ExpiredRequestsCount uint8

Количество запросов, превысивших интервал опроса.

IsAppLaunched bool

Состояние приложения, функционирующего в контроллере:

  • True – запущено;
  • False – не запущено.
IsConnected bool

Состояние связи с контроллером:

  • True – связь установлена;
  • False – связь отсутствует.
LastReadVariablesResponseTime uint8 Длительность последнего ответа контроллера на запрос чтения группы переменных (1Ah).
LastReadVariablesFromArchive ResponseTime uint8 Длительность последнего ответа контроллера на запрос чтения переменных HDA (36h).

Контроль и управление основными параметрами модуля

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

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

Параметры статистики

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

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

Параметры статистики модуля UNET Клиент:

Параметр Описание
Общие параметры:
Идентификатор модуля Идентификатор модуля в конфигурации Alpha.Server
Имя модуля Название модуля
Исполняемый файл

Имя исполняемого файла модуля в каталоге установки Alpha.Server

Версия

Версия модуля UNET Клиент

Активность

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

Вести журнал работы модуля

Ведение записи сообщений о работе модуля в журнал работы

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

Размер файла в мегабайтах для записи журнала работы модуля

Время старта

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

Лицензия Текущее состояние лицензирования модуля
Дополнительные параметры:
Общее количество обслуживаемых сигналов

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

Количество сигналов на запись

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

Количество сигналов типа Analog

Количество сигналов типа Analog, принятых на обслуживание модулем

Количество сигналов типа Byte

Количество сигналов типа Byte, принятых на обслуживание модулем

Количество сигналов типа Double

Количество сигналов типа Double, принятых на обслуживание модулем

Количество сигналов типа Bool Количество сигналов типа Bool, принятых на обслуживание модулем
Количество сигналов типа String Количество сигналов типа String, принятых на обслуживание модулем
Количество сигналов типа Bool_Q Количество сигналов типа Bool с качеством, принятых на обслуживание модулем
Количество сигналов типа Int_Q Количество сигналов типа Int с качеством, принятых на обслуживание модулем
Количество сигналов типа Byte_Q Количество сигналов типа Byte с качеством, принятых на обслуживание модулем
Количество сигналов типа Double_Q Количество сигналов типа Double с качеством, принятых на обслуживание модулем
Количество сигналов типа Real_Q Количество сигналов типа Real с качеством, принятых на обслуживание модулем

Параметры статистики источника:

Параметр Описание
Основные параметры:
Имя активного устройства

Имя контроллера в конфигурации, с которым модуль работает в данный момент времени

Фоновое восстановление:

Размер очереди запросов

Количество интервалов для считывания архивных данных контроллера

Прогресс восстановления (%)

Прогресс восстановления данных за время отсутствия связи с контроллером

Параметры статистики устройства:

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

Текущий режим работы контроллера

Время запуска устройства (по часам устройства) Время запуска контроллера
Время сервера (UTC)

Текущее время в Alpha.Server

Время устройства (UTC) Текущее время контроллера
Дельта времени Разницы времени между Alpha.Server и контроллером
Среднее время ответа устройства (мкс):
На чтение переменных

Среднее время ответа на запросы чтения значений переменных

На чтение переменных из архива

Среднее время на запросы чтения значений переменных с меткой времени

Запись:

Количество значений, ожидающих записи Количество значений в очереди на отправку в контроллер

Планировщик:

Использование (%)

Процент загруженности планировщика запросов

Журнал работы

Модуль UNET Клиент ведёт журнал работы, в который записывается информация о работе модуля и обмене данными с контроллером.

Чтобы модуль вёл журнал работы, в общих параметрах модуля установите параметру Вести журнал работы модуля значение Да или установите сервисному сигналу модуля FrameLogEnable.Set значение true.

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

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

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

Каждая запись журнала имеет порядковый номер, дату, время и описание. Записи исходящих и входящих кадров модуля дополнительно содержат имя устройства, название группы переменных и название выполняемой функции.

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

Индикация байт в поле побайтового представления кадра данных приведена в таблице:

Байт Цвет Описание
0 Голубой Стартовый байт – 0xB5
1 Голубой Версия протокола – 0x10
2, 3 Голубой Идентификатор пакета
4, 5 Светло-голубой Адрес модуля контроллера (0 – мастер-модуль)
6, 7 Светло-голубой Светло-голубой Размер информационного пакета
8 Светло-голубой Код функции
от 9 до N Светло-серый Данные (формат и длина зависит от кода функции)
N+1, N+2 Желтый Контрольная сумма

Данные кадров, занимающие более 1 байта, передаются в порядке от младшего байта к старшему. Например, идентификатор пакета имеет значение 31188, что соответствует шестнадцатиричному значению 79 D4, однако передаётся значение в обратном порядке D4 79 (см. байты 2 и 3).