Журналы и наблюдение

Логирование

Каждый процесс ведет журнал работы в текстовых файлах с именами вида scada-<процесс>_<дата>_<время>-<номер>.log (например, scada-iec104_2026-10-04_08-00-00-0.log). У процессов, установленных scada-setup, журналы находятся в папке Logs папки процесса: %ProgramData%\Telecontrol\SCADA Server\<папка процесса>\Logs. Параметры логирования:

Параметр По умолчанию Описание
log.dir %ProgramData%\Telecontrol\SCADA Server\logs (на Linux — Telecontrol/SCADA Server/logs относительно рабочей папки процесса) Папка файлов журнала
log.max_file_size 10 Максимальный размер одного файла (Мб)
log.max_total_size 100 Максимальный общий размер всех файлов (Мб)
log.max_count 1000 Максимальное количество файлов
log.severity — Наименьший уровень сообщений, записываемых в файлы журнала (и выводимых куда-либо еще): Trace, Debug, Info, Warning, Error или Critical. Не задан — в файлы записываются сообщения всех уровней
log.console_severity — Наименьший уровень сообщений, выводимых на экран в консольном режиме, из тех же значений. На файлы журнала не влияет

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

Если файл параметров не удается прочитать (например, после ошибки при правке), процесс записывает причину в журнал в папке Logs рядом с файлом параметров — для процессов, установленных scada-setup, это и есть их обычная папка журналов — и не запускается. Ошибку в блоке log (например, неизвестный уровень) процесс записывает в журнал с параметрами по умолчанию в папке log.dir.

Наблюдение за работой

  • Состояние служб, лицензии и сертификата — команда scada-setup status на каждом компьютере (права администратора ей не нужны): срок действия лицензии, процессы, на которые она выдана, сертификат Сервера этого компьютера и состояние службы каждого процесса. Команда выводит, например:

    License: C:\ProgramData\Telecontrol\SCADA Server\license.json (onprem-example-20260131, expires 2027-01-31T00:00:00Z)
    Entitled tiers: config filesystem historian iec104 proxy
    OPC UA certificate: C:\Program Files\Telecontrol SCADA\data\Certificates\ServerCertificate.pem
      SHA-256 fingerprint: 30:CE:C4:DB:...:66:6F
      Valid from 2026-11-07 to 2031-11-06 (UTC)
      Issued by the site CA: links are encrypted
    Site CA: C:\Program Files\Telecontrol SCADA\data\Certificates\ca\ca.pem (this is the central computer)
      Valid from 2026-11-07 to 2036-11-05 (UTC)
      Other computers join the site with --central-fingerprint 30:CE:C4:DB:...:66:6F
    config       SERVICE_RUNNING
    historian    SERVICE_RUNNING
    filesystem   SERVICE_RUNNING
    modbus       not installed
    iec104       SERVICE_RUNNING
    iec61850     not installed
    opc          not installed
    vidicon      not installed
    proxy        SERVICE_RUNNING
    

    Процессы в строке Entitled tiers перечислены в алфавитном порядке. Под OPC UA certificate выводятся отпечаток SHA-256 сертификата этого компьютера, даты начала и окончания его действия и то, выдан ли он удостоверяющим центром объекта (иначе соединения не шифруются). Строки Site CA есть только на центральном компьютере: даты действия удостоверяющего центра и отпечаток, с которым к объекту подключаются остальные компьютеры (--central-fingerprint). Ниже, без --tiers, выводятся все девять процессов в порядке запуска: работающая служба — SERVICE_RUNNING, остановленная — SERVICE_STOPPED, отсутствующая на компьютере — not installed.

  • Журналы процессов — смотрите Логирование. Причины остановки процесса (лицензия, сертификат, ошибка в файле параметров) записываются в журнал.
  • Связь между процессами — если в журнале процесса протокольного уровня есть Bad_UserAccessDenied, на его компьютере задан другой пароль svc (смотрите Учетная запись svc).
  • Запись в архив — окно Клиента Дополнительно — Базы данных показывает для каждого архива количество записанных измерений и очередь записи (смотрите Базы данных). После перезапуска службы процесса протокольного уровня, в том числе автоматического после сбоя, запись значений его объектов в архив возобновляется сама, обычно в течение минуты (смотрите Перезапуск процесса протокольного уровня). Если количество записанных измерений не растет дольше, хотя значения объектов в Клиенте меняются, сообщите в ООО «Телеконтроль» (mail@telecontrol.ru).

Клиентские подключения

Параметр sessions определяет адреса и порты для приема клиентских подключений. По умолчанию Сервер принимает подключения на всех сетевых интерфейсах (0.0.0.0) на порту 2000.

"sessions": [
    "tcp;passive;host=0.0.0.0;port=2000"
]

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