Устранение неполадок

ℹ️ О разделе

В разделе собраны типовые проблемы текущего интерфейса INFRAX: вход через Identyx, удаленные подключения, мониторинг, Helpdesk и проверка производительности. Формулировки ниже совпадают с тем, что пользователь видит в UI сейчас.

Проблемы с авторизацией

Не удается войти через Identyx

Симптомы: после перехода в Identyx появляется сообщение об ошибке авторизации, либо страница входа не открывается.

Возможные причины:

  • Identyx недоступен или отвечает с ошибкой
  • Истекла текущая сессия Identyx
  • У пользователя заблокирован аккаунт или не хватает ACL
  • Старая сессия браузера мешает обновить права

Решение:

  1. Откройте Настройки → Авторизация и перейдите по кнопке Открыть Identyx
  2. Войдите в Identyx повторно и обновите страницу INFRAX
  3. Если права изменились, выйдите и войдите снова, чтобы обновить ACL в текущей сессии
  4. Если ошибка повторяется, попросите администратора проверить доступность Identyx и статус учетной записи

Сессия постоянно завершается

Симптомы: система слишком часто просит войти снова или перестает открывать защищенные разделы.

Возможные причины:

  • Истекает сессия Identyx
  • Браузер блокирует cookie
  • Открыто несколько вкладок с одной и той же сессией

Решение:

  1. Войдите в Identyx заново
  2. Проверьте, что браузер не блокирует cookie для домена INFRAX/Identyx
  3. Закройте лишние вкладки и повторите вход из одной вкладки

Проблемы с подключениями

Не открывается окно выбора способа подключения

Симптомы: при запуске подключения не появляется диалог Выбор способа подключения.

Возможные причины:

  • Для выбранного протокола доступен только один способ подключения
  • Администратор отключил нативные подключения
  • Для нативного подключения не установлен Infrax plugin

Решение:

  1. Для VNC и Console подключение всегда идет через веб-интерфейс
  2. Для Winbox используется только нативный клиент
  3. Для RDP и SSH проверьте, не отключил ли администратор нативные подключения
  4. Если нужен нативный режим, установите Infrax plugin и повторите подключение

Console не запускается

Симптомы: кнопка Console видна, но консоль не открывается или сразу закрывается.

Возможные причины:

  • На целевом Windows-узле не запущен INFRAXAgent
  • Закрыт порт 4152 на узле или между узлом и сервером INFRAX
  • Агент слишком старый и не принимает сеансовый ключ VNC

Решение:

  1. Проверьте, что служба INFRAXAgent запущена
  2. Убедитесь, что порт 4152 открыт в брандмауэре
  3. Проверьте сетевую доступность узла с сервера INFRAX
  4. Если проблема повторяется, проверьте логи агента и обновите его до актуальной версии

RDP или SSH открывается не так, как ожидалось

Симптомы: подключение открывается в не том клиенте, не запоминается выбор или не срабатывает автоматический вход.

Возможные причины:

  • Не выбран и не сохранен нужный вариант в диалоге подключения
  • Для RDP не включена опция Подключать все мониторы
  • Для SSH на Linux не включен Авто sudo -i при SSH подключении

Решение:

  1. В диалоге Выбор способа подключения выберите нужный вариант: Через веб-интерфейс или Через нативный клиент
  2. Если нужно, включите сохранение выбора для следующих подключений
  3. Для RDP в нативном режиме включите Подключать все мониторы
  4. Для Linux-узлов проверьте настройку Авто sudo -i при SSH подключении в пользовательских параметрах

Подключения к узлам площадок

ПроблемаВозможные причиныРешение
Подключения к узлам площадки отклоняются, статус площадки — «Не в сети»Шлюз площадки не на связи: пропал канал до площадки, остановлена служба шлюза или её удалили с машиныПока площадка не на связи, подключения к её узлам отклоняются намеренно. Откройте карточку площадки и вкладку Шлюзы, затем проверьте шлюз на машине, где он установлен, — см. «Шлюзы площадок»
Скачанный установщик шлюза перестал работатьКод подключения уже использован, отменён или его срок истёк; площадку, ожидавшую подключения, удалилиУстановщик рассчитан ровно на одну установку. Выдайте новый код: для площадки, ждущей первый шлюз, — кнопкой Код подключения и установщик, для дополнительного шлюза — кнопкой Добавить шлюз

Проблемы с мониторингом

Не отображаются метрики узла

Симптомы: графики пустые или данные не обновляются.

Возможные причины:

  • Агент не установлен или не запущен
  • Узел недоступен с сервера INFRAX
  • Для сетевого оборудования не настроен SNMP-трафик или шаблон
  • Раздел Мониторинг приложений скрыт, потому что выключен режим отладки

Решение:

  1. Проверьте вкладку Мониторинг на узле и статус агента
  2. Если речь о сетевом устройстве, откройте вкладку SNMP и проверьте шаблон
  3. Убедитесь, что между сервером INFRAX и узлом есть сетевой доступ
  4. Если не видите Мониторинг приложений, включите режим отладки и заново откройте нужный режим отображения

Инциденты не создаются автоматически

Симптомы: пороги превышены, но инциденты или тикеты не появляются.

Возможные причины:

  • Не настроены триггеры или шаблоны мониторинга
  • Условия срабатывания не выполняются
  • Фоновая задача мониторинга не отрабатывает вовремя

Решение:

  1. Проверьте настройки мониторинга на узле или папке
  2. Убедитесь, что пороги и расписание сбора данных заданы корректно
  3. Откройте Историю задач и проверьте, нет ли ошибок у фоновых задач

Узлы площадки не опрашиваются

ПроблемаВозможные причиныРешение
Статус площадки — «Нет данных», состояние её узлов не меняетсяНе отвечает сервис sitelink-hub, поэтому неизвестно, какие шлюзы площадок на связиЭто состояние самой инсталляции, а не площадки: узлы недоступными не помечаются, история задержки не пишется и инциденты не заводятся. Над деревом узлов в это время выводится «Сервис sitelink-hub недоступен, поэтому неизвестно, какие шлюзы площадок на связи. Дерево и его узлы взяты из базы данных.» Обратитесь к администратору инсталляции
Узлы площадки перестали опрашиваться после её отзываПлощадка отозвана: её шлюзы больше не подключаются, добраться до узлов внутри неё нечемОтзыв — не авария, поэтому новых инцидентов по такой площадке не заводится. Переведите узлы на действующую площадку или подключите её заново, создав новую площадку: название отозванной освобождается и его можно занять снова. Об установке шлюза — в разделе «Шлюзы площадок»

Проблемы с Helpdesk

Не приходят уведомления о тикетах

Симптомы: Email или Telegram-уведомления не доходят до пользователя.

Возможные причины:

  • Канал не подключен в Мои предпочтения → Уведомления
  • Не задан Email в профиле Identyx
  • Telegram-аккаунт не привязан к системе
  • Канал уведомлений отключен для нужного типа события

Решение:

  1. Откройте Мои предпочтения → Уведомления
  2. Проверьте состояние каналов Email и Telegram
  3. Если Email пустой, задайте его в Identyx
  4. Если нужно, отправьте тестовое уведомление из настроек

ИИ-помощник не отвечает

Симптомы: в чате тикета нет ответа от AI-помощника или он не формирует рекомендацию.

Возможные причины:

  • Недоступен INFRAX Cloud
  • Не задан cloud API token
  • Ассистент отключен в пользовательских настройках

Решение:

  1. Проверьте раздел Настройки → INFRAX Cloud
  2. Убедитесь, что cloud token задан корректно
  3. Проверьте сетевой доступ к облачному сервису
  4. Если ответ по-прежнему не приходит, попробуйте переформулировать запрос и приложить контекст тикета

В чате тикета не видно служебных сообщений

Симптомы: в переписке не отображаются изменения статуса, исполнителя или другие системные события.

Возможные причины:

  • В пользовательских настройках отключен показ служебных сообщений
  • Вы смотрите только пользовательские сообщения, а не весь поток событий

Решение:

  1. Откройте Мои предпочтения → Тикеты
  2. Включите Показывать служебные сообщения
  3. Обновите тикет и проверьте чат снова

Проблемы с производительностью

Интерфейс работает медленно

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

Возможные причины:

  • Слишком большой объем данных в списке
  • Открыта тяжелая страница с большим числом таблиц и графиков
  • Проблема в самом браузере или его расширениях

Решение:

  1. Используйте фильтры и поиск, чтобы уменьшить объем данных
  2. Перейдите к нужному разделу, а не держите открытым сразу несколько тяжелых страниц
  3. Если тормозит только веб-подключение, попробуйте нативный клиент для RDP или SSH

Фоновые задачи или сервисы обрабатывают ошибки

Симптомы: операции долго висят, задачи падают или изменения не доходят до интерфейса.

Возможные причины:

  • Ошибка в фоновой задаче
  • Проблема в агенте, почтовом коннекторе или другом сервисе
  • Сбой внешней зависимости, например IAM, SMTP или Telegram

Решение:

  1. Откройте Историю задач и найдите задачи со статусом Ошибка
  2. Проверьте debug.log и error.log
  3. Если проблема связана с конкретным сервисом, проверьте его отдельный лог
  4. При необходимости используйте Экспорт данных для техподдержки в настройках

Диагностические инструменты

Логи системы

Для диагностики чаще всего нужны следующие файлы:

  • Логи приложения: /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 и способ разворачивания
  • Точный текст ошибки или скриншот
  • Шаги, после которых проблема воспроизводится
  • Скриншоты, фрагменты логов и, при необходимости, экспорт для поддержки
  • Информацию об окружении: ОС, браузер, тип подключения