Alpha.Community

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

Получение записей системного журнала

Для получения записей системного журнала используйте компонент Окружение: запрос системного журнала. Компонент поддерживает работу с журналами событий на разных платформах:

  • Windows — журнал событий (EventLog), включая стандартные журналы, такие как Application, Security, System и другие.
  • Linux — журнал systemd (journalctl, journald и другие инструменты)

Компонент Окружение: запрос системного журнала предоставляет следующие возможности:

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

    Режим Директория с файлами журналов не поддерживается в Windows.

  • Указание временных границ для выборки записей (свойства Начальное время и Конечное время).
  • Фильтрация записей с помощью фильтра в формате JSON (свойство Фильтр JSON).

Компонент Окружение: запрос системного журнала расположен в юните Окружение библиотеки компонентов. Экземпляр этого типа не отображается на форме и виден только в области Структура объекта.

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

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

Какие данные получает компонент

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

Идентификатор Описание Название столбца по умолчанию (если не заполнять свойство Заголовок для компонента Таблица: столбец)
source Источник события. Источник
timetamp Время генерации события. Время генерации
severity Уровень важности события. Важность
message Текст сообщения. Сообщение
pid Идентификатор процесса. Процесс
machine Имя машины. Машина

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

Как настроить отображение и фильтрацию событий системного журнала (Демо-проект)

Далее кратко описан пример (скачать его можно здесь) использования компонента Окружение: запрос системного журнала в проекте Alpha.HMI с использованием языка Alpha.Om.

Пример предназначен для операционной системы Windows. В примере демонстрируется работа с системным журналом Application — стандартным журналом событий в Windows, который содержит данные приложений и служб.

В примере показано, как:

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

Применение JSON-фильтра для выборки событий из Alpha.Server

Чтобы отобразить только события из источника Alpha.Server:

  1. Добавьте на форму таблицу для отображения данных.

  2. Добавьте компонент Таблица: модель данных дочерним компоненту Таблица.

  3. В редакторе свойств у объекта Таблица укажите ссылку на добавленный объект Таблица: модель данных. Для этого нажмите правой кнопкой мыши по свойству Модель данных → Сослаться→ TableModel_1.

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

  5. Настройте свойства для компонента Окружение: запрос системного журнала:

    • Журнал — Application (стандартный журнал событий Windows).

    • Вид журнала — Локальный в системе (используется журнал текущей ОС, а не внешний файл);
    • Фильтр JSON:

    • { "source": "Alpha.Server" }
  6. Добавьте компоненту Таблица дочерние компоненты Таблица: столбец с идентификаторами:

    • source;
    • message;
    • timestamp.

  7. Добавьте кнопку на форму и в свойстве Текст укажите Показать события.

  8. Настройте обработчик события ButtonPressed для этой кнопки, чтобы при нажатии запускался запрос данных из системного журнала Application. Пример кода:
    Table_1.TableModel_1.SystemLogQuery_1.Open(); // Запрашиваем данные с журнала
    Table_1.TableModel_1.BeginReadAsync(); // Заполняем таблицу полученными данными

Установка временных границ выборки

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

Для компонента Окружение: запрос системного журнала настройте свойства Начальное время и Конечное время.

  1. Для свойства Начальное время щёлкните правой кнопкой мыши → Задать формулу:

    DateTime.AddDays(DateTime.UtcNow(), -7) // Начало выборки: 7 дней назад
  2. Для свойства Конечное время щёлкните правой кнопкой мыши → Задать формулу:

    DateTime.UtcNow() // Конец выборки: текущее время

Отображение списка источников из журнала Application

Чтобы вывести список источников из журнала Application:

  1. Добавьте текстовое поле для вывода списка источников.
  2. Добавьте кнопку на форму и в свойстве Текст укажите Получить список источников.

  3. Настройте обработчик события ButtonPressed для этой кнопки, чтобы при нажатии отображался список источников в текстовом поле. Пример кода:
    Text_1.Text = Table_1.TableModel_1.SystemLogQuery_1.GetSourceListJson();