Alpha.Community

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

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString (SW_1.Length);

Индекс

int8 Index

Индекс элемента в массиве. Позволяет отследить у какого элемента сработало то или иное событие.

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле индекс элемента массива, у которого сработало событие изменения значения.

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

В зависимости от индекса элемента в массиве вывести в текстовое поле запись о включении соответствующего режима работы задвижки.

if (SW_1.Mode.Index == 0)
ㅤ TextEdit_1.Text = "Включен режим 1";
else
ㅤTextEdit_1.Text = "Включен режим 2";

Журнал

string Log

Имя или путь к журналу в зависимости от значения свойства Вид журнала.

  • Если Вид журнала задан как Локальный в системе:

    • Для Windows в свойстве Журнал укажите имя журнала, например Application или System (доступные имена зависят от системы).
    • Для Linux оставьте свойство Журнал пустым, так как используется системный журнал systemd без указания имени.
  • Если Вид журнала задан как Файл с сохранённым журналом, укажите полный путь к файлу журнала, например, C:\Logs\system.evtx (Windows) или /var/log/journal/system.journal (Linux).
  • Если Вид журнала задан как Директория с файлами журналов, укажите полный путь к директории, например, /var/log/journal (только для Linux, в Windows не поддерживается).

Примеры

Задать файл с сохранённым журналом для Windows:

// Задаём журнал как файл с сохранёнными записями (под Windows – .evtx)
SystemLogQuery.Log = "C:\\Logs\\system.evtx";

Задать директорию с файлами журналов в Linux:

// Задаём журнал как директорию с файлами журналов (под Linux)
SystemLogQuery.Log = "/var/log/journal";

Задать локальный журнал в системе для Linux:

// Задаём локальный журнал в системе для Linux (systemd)
SystemLogQuery.Log = "";

Вид журнала

uint1 LogKind

Вид открываемого журнала.

Значение

0

Локальный в системе — используется системный журнал текущей ОС.

  • Для Windows: в свойстве Журнал укажите имя журнала, например Application или System (доступные имена зависят от системы).
  • Для Linux: оставьте свойство Журнал пустым.
1

Файл с сохранённым журналом — чтение из отдельного файла журнала.

В свойстве Журнал укажите полный путь к файлу журнала (в Windows — файлы *.evtx, в Linux — файлы *.journal).

2

Директория с файлами журналов — чтение из каталога, содержащего журнальные файлы.

В свойстве Журнал укажите путь к каталогу, содержащему журнальные файлы.

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

Примеры

Задать локальный журнал по имени:

// Задаём вид журнала "Локальный в системе" и указываем имя журнала
SystemLogQuery.LogKind = 0; // Локальный журнал
SystemLogQuery.Log = "System"; // Указываем имя журнала

Задать журнал как файл с сохранёнными записями:

// Задаём вид журнала "Файл с сохранённым журналом" и указываем полный путь к файлу
SystemLogQuery.LogKind = 1; // Файл с сохранённым журналом
SystemLogQuery.Log = "C:\Logs\system.evtx"; // Указываем полный путь к файлу журнала

Начальное время

timestamp Since

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

Примеры

Установить начальное время на 12 марта 2025 г. 00:00:00 UTC в виде метки времени:

// Задаем начальное время вручную в виде метки времени
SystemLogQuery.Since = 133862112000000000;

Установить начальное время на 12 марта 2025 г. 00:00:00 UTC, преобразовав стандартную дату в метку времени с помощью функции DateTime.Create():

// Задаем начальное время с конвертацией: 12 марта 2025 г. 00:00:00 UTC
SystemLogQuery.Since = DateTime.Create(2025, 3, 12, 0, 0, 0);

Конечное время

timestamp Until

Конечная временная граница читаемого среза журнала. Записи, зарегистрированные после указанного времени, не будут включены в выборку. Значение 0 трактуется как отсутствие конечной границы.

Примеры

Установить конечное время на 13 марта 2025 г. 00:00:00 UTC в виде метки времени:

// Задаем конечное время вручную в виде метки времени
SystemLogQuery.Until = 133862976000000000;

Установить конечное время на 13 марта 2025 г. 00:00:00 UTC, преобразовав стандартную дату в метку времени с помощью функции DateTime.Create():

// Задаем конечное время с конвертацией: 13 марта 2025 г. 00:00:00 UTC
SystemLogQuery.Until = DateTime.Create(2025, 3, 13, 0, 0, 0);

Фильтр JSON

string JsonFilter

Фильтрующее выражение в формате JSON для отбора записей журнала.

Фильтрация возможна только для столбцов с идентификаторами (переменными): source, timestamp, severity, message, pid и machine.

Условие фильтрации представляет собой одиночный ({"ключ": "значение"}) или составной (состоящий из нескольких объектов) объект JSON.

Составной объект формируется с помощью:

  • логических операций:
    • конъюнкция - "and"
    • дизъюнкция - "or"
    • инверсия - "not"
  • операций сравнения:
    • больше - ">"
    • больше либо равно - ">="
    • меньше - "<"
    • меньше либо равно - "<="
    • соответствует - "=="
    • не соответствует - "!="

В зависимости от используемой операции составной объект JSON может иметь вид:

    {
      "and": [ARRAY]
    }
    {
      "or": [ARRAY]
    }
    {
      "not": { OBJECT }
    }
    {
      "операция сравнения": { VARIABLE }
    }

    (операцию сравнения "==" можно не указывать, т.е. вид объекта - { VARIABLE })

где:

  • VARIABLE - переменная. Обозначается структурой <имя переменной>: <значение переменной>
  • OBJECT - переменная или составной объект JSON любого из указанных выше форматов
  • ARRAY - массив. Может состоять из переменных и составных объектов JSON (любого формата) в различных комбинациях

Примеры

Отфильтровать записи с важностью (severity) равной 2 (ошибка):

{ 
ㅤㅤ"severity": 2
}

Отфильтровать записи, где поле message содержит подстроку Exception:

{
  "message": "*Exception*"
}

Выбрать записи, где важность (severity) равна 2 и выполняется одно из условий: сообщение содержит подстроку поставлен или источник (source) не равен TU_212.

{
   "and":[
      {
         "severity":2
      },
      {
         "or":[
            {
               "message":"*поставлен*"
            },
            {
               "not":{
                  "source":"TU_212"
               }
            }
         ]
      }
   ]
}