Ограничение размеров журналов, логов и других файлов в ПО Альфа Платформа

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

В данной статье подробно рассмотрены механизмы ограничения размеров служебных файлов для ключевых компонентов Альфа Платформы: Alpha.Server, Alpha.Historian, Alpha.Domainи клиентских приложений.

1. Управление файлами в Alpha.Server

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

1.1. Ограничение журналов работы модулей

Каждый модуль (например, OPC DA Server, Syslog Server, Modbus TCP и др.) имеет индивидуальные настройки логирования. Параметры ограничения логов («Вести журнал работы модуля», «Размер журнала работы модуля, МБ», «Количество дополнительных журналов работы») настраиваются для каждого модуля индивидуально.

Где найти: в среде разработки Alpha.DevStudio или в сервисном приложении Конфигуратор. Они находятся в свойствах конкретного модуля в разделе «Параметры журналирования» или «Общие параметры».

Также текущие значения этих параметров можно просмотреть в любом клиенте OPC DA по тегам Service.Modules.<Имя модуля>.<Имя параметра> (например, FrameLogEnable или SystemLogTraceLevel).

Файлы сохраняются с расширением *.aplog в директории C:\Program Files\Automiq\Alpha.Server\Logs (для Windows) или /opt/Automiq/Alpha.Server/Logs (для Linux).

Для ограничения размеров этих файлов в настройках модуля предусмотрены следующие параметры:

• ›Вести журнал работы модуля: включает или отключает логирование («Да» / «Нет»).

• ›Размер журнала работы модуля, МБ: ограничивает размер одного файла лога. По умолчанию часто равен 10 МБ. При достижении этого лимита создается новый файл, а старый сохраняется как копия.

• ›Количество дополнительных журналов работы: устанавливает максимальное количество хранимых файлов (от 1 до 255). При превышении лимита самые старые файлы перезаписываются.

1.2. Резервные копии конфигураций

В данном разделе речь пойдёт о файле конфигурации сервера Alpha.Server.xml.
Путь для ОС Windows: C:\Program Files\Automiq\Alpha.Server\Server\Alpha.Server.xml.
Путь для ОС Linux: /opt/Automiq/Alpha.Server/Alpha.Server.xml.

В Alpha.Server встроен функционал по автоматическому созданию резервных копий текущих конфигураций. Процесс запускается после применения конфигурации и происходит по заданному расписанию (времени). Настройка времени создания и глубины хранения защищает диск от переполнения.

В файле за автоматическое резервное копирование отвечает специальный тег <Backup>, который содержит следующие атрибуты:

• ›Time — определяет точное время суток (например, Time="00:00"), когда Alpha.Server будет самостоятельно создавать резервную копию конфигурации.

• ›Path — указывает директорию, куда эти автоматически создаваемые копии будут сохраняться.

• ›StorageDepth — определяет длительность хранения бэкапов в сутках, чтобы защитить диск от переполнения (по умолчанию это 14 дней, а максимальное значение — 90).

Чтобы восстановить конфигурацию Alpha.Server из резервной копии:

• ›файлу резервной копии задайте имя, указанное в файле Alpha.Server.xml (в папке/директории установки Alpha.Server) в атрибуте Filename элемента <Storage> (по умолчанию AlphaServer.cfg);

• ›замените текущий файл конфигурации Alpha.Server.

1.3. Оперативная таблица событий (OAT)

Где найти: в Alpha.DevStudio или сервисном приложении Конфигуратор, в настройках модуля OPC AE Server, в группе свойств «Параметры оперативной таблицы событий».

Если используется модуль OPC AE Server, он сохраняет события в нативную оперативную таблицу (OAT). По умолчанию сервер резервирует 32 МБ, и при заполнении автоматически увеличивает объем еще на 32 МБ.

• ›Чтобы предотвратить переполнение диска, рекомендуется настраивать параметры Ограничение по давности цепей событий (в часах) и Ограничение по количеству цепей событий, которые автоматически удаляют неактивные цепочки из памяти.

2. Управление архивами в Alpha.Historian

Alpha.Historian отвечает за сбор и долговременное хранение истории параметров. Отсутствие лимитов на базы данных (БД) может привести к быстрому исчерпанию дискового пространства.

Файлы настроек баз данных истории (local.jsonc, db.jsonc) хранятся в подпапке alpha.historian.server/config внутри домашней папки базы данных. Расположение домашней папки по умолчанию:
ОС Windows: C:/Alpha.Historian/server_home.
ОС Linux: /var/lib/Alpha.Historian/server_home.

2.1. Базы данных формата 3x

Настройки осуществляются в файле local.jsonc (или старом Alpha.Historian.Server.xml):

• ›volume_limit (VolumeLimit): предельный объем базы данных в мегабайтах. При превышении предела запускается автоматическая очистка старых архивных данных (значение 0 — без ограничений).

• ›storage_depth (StorageDepth): максимальная глубина хранения в сутках. Данные старше указанного срока удаляются.

• ›active_storage_depth (ActiveStorageDepth): длительность хранения данных в активной (неархивированной) области в сутках.

2.2. Базы данных формата 4x

В новом формате БД параметры лимитирования также задаются в файле local.jsonc:

• ›max_data_size: предельный объем БД в мегабайтах. При превышении запускается очистка (удаление старых секций).

• ›max_depth: максимальная глубина хранения в сутках (записи с устаревшей меткой времени удаляются).

• ›volume_shrink_ratio: процент допустимого сокращения объема от предельного (например, на сколько процентов усечь базу при переполнении).

• ›Журнал транзакций (tx): имеет собственные настройки ограничений по минимальному и максимальному размеру (min/limit, max/limit) и поддерживает функцию автоматического усечения (shrink/auto).

3. Управление файлами агентов Alpha.Domain

Агенты Alpha.Domain хранят кэшированные конфигурации узлов. Для предотвращения их разрастания необходимо отредактировать конфигурационный файл alpha.domain.agent.xml.

Файл конфигурации агента домена alpha.domain.agent.xml находится в папке установки Alpha.Domain:
ОС Windows: C:\Program Files\Automiq\Alpha.Domain\alpha.domain.agent.xml.
ОС Linux: /opt/Automiq/Alpha.Domain/alpha.domain.agent.xml.

В секции <Component> конкретного агента доступны атрибуты:

• ›StorageLimitSize: ограничение на размер конфигурации в байтах. Если размер превышен, файлы удаляются (значение 0 отключает лимит).

• ›StorageLimitNum: максимальное количество хранимых конфигураций (копий). Старые удаляются при превышении лимита (значение 0 отключает функцию).

4. Ограничения в пользовательских интерфейсах (Alpha.HMI)

Для предотвращения зависания операторских интерфейсов (например, Alpha.HMI.Alarms) при огромном потоке тревог, вводится ограничение на отрисовку.

Параметр MaxVisibleOrdinaryEvents ограничивает количество строк в журнале событий, чтобы предотвратить перегрузку интерфейса:

• ›В приложении Alpha.Alarms: настраивается в графическом интерфейсе приложения, в окне «Параметры».

• ›В среде Alpha.HMI: задается в свойствах компонента интерфейса Alarms (свойство MaxVisibleOrdinaryEvents или OperativeVisibleRowCount). Диапазон значений — от 50 до 100 000.

При достижении максимума новые сообщения будут заменять в таблице наиболее старые. (Примечание: это не влияет на неквитированные особо важные события, они накапливаются до квитирования).

5. Системные журналы ОС Linux (Journald)

При работе компонентов Альфа платформы на ОС Linux (включая Astra Linux, РЕД ОС, Alt Linux), сообщения служб пишутся в системный журнал systemd — Journald.

Для ограничения размера журналов необходимо отредактировать файл /etc/systemd/journald.conf.

В секции [Journal] доступны две группы параметров: с префиксом System (применяются к файлам логов в постоянной памяти — /var/log/journal) и Runtime (применяются к логам в оперативной, энергозависимой памяти — /run/log/journal):

• ›SystemMaxUse и RuntimeMaxUse: задают максимальный объем дискового пространства, занимаемого журналом. По умолчанию это 10% от объема файловой системы, но не более 4 ГБ.

• ›SystemKeepFree и RuntimeKeepFree: указывают объем, который служба должна всегда оставлять свободным для нужд системы (по умолчанию 15%, но не более 4 ГБ). Система учитывает оба лимита (*MaxUse и *KeepFree) и руководствуется наименьшим из доступных значений.

• ›SystemMaxFileSize и RuntimeMaxFileSize: контролируют максимальный размер одного файла журнала до проведения ротации. По умолчанию это 1/8 от значения *MaxUse (или не более 4 ГБ в компактном режиме). Размеры можно задавать как в байтах, так и с использованием суффиксов (K, M, G, T).

• ›SystemMaxFiles и RuntimeMaxFiles: максимальное количество хранимых файлов (по умолчанию 100). При превышении лимита старые архивы удаляются, однако активные файлы не затрагиваются.

Чтобы применить ограничения, раскомментируйте требуемый параметр (удалите # в начале строки) и задайте новое значение. После редактирования файла обязательно перезапустите службу systemd-journald:

sudo systemctl restart systemd-journald.service

6. Управление журналами и лимиты в EventLogViewer

EventLogViewer позволяет управлять специальными журналами платформы и ограничивать их размер, а также лимитировать нагрузку на интерфейс самого приложения. Чтобы этот журнал не переполнил дисковое пространство ОС Windows, в настройках приложения (меню Настройки → Журнал платформы) предусмотрены следующие лимиты и политики ротации:

• ›Макс. размер журнала (КБ): позволяет задать жесткое ограничение на максимальный размер файла выделенного журнала в килобайтах.

• ›Политика при достижении максимального размера: определяет, что делать системе, когда лимит будет исчерпан. Доступно три варианта:

  • ›Переписывать события при необходимости (старые события автоматически удаляются, уступая место новым).

  • ›Архивировать журнал при заполнении (текущий файл архивируется, и начинается запись в новый).

  • ›Не переписывать события (запись новых событий останавливается до тех пор, пока администратор не очистит журнал вручную).

Итоговая схема