Alpha.Community

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

Настройка сохранения истории

Настройка сохранения истории выполняется в среде разработки Alpha.DevStudio.

Чтобы настроить сохранение истории:

Порядок создания проекта и добавление Alpha.Server в проект описаны в документации на Alpha.DevStudio (раздел Знакомство с Alpha.DevStudio руководства пользователя).

Далее приведено описание настройки Alpha.Server для сохранения истории.

Добавление модуля истории

  1. Перейдите в Alpha.Domain → Узел Alpha.Domain и укажите IP-адрес Адаптера Ethernet, соответствующий IP-адресу компьютера, на котором функционирует Alpha.Server.

  2. Перейдите в Alpha.Server. По умолчанию в конфигурации Alpha.Server присутствует Модуль истории. Если конфигурация ранее была изменена и модуль отсутствует, то добавьте Модуль истории из папки Служебные модули.

    Для свойств модуля можно оставить значения по умолчанию.

Добавление сервера истории и настройка БД

В качестве сервера истории могут выступать: Alpha.Historian, MS SQL Server и PostgreSQL.

Перейдите в Узел Alpha.Domain и добавьте сервер истории из Панели элементов.

Alpha.Historian

Чтобы сохранять историю в БД Alpha.Historian:

  1. В Узел Alpha.Domain добавьте Alpha.Historian.

  2. Для свойств Alpha.Historian можно оставить значения по умолчанию.

    Свойство Описание
    Имя Имя Alpha.Historian в проекте.
    Имя экземпляра

    Имя, используемое для подключению к Alpha.Historian по DCOM. По умолчанию – Alpha.Historian.Server.

    TCP порт истории Порт, используемый для подключения к Alpha.Historian по TCP. По умолчанию – 4949.
    TCP порт мониторинга Порт, используемый для подключения к интерфейсу мониторинга Alpha.Historian. По умолчанию – 4600.

    TCP-порты подключения указаны в конфигурации Alpha.Historian в файле server.jsonc, расположенному по пути <домашняя папка Alpha.Historian>/.alpha.historian.server.

    TCP-порты подключения в конфигурации указаны в параметрах:

    • TCP порт истории - api/port;
    • TCP порт мониторинга - monitor/port.
    {
      "api":
      {
        "port": 4949,
        "idle_session":
        {
          "max_count": 0,
          "timeout": 0
        }
      },
      "monitor":
      {
        "port": 4600
      },
      "deprecated":
      {
      },
    }
  3. По умолчанию при добавлении Alpha.Historian уже содержит БД. Если требуется добавить новую БД или удалить лишнюю БД, то используйте соответствующие кнопки.

  4. Укажите параметры БД, в которую Модуль истории будет сохранять историю. На изображении ниже в свойстве Имя значение по умолчанию default изменено на Database.

    Свойство Описание
    Имя

    Имя БД в проекте.

    Тип использования

    Тип использования БД:

    • Для значений – сохранять только историю значений;
    • Для событий – сохранять только историю событий;
    • Для значений и событий – сохранять историю значений и событий;
    • Имитационные данные – сохранять имитационные данные.
  5. Перейдите в Alpha.Server и для Модуля истории укажите БД Alpha.Historian, в которую требуется сохранять данные.

  6. Выделите добавленную БД и настройте параметры связи модуля с базой данных сервера истории Alpha.Historian:

    Свойство Описание
    Общие
    Подключаться по DCOM

    Подключение к Alpha.Historian по DCOM:

    • Да – подключаться по DCOM;
    • Нет – подключаться по TCP.

    Подключение по DCOM невозможно, если Alpha.Server или Alpha.Historian установлены в ОС Linux.

    База данных Расположение БД в проекте.
    Параметры хранилища
    Каталог очереди данных

    Папка для размещения файлов очереди данных. Имя папки по умолчанию - Queues. Папка расположена по пути:

    • C:\Alpha.Server - в ОС Windows;
    • /opt/Alpha.Server - в ОС Linux.
    Короткое имя БД очереди Название хранилища очереди данных, может быть произвольным.
    Минимальный размер файла очереди, Мб Минимальный размер файла очереди данных. Значение по умолчанию – 1024 Мб.
    Режим работы с хранилищем

    Использовать хранилище для:

    • Чтение – только чтения истории;
    • Запись – только записи истории;
    • Чтение и запись – чтения и записи истории.

MS SQL Server

Установка MS SQL Server и настройка БД описаны в приложении.

Чтобы сохранять историю в БД MS SQL Server:

  1. В Узел Alpha.Domain добавьте Сервер истории Microsoft SQL Server.

  2. Для Сервера истории Microsoft SQL Server укажите значение свойства:

    Свойство Описание
    Имя Имя экземпляра Сервера истории Microsoft SQL Server.

  3. По умолчанию при добавлении Сервер истории Microsoft SQL Server уже содержит БД. Если требуется добавить новую БД или удалить лишнюю БД, то используйте соответствующие кнопки.

  4. Укажите параметры БД, в которую Модуль истории будет сохранять историю.

    Свойство Описание
    Тип использования

    Тип использования БД – Для значений.

    Сервер истории Microsoft SQL Server можно использовать только для сохранения истории значений.

    Имя Имя БД в проекте.
  5. Перейдите в Alpha.Server и для Модуля истории укажите БД MS SQL Server, в которую требуется сохранять данные.

  6. Выделите добавленную БД и настройте параметры связи модуля с базой данных сервера истории MS SQL Server:

    Свойство Описание
    Общие
    Имя пользователя

    Имя пользователя MS SQL Server для подключения к БД.

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

    Расположение очереди данных:

    • Оперативная – в оперативной памяти;
    • Файловая – в файле.

    Если выбрана Оперативная очередь данных, то при прекращении работы модуля данные в очереди будут потеряны без записи в БД.

    Путь до файла очереди данных

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

    Используется только если в параметре Очередь данных выбрано значение Файловая.

  7. В параметрах Модуля истории можно задать дополнительные параметры сохранения истории в MS SQL Server:

    Параметр Описание
    Количество значений в одной транзакции

    Количество значений, передаваемых в MS SQL Server в одной транзакции. При достижении указанного количества значений выполняется транзакция записи.

    Значение по умолчанию – 5000. Диапазон допустимых значений – от 1000 до 10000.

    Таймаут наполнения транзакции, мс

    Максимальное время накопления данных для выполнения транзакции записи в MS SQL Server. Новая транзакция записи выполнится по истечении указанного времени с предыдущей транзакции.

    Значение по умолчанию – 1000. Диапазон допустимых значений – от 500 до 5000.

PostgreSQL

Установка PostgreSQL и настройка БД описаны в приложении.

Чтобы сохранять историю в БД PostgreSQL:

  1. В Узел Alpha.Domain добавьте Сервер истории PostgreSQL.

  2. Для свойств Сервера истории PostgreSQL можно оставить значения по умолчанию.

    Свойство Описание
    Имя Имя Сервера истории PostgreSQL в проекте.
  3. По умолчанию при добавлении Сервер истории PostgreSQL уже содержит БД. Если требуется добавить новую БД или удалить лишнюю БД, то используйте соответствующие кнопки.

  4. Укажите параметры БД, в которую Модуль истории будет сохранять историю.

    Свойство Описание
    Тип использования

    Тип использования БД:

    • Для значений – сохранять только историю значений;
    • Для событий – сохранять только историю событий;
    • Для значений и событий – сохранять историю значений и событий;
    • Имитационные данные – сохранять имитационные данные.
    Имя Имя БД в проекте.
  5. Перейдите в Alpha.Server и для Модуля истории укажите БД PostgreSQL, в которую требуется сохранять данные.

  6. Выделите добавленную БД и настройте параметры связи модуля с базой данных сервера истории PostgreSQL.

    Свойство Описание
    Общие
    Имя источника данных (DSN)

    Имя системного источника данных, настроенного для подключения к БД PostgreSQL:

    Панель управления → Администрирование → Источники данных (ODBC), вкладка Системный DSN.

    Имя пользователя Имя пользователя PostgreSQL для подключения к БД.
    Пароль Пароль пользователя PostgreSQL для подключения к БД.
    База данных Расположение БД в проекте.
    Параметры хранилища
    Очередь данных

    Расположение очереди данных:

    • Оперативная – в оперативной памяти;
    • Файловая – в файле.

    Если выбрана Оперативная очередь данных, то при прекращении работы модуля данные в очереди будут потеряны без записи в БД.

    Путь до файла очереди

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

    Используется только если в параметре Очередь данных выбрано значение Файловая.

    Режим работы с хранилищем

    Использовать хранилище для:

    • Чтение – только чтения истории;
    • Запись – только записи истории;
    • Чтение и запись – чтения и записи истории.

Настройка сохранения истории

История значений

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

Для сохранения истории значений необходимо наличие в сервере истории БД с Типом использованияДля значений или Для значений и событий.

Чтобы Модуль истории сохранял историю значений в БД:

  1. Каждому сигналу, для которого требуется сохранять историю, на вкладке Настройка множеств:

    • укажите принадлежность множеству, установив флаг Множество исторических сигналов;
    • разрешите сохранение в БД, установив флаги Параметры сохранения в базу данных и Разрешить.

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

Сохранение истории в несколько БД

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

Чтобы настроить новое множество:

  1. Добавьте в проект Тип атрибута:

  2. Укажите значения свойств Типа атрибута:

    Свойство Значение
    Тип значения

    Тип значения атрибута: string.

    Название

    Название добавляемого множества сигналов.

    Описание

    Описание атрибута во всплывающей подсказке.

  3. Во вкладке Атрибуты вызовите контекстное меню и выберите пункт Добавить новые атрибуты.

  4. В появившемся окне выберите тип атрибута Множество сигналов.

Чтобы Модуль истории сохранял историю значений сигналов добавленного множества в БД:

  1. Перейдите в атрибуты БД Модуля истории.

  2. Во вкладке Атрибуты вызовите контекстное меню и выберите пункт Добавить новые атрибуты.

  3. В появившемся окне выберите добавленный ранее тип атрибута.

  4. Каждому сигналу, для которого требуется сохранять историю значений, на вкладке Настройка множеств:

    • укажите принадлежность множеству, установив флаг для нового добавленного множества;
    • разрешите сохранение в БД, установив флаги Параметры сохранения в базу данных и Разрешить.

История событий

Настройка сохранения истории событий не требуется. Все события сохраняются в историю.

Для сохранения истории событий необходимо наличие в сервере истории БД с Типом использования Для событий или Для значений и событий.

Дополнительные параметры сохранения истории

Дополнительные параметры сохранения истории можно задавать с помощью атрибутов. В приложении приведены описанные далее параметры и соответствующие им атрибуты.

Фильтрация значений сигнала при сохранении

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

Чтобы значения сигнала фильтровались при сохранении в историю, укажите требуемые параметры фильтрации:

Фильтр Описание
Мертвая зона

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

Мертвая зона, %

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

Минимальный интервал, мс

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

Допустимый диапазон значений от 0 до 60000 миллисекунд.

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

Фильтрация по зоне нечувствительности

Если заданы оба параметра фильтрации Мертвая зона и Мертвая зона, %, то значение сигнала проходит фильтр по зоне нечувствительности, если оно превысило наименьшее достаточное значение.

Текущее значение сигнала давления – 50 кПа. При этом заданы параметры фильтрации:

  • параметр Мертвая зона установлен в значение 20;
  • параметр Мертвая зона, % установлен в значение 10.

Фильтр по зоне нечувствительности будет пройден, если значение сигнала давления изменится более, чем на 5 кПа.

Фильтрация по интервалу времени

Если задан параметр фильтрации Минимальный интервал, мс и новое значение сигнал принял до истечения указанного интервала, то значение не сохраняется в историю. Однако, если сигнал не примет новое значение в следующие 60 секунд, то это значение будет сохранено в историю, как последнее актуальное.

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

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

Если флаг Сохранение значения с меткой времени сервера установлен, то при сохранении значения в историю метка времени источника будет заменена на текущее время Alpha.Server. Время Alpha.Server записывается в часовом поясе UTC+0.

Если флаг Сохранение значения с меткой времени сервера снят, то значение сохраняется с меткой времени источника.

Периодическое повторное сохранение последней записи сигнала

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

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

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

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

Повторное сохранение последней записи возможно только если для сигнала установлен флаг Сохранение значения с меткой времени сервера. Время Alpha.Server записывается в часовом поясе UTC+0.

Если задан Минимальный интервал, мс и Период повторного сохранения, сек меньше, чем Минимальный интервал, мс, то параметру Период повторного сохранения, сек присваивается значение параметра Минимальный интервал, мс.

Сохранение дополнительной метки времени сервера

Модуль истории позволяет сохранять в БД Alpha.Historian вместе с меткой времени источника дополнительную метку времени Alpha.Server.

Чтобы модуль сохранял в БД Alpha.Historian дополнительную метку времени Alpha.Server:

  1. В свойствах Модуля истории установите параметру Сохранять дополнительную метку времени сервера значение Да.

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

Запись значения при активации

Модуль истории при переходе в режим РАБОТА позволяет сохранять в историю последние значения сигналов, полученных в режиме РЕЗЕРВ. Под последними значениями подразумевается последнее значение для каждого сигнала, прошедшее фильтр.

Чтобы модуль сохранял последние значения при переходе в режим РАБОТА, в свойствах Модуля истории установите параметру Записывать значения при активации значение Да.

Применение конфигурации Alpha.Server

  1. Постройте решение. Конфигурация Alpha.Server будет построена.

  2. Перейдите в Мастер развёртывания.

    Для успешного применения построенных конфигураций должен быть настроен Alpha.Domain. Описание настройки приведено в документации на Alpha.Domain (см. раздел Конфигурирование руководства администратора).

  3. Примените конфигурацию к Alpha.Server.