Узлы и файловое логирование

Для доступа к разделу у пользователя должна быть роль Администратор

В списке отображается состояние узлов. Откройте карточку, чтобы проверить настройки транспорта, активность и результат последней попытки перезапуска.

Список узлов сервиса

Механизм проверки активности узла

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

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

Когда свежий сигнал не поступает дольше заданного порога, карточка показывает Нет актуального ответа от узла и время последнего сигнала. Это означает только, что система не может подтвердить состояние узла по свежему сигналу. Это не доказывает, что процесс остановлен или сеть недоступна.

Карточка узла

Поколение - счётчик регистрации узла. Он увеличивается при новой регистрации экземпляра узла, его удалении и восстановлении записи. Такой механизм позволяет отклонять команды из устаревших экземпляров узла и сообщения от прежнего экземпляра приложения. Значение поколения не является счётчиком перезапусков.

Ревизия - номер сохранённого набора настроек транспорта: публичного адреса, режима соединения, сертификата TLS и разрешённых веб-адресов. Версия приложения указана отдельно.

Поле Что означает
ID Постоянный идентификатор записи узла.
Поколение Счётчик регистрации узла; меняется при новой регистрации, удалении или восстановлении записи.
Версия сборки Версия приложения, сообщённая узлом.
Последний сигнал Время последнего сообщения узла. По умолчанию сигнал поступает каждые 5 секунд; после 30 секунд без сигнала связь считается неизвестной. Настройки интервала описаны в параметрах контроллера.
Связь Показывает, поступает ли сигнал обновления метки времени вовремя. Это не проверка доступности веб-сайта. «Неизвестно» не подтверждает, что процесс остановлен.
Фактическая ревизия Набор настроек, применение которого узел подтвердил.
Целевая ревизия Номер набора настроек, которые узел должен применить в ходе уже начавшейся операции перезапуска. Появление номера в этом поле ещё не подтверждает успешное применение настроек.
Последняя рабочая ревизия Последний успешно применённый набор настроек, сохранённый сервисом для восстановления.
Фактический публичный URL Внешний адрес из настроек узла. В локальной разработке он может отличаться от адреса страницы панели, например http://localhost:5173.
Режим listener Режим приёма соединений узлом: HTTP или HTTPS.
Адрес привязки Адрес и порт, на которых узел принимает соединения.
Адрес локального recovery Адрес и порт локального режима восстановления, если он включён.
TLS фактической конфигурации Краткие сведения о сертификате из применённой конфигурации.
Обслуживаемый TLS Сертификат, который узел сообщает как используемый для соединений. В режиме восстановления он может отличаться от сертификата конфигурации. Для устаревшего сигнала метки времени это последнее известное значение.
Состояние обслуживания none — страница восстановления не открыта; public_maintenance — страница открыта через прежние настройки соединения; loopback — включён локальный аварийный вход. При loopback обычный HTTPS-сервис может продолжать работать, например если истёк сертификат.
Режим работы узла Показывает актуальное сообщение узла о запуске обычного сервиса: Обычный сервис запущен, Только восстановление узла, Запуск, Перезапуск, Ошибка или причину неизвестного состояния. Истёкший сертификат может мешать браузеру открыть запущенный HTTPS-сервис.
Способ доступа к восстановлению По актуальному сообщению узла показывает прежние настройки соединения, локальный аварийный вход, оба способа, Не используется или причину неизвестного состояния.
Причина восстановления Безопасное описание причины перехода в режим восстановления, если оно есть.
Ошибка открытия доступа к восстановлению Безопасное описание ошибки при открытии дополнительного доступа к странице восстановления, если она возникла.
Последняя попытка Время последней попытки применить настройки. Это не время последнего сигнала метки времени.
Результат последней попытки applied — применение подтверждено; fallback — целевая ревизия не подтверждена; interrupted — прервано; error — ошибка; unknown — результат неизвестен; expired — узел не начал выполнять команду перезапуска в отведённое время (подробнее).
Требуется перезапуск true означает, что выбранные общие настройки ещё не совпадают с фактическими настройками узла либо узел запущен в режиме восстановления. false означает, что такого расхождения не отмечено.
Запись удалена Запись узла исключена из системы, команды от узла не принимаются и не передаются в узел. Это не останавливает приложение на компьютере узла.

Например, состояния могут выглядеть так:

Ситуация Фактическая ревизия Целевая ревизия
До перезапуска 7 —
Настройки применяются 7 8
После успешного применения 8 —

Чтобы проверить применение настроек на узле после перезапуска:

  1. Проверьте поле Последняя попытка: дата и время должны относиться к нужному перезапуску.
  2. Убедитесь, что в поле Результат последней попытки указано applied — настройки применены.
  3. Сверьте поле Фактическая ревизия с номером настроек, выбранных для этого перезапуска. Например, после применения ревизии 8 здесь отображается 8.

При перезапуске нескольких узлов проверьте результат каждого узла в операции перезапуска. Прочерк в поле Целевая ревизия не сообщает об успехе или ошибке.

Когда сигнал получения метки времени устарел, значения карточки показывают последнее известное состояние. Для TLS заголовок меняется на Последнее известное состояние. Отброшенные записи и путь файла показываются только для сигнала с актуальной меткой времени.

Значения true и false в карточке означают «да» и «нет» соответственно.

Сервисные режимы работы узла

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

Случай Режим работы узла Способ доступа к восстановлению
Узел не может запуститься после перезапуска или применить новые настройки транспорта. Только восстановление узла Прежние настройки соединения, локальный аварийный вход или оба способа.
Предыдущий перезапуск был прерван, и узел запустил страницу восстановления. Только восстановление узла Прежние настройки соединения, локальный аварийный вход или оба способа.
Сертификат истёк на уже работающем HTTPS-узле. Обычный сервис запущен Локальный аварийный вход. Браузер может блокировать вход по HTTPS.

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

Нет актуального ответа от узла означает, что система не получила свежего сообщения о состоянии самого узла. По умолчанию сигнал считается устаревшим через 30 секунд; этот срок настраивается. Последнее время сигнала показано в карточке. Это описание работы узла, а не сохранённых настроек или расчётных листков. Отсутствие свежего сообщения не доказывает остановку процесса или проблему с сетью.

Для выхода устраните причину и явно перезапустите этот узел. После подтверждённого применения настроек состояние станет none. Подробнее читайте в разделе режим восстановления.

Раздел Настройки → Обслуживание предназначен для ручной очистки данных и не включает сервисный режим узла.

Состояние сертификата TLS

В блоке Текущее состояние (или Последнее известное состояние) отображаются сведения об обслуживаемом сертификате:

Поле Что означает
Срок сертификата Дата окончания действия сертификата.
SHA-256 сертификата Контрольная сумма сертификата, по которой можно сравнить его копии.
Текущее состояние Имя владельца и издателя сертификата.

Файловое логирование

Для узла с актуальным сигналом карточка показывает:

Поле Что означает
Активное состояние Отключено, Инициализация, Работает или Ошибка для записи журнала в файл.
Отброшено записей Число записей, которые не попали в файловую копию журнала.
Ошибка Безопасный код последней ошибки записи, если она была.
Имя или путь файла Путь и имя файла журнала. Панель не показывает и не скачивает его содержимое.

Включение файлового логирования

  1. На панели инструментов списка узлов нажмите Файловое логирование.
  2. Включите Включить файловое логирование.
  3. Укажите Имя или путь файла, размер перед ротацией и число архивов.
  4. Нажмите Сохранить.
  5. Перезапустите каждый нужный узел.

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

Если возникает ошибка, техническая запись может показать этап, безопасную причину, условие и последствие. Для обращения в поддержку сохраните время, узел и идентификатор запроса или операции, если он есть. Содержимое файлового журнала остаётся доступно только на самом узле.

Файловое логирование

Общие настройки транспорта

В блоке Фактическое состояние показаны общие настройки транспорта. Применённые настройки конкретного узла указаны в полях его ревизий.

Поле Что означает
Ожидающая конфигурация Сохранённый набор настроек, который ещё не принят для применения.
Выбрано к применению Общий набор настроек, выбранный для применения. Это не подтверждение результата на конкретном узле.
Источник Откуда получено значение настройки.

Удаление или восстановление записи узла

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

Для узла с актуальной сигнальной меткой сообщение «Действие недоступно» не показывается: удалять такую запись нельзя. Действие Удалить запись узла доступно, если связь неизвестна и узел не запускается, не перезапускается и не находится на обслуживании. Если команда перезапуска уже выполняется, дождитесь её завершения. Удаление прервёт ожидающую команду, уберёт запись из будущих команд перезапуска, но не остановит процесс на компьютере узла.

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

Параметры, заданные через ENV, .env или YAML, нужно менять и применять средствами вашей установки.