Устранение неполадок
В разделе собраны типовые проблемы текущего интерфейса INFRAX: вход через Identyx, удаленные подключения, мониторинг, Helpdesk и проверка производительности. Формулировки ниже совпадают с тем, что пользователь видит в UI сейчас.
Проблемы с авторизацией
Не удается войти через Identyx
Симптомы: после перехода в Identyx появляется сообщение об ошибке авторизации, либо страница входа не открывается.
Возможные причины:
- Identyx недоступен или отвечает с ошибкой
- Истекла текущая сессия Identyx
- У пользователя заблокирован аккаунт или не хватает ACL
- Старая сессия браузера мешает обновить права
Решение:
- Откройте Настройки → Авторизация и перейдите по кнопке Открыть Identyx
- Войдите в Identyx повторно и обновите страницу INFRAX
- Если права изменились, выйдите и войдите снова, чтобы обновить ACL в текущей сессии
- Если ошибка повторяется, попросите администратора проверить доступность Identyx и статус учетной записи
Сессия постоянно завершается
Симптомы: система слишком часто просит войти снова или перестает открывать защищенные разделы.
Возможные причины:
- Истекает сессия Identyx
- Браузер блокирует cookie
- Открыто несколько вкладок с одной и той же сессией
Решение:
- Войдите в Identyx заново
- Проверьте, что браузер не блокирует cookie для домена INFRAX/Identyx
- Закройте лишние вкладки и повторите вход из одной вкладки
Проблемы с подключениями
Не открывается окно выбора способа подключения
Симптомы: при запуске подключения не появляется диалог Выбор способа подключения.
Возможные причины:
- Для выбранного протокола доступен только один способ подключения
- Администратор отключил нативные подключения
- Для нативного подключения не установлен Infrax plugin
Решение:
- Для VNC и Console подключение всегда идет через веб-интерфейс
- Для Winbox используется только нативный клиент
- Для RDP и SSH проверьте, не отключил ли администратор нативные подключения
- Если нужен нативный режим, установите Infrax plugin и повторите подключение
Console не запускается
Симптомы: кнопка Console видна, но консоль не открывается или сразу закрывается.
Возможные причины:
- На целевом Windows-узле не запущен INFRAXAgent
- Закрыт порт 4152 на узле или между узлом и сервером INFRAX
- Агент слишком старый и не принимает сеансовый ключ VNC
Решение:
- Проверьте, что служба INFRAXAgent запущена
- Убедитесь, что порт 4152 открыт в брандмауэре
- Проверьте сетевую доступность узла с сервера INFRAX
- Если проблема повторяется, проверьте логи агента и обновите его до актуальной версии
RDP или SSH открывается не так, как ожидалось
Симптомы: подключение открывается в не том клиенте, не запоминается выбор или не срабатывает автоматический вход.
Возможные причины:
- Не выбран и не сохранен нужный вариант в диалоге подключения
- Для RDP не включена опция Подключать все мониторы
- Для SSH на Linux не включен Авто sudo -i при SSH подключении
Решение:
- В диалоге Выбор способа подключения выберите нужный вариант: Через веб-интерфейс или Через нативный клиент
- Если нужно, включите сохранение выбора для следующих подключений
- Для RDP в нативном режиме включите Подключать все мониторы
- Для Linux-узлов проверьте настройку Авто sudo -i при SSH подключении в пользовательских параметрах
Подключения к узлам площадок
| Проблема | Возможные причины | Решение |
|---|---|---|
| Подключения к узлам площадки отклоняются, статус площадки — «Не в сети» | Шлюз площадки не на связи: пропал канал до площадки, остановлена служба шлюза или её удалили с машины | Пока площадка не на связи, подключения к её узлам отклоняются намеренно. Откройте карточку площадки и вкладку Шлюзы, затем проверьте шлюз на машине, где он установлен, — см. «Шлюзы площадок» |
| Скачанный установщик шлюза перестал работать | Код подключения уже использован, отменён или его срок истёк; площадку, ожидавшую подключения, удалили | Установщик рассчитан ровно на одну установку. Выдайте новый код: для площадки, ждущей первый шлюз, — кнопкой Код подключения и установщик, для дополнительного шлюза — кнопкой Добавить шлюз |
Проблемы с мониторингом
Не отображаются метрики узла
Симптомы: графики пустые или данные не обновляются.
Возможные причины:
- Агент не установлен или не запущен
- Узел недоступен с сервера INFRAX
- Для сетевого оборудования не настроен SNMP-трафик или шаблон
- Раздел Мониторинг приложений скрыт, потому что выключен режим отладки
Решение:
- Проверьте вкладку Мониторинг на узле и статус агента
- Если речь о сетевом устройстве, откройте вкладку SNMP и проверьте шаблон
- Убедитесь, что между сервером INFRAX и узлом есть сетевой доступ
- Если не видите Мониторинг приложений, включите режим отладки и заново откройте нужный режим отображения
Инциденты не создаются автоматически
Симптомы: пороги превышены, но инциденты или тикеты не появляются.
Возможные причины:
- Не настроены триггеры или шаблоны мониторинга
- Условия срабатывания не выполняются
- Фоновая задача мониторинга не отрабатывает вовремя
Решение:
- Проверьте настройки мониторинга на узле или папке
- Убедитесь, что пороги и расписание сбора данных заданы корректно
- Откройте Историю задач и проверьте, нет ли ошибок у фоновых задач
Узлы площадки не опрашиваются
| Проблема | Возможные причины | Решение |
|---|---|---|
| Статус площадки — «Нет данных», состояние её узлов не меняется | Не отвечает сервис sitelink-hub, поэтому неизвестно, какие шлюзы площадок на связи | Это состояние самой инсталляции, а не площадки: узлы недоступными не помечаются, история задержки не пишется и инциденты не заводятся. Над деревом узлов в это время выводится «Сервис sitelink-hub недоступен, поэтому неизвестно, какие шлюзы площадок на связи. Дерево и его узлы взяты из базы данных.» Обратитесь к администратору инсталляции |
| Узлы площадки перестали опрашиваться после её отзыва | Площадка отозвана: её шлюзы больше не подключаются, добраться до узлов внутри неё нечем | Отзыв — не авария, поэтому новых инцидентов по такой площадке не заводится. Переведите узлы на действующую площадку или подключите её заново, создав новую площадку: название отозванной освобождается и его можно занять снова. Об установке шлюза — в разделе «Шлюзы площадок» |
Проблемы с Helpdesk
Не приходят уведомления о тикетах
Симптомы: Email или Telegram-уведомления не доходят до пользователя.
Возможные причины:
- Канал не подключен в Мои предпочтения → Уведомления
- Не задан Email в профиле Identyx
- Telegram-аккаунт не привязан к системе
- Канал уведомлений отключен для нужного типа события
Решение:
- Откройте Мои предпочтения → Уведомления
- Проверьте состояние каналов Email и Telegram
- Если Email пустой, задайте его в Identyx
- Если нужно, отправьте тестовое уведомление из настроек
ИИ-помощник не отвечает
Симптомы: в чате тикета нет ответа от AI-помощника или он не формирует рекомендацию.
Возможные причины:
- Недоступен INFRAX Cloud
- Не задан cloud API token
- Ассистент отключен в пользовательских настройках
Решение:
- Проверьте раздел Настройки → INFRAX Cloud
- Убедитесь, что cloud token задан корректно
- Проверьте сетевой доступ к облачному сервису
- Если ответ по-прежнему не приходит, попробуйте переформулировать запрос и приложить контекст тикета
В чате тикета не видно служебных сообщений
Симптомы: в переписке не отображаются изменения статуса, исполнителя или другие системные события.
Возможные причины:
- В пользовательских настройках отключен показ служебных сообщений
- Вы смотрите только пользовательские сообщения, а не весь поток событий
Решение:
- Откройте Мои предпочтения → Тикеты
- Включите Показывать служебные сообщения
- Обновите тикет и проверьте чат снова
Проблемы с производительностью
Интерфейс работает медленно
Симптомы: страницы долго загружаются, таблицы открываются с задержкой или браузер начинает подвисать.
Возможные причины:
- Слишком большой объем данных в списке
- Открыта тяжелая страница с большим числом таблиц и графиков
- Проблема в самом браузере или его расширениях
Решение:
- Используйте фильтры и поиск, чтобы уменьшить объем данных
- Перейдите к нужному разделу, а не держите открытым сразу несколько тяжелых страниц
- Если тормозит только веб-подключение, попробуйте нативный клиент для RDP или SSH
Фоновые задачи или сервисы обрабатывают ошибки
Симптомы: операции долго висят, задачи падают или изменения не доходят до интерфейса.
Возможные причины:
- Ошибка в фоновой задаче
- Проблема в агенте, почтовом коннекторе или другом сервисе
- Сбой внешней зависимости, например IAM, SMTP или Telegram
Решение:
- Откройте Историю задач и найдите задачи со статусом Ошибка
- Проверьте
debug.logиerror.log - Если проблема связана с конкретным сервисом, проверьте его отдельный лог
- При необходимости используйте Экспорт данных для техподдержки в настройках
Диагностические инструменты
Логи системы
Для диагностики чаще всего нужны следующие файлы:
- Логи приложения:
/var/log/infrax/или./data/infrax/logs/ - Основные файлы:
debug.log,error.log,mounts.log - Логи сервисов: отдельные файлы для cron, mail, Telegram и других фоновых процессов
Проверка статуса сервисов
Если проблема похожа на системную, проверьте состояние сервисов в вашей схеме разворачивания:
# Проверка статуса INFRAX
systemctl status infrax
# Проверка статуса PostgreSQL
systemctl status postgresql
# Проверка статуса веб-сервера
systemctl status nginx
Экспорт для поддержки
Если нужно передать данные в поддержку, используйте кнопку Экспорт данных для техподдержки в Настройках. Экспорт помогает собрать нужные логи и служебную информацию без ручного поиска файлов.
Когда обращаться в поддержку
Обратитесь в техническую поддержку, если:
- Проблема не решается описанными способами
- Возникают критические ошибки, которые мешают работе
- Нужна помощь с Identyx, агентом или настройкой фоновых сервисов
- Требуется разбор логов или восстановление данных
- Версию INFRAX и способ разворачивания
- Точный текст ошибки или скриншот
- Шаги, после которых проблема воспроизводится
- Скриншоты, фрагменты логов и, при необходимости, экспорт для поддержки
- Информацию об окружении: ОС, браузер, тип подключения