Документация 0.4 Администрирование
Мониторинг и неполадки
Состояние системы #
«Администрирование» → «Состояние системы» (администратор и аудитор) — всё, что нужно проверить утром и после изменений на сервере.
| Карточка | Что проверить |
|---|---|
| «Сервер» | Версия, время запуска, «Папка данных», «Публичный адрес»; предупреждение, если сервер работает без HTTPS |
| «База данных» | «Доступна», версия PostgreSQL, размер, миграции, «Поиск по кириллице» — должно быть «Работает» |
| «Диск с данными» | Свободное место; нужно не меньше 1 ГБ |
| «Сертификат HTTPS» | Источник, срок действия; «Скачать сертификат .cer» |
| «Приём событий» | «В норме» или «Отстаёт» — события роботов записываются с опозданием больше 30 секунд |
| «Агенты роботов» | Роботы по версиям агента, «Последняя версия на сервере», «Целевая версия», пакеты агента |
| «Резервная копия» | «Сделана» / «Устарела» (старше 7 дней) / «Нет копий» |
| «Ключ шифрования» | «Выгружен» или напоминание сделать экспорт; недостающие ключи после восстановления |
| «Внешние подключения» | Какие каналы включены: кроме PostgreSQL и агентов сервер обращается наружу только к ним |
| «Журнал» | Число и объём событий роботов, оценка на срок хранения, предупреждения и ошибки сервера за сутки |
| «Лицензия» | Состояние, «Роботов без лицензии» |
| «База отчётов» | Доступна ли база отчётов |
Проблемы этой страницы приходят и оповещением „Состояние сервера“ администраторам (см. Оповещения).
Команда check #
& "C:\Program Files\Tulpar\Orchestrator\Tulpar.Orchestrator.exe" check
Docker: docker compose exec orchestrator dotnet Tulpar.Orchestrator.dll check. Проверяет папку данных, адреса,
сертификат и его срок, PostgreSQL и его версию, миграции, локаль и поиск по кириллице, ключи шифрования, пакеты
агента, свободное место, давность резервной копии, лицензию и базу отчётов (доступна ли, есть ли у роли права
CREATEDB и CREATEROLE). Для каждой проблемы — что сделать.
Внешний мониторинг #
| Адрес | Ответ |
|---|---|
GET /health/live |
Сервер запущен (без входа) |
GET /health/ready |
{"status": "ok" \| "degraded" \| "unavailable", "checks": {…}} — degraded, если недоступна только база отчётов; unavailable — нет связи с основной базой или не применены миграции |
Подключите /health/ready к системе мониторинга организации (Zabbix, Prometheus blackbox и т. п.) с интервалом в
минуту.
Журнал сервера #
- Windows:
C:\ProgramData\Tulpar\Orchestrator\logs\orchestrator-<дата>.log(14 дней) и „Журнал Windows → Приложение“. - Docker:
docker compose logs -f orchestrator. - В панели: «Журнал» → источник «Журнал сервера» — предупреждения и ошибки с поиском (см. Журнал).
Частые неполадки #
| Признак | Причина и что делать |
|---|---|
| Служба не запускается | Журнал сервера. Частые причины: PostgreSQL не запущен; порт 8443 занят (netstat -ano \| findstr 8443) — смените порт в Urls; второй экземпляр сервера с той же базой |
/health/ready = unavailable |
Нет связи с базой или не применены миграции: check, затем migrate |
| „Поиск по кириллице не работает“ | База создана не в UTF-8. Пересоздайте кластер PostgreSQL с UTF-8 и восстановите копию |
| „Ключ шифрования не найден… импортируйте ключ“ | После восстановления не загружен ключ: keys import (Резервные копии и ключи) |
| «База отчётов недоступна» | Нет базы отчётов или прав роли сервера: check покажет причину и команду (База отчётов) |
| Браузер: „Подключение не защищено“ | Самоподписанный сертификат — добавьте его в доверенные (Настройки и HTTPS) |
| Робот «Нет связи» | На роботе откройте https://<сервер>:8443/health/live в браузере; брандмауэр сервера; прокси. Журнал агента — %LOCALAPPDATA%\Tulpar\Agent\logs |
| Агент: сертификат не совпадает | Сертификат сервера сменился — выдайте роботу новую строку подключения |
| Задание ждёт: сеанс Windows заблокирован | Фоновый робот: автовход, не блокировать экран, выходить из RDP пунктом трея „Отключиться от RDP без блокировки“ |
| Обновление агента откатилось | Журнал агента (категория update); «Собрать диагностику» и передайте архив в поддержку |
| Администратор забыл пароль | Tulpar.Orchestrator.exe reset-admin-password --login admin — временный пароль в консоль |
„Слишком много запросов“ (429) |
Сработало ограничение частоты (вход, поиск, выгрузки, токен API) — подождите минуту |
| Задания не назначаются, полоса „Ограниченный режим“ | Закончилась лицензия — см. Лицензирование |
Для поддержки соберите вывод check, журнал сервера за день и архив «Собрать диагностику» робота.