Общее описание

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

Установка

Скрипты поставляются вместе с NAICE и не требует дополнительных действий по их загрузке или установки системы мониторинга.

Запуск скриптов 

Перед запуском скрипта необходимо в разделе Настройки системы → Решение проблем → Логи включить:

Нажать Сохранить.

Воспроизвести проблему, что бы она была залогирована на уровне DEBUG.

Запустить скрипт сбора логов. После сбора информации необходимо вернуть уровень логирования обратно к настройкам по умолчанию (INFO).

Скрипты располагаются в папке установки NAICE (по умолчанию - /etc/docker-naice).

Запуск скрипта technical_support.sh

Перед запуском скрипта убедитесь, что в Настройки системы → Решение проблем → Уровни логирования настроен глобальный уровень логирования DEBUG и включены расширенные логи сервиса RADIUS (при проблемах, связанных с RADIUS-авторизацией).

Если на момент возникновения проблемы действовала иная настройка, рекомендуется сначала изменить уровень логов на DEBUG и воспроизвести проблему заново.

Однохостовая установка

При установке NAICE через OVA-образ скрипт запускается по инструкции v1.2_3.2.5 Сбор логов с помощью скриптов траблшутинга.

Запуск скрипта выполняется командой: sudo <папка установки NAICE>/technical_support.sh. Выполнение скрипта может занять несколько минут. Результатом работы скрипта будет архив, расположенный в папке. в которой находился администратор в момент запуска скрипта в формате: <дата>_<время>_<имя хоста>_technical-support.tar.gz. Примеры:

$ sudo /etc/docker-naice/technical_support.sh
[+] Сбор статистики БД для контейнера: naice-postgres
[+] Top has finished.
[+] Stats on largest files collected.
[+] Collecting active certificates from cert-storage volumes...
[+] Active certificates collected.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2025-07-23_17-08-26_naice_technical-support.tar.gz

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

Схема с резервированием

При установке NAICE в кластерной схеме резервирования скрипт устанавливается на каждую VM участвующую в схеме. Может быть 4 VM: 2 NAICE + 2 PostgreSQL cluster или 2 VM: 2 NAICE + PostgreSQL cluster.

Требуется запустить скрипт сбора диагностической информации на каждой VM.

Имя финальных файлов для VM на которых развернут NAICE будут включать состояние мастерства VRRP хоста: <дата>_<время>_<имя хоста>_<MASTER|BACKUP|FAULT>technical-support.tar.gz. Примеры:

$ sudo /etc/docker-naice/technical_support.sh
[+] Stats on largest files collected.
[+] Top has finished.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2025-07-23_12-55-53_naice1_MASTER__technical-support.tar.gz

$ sudo /etc/docker-naice/technical_support.sh
[+] Stats on largest files collected.
[+] Top has finished.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2025-07-23_12-55-53_naice2_BACKUP__technical-support.tar.gz


$ sudo /etc/docker-naice/technical_support.sh
[+] Stats on largest files collected.
[+] Top has finished.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2025-07-23_16-55-45_naice2_FAULT__technical-support.tar.gz

Все полученные архивы необходимо выгрузить с серверов и приложить к заявке в SD.

Сбор матрицы DNS-разрешений имен контейнеров

Cбор матрицы DNS-разрешений имен контейнеров не выполняется по умолчанию. Чтобы включить ее сбор используйте флаг -d / --dns-diagnostics:

$ sudo /etc/docker-naice/technical_support.sh -d
[+] Сбор статистики БД для контейнера: naice-postgres
[+] Top has finished.
[+] Stats on largest files collected.
[+] Collecting active certificates from cert-storage volumes...
[+] Active certificates collected.
[+] Collecting DNS diagnostics of Docker environment...
[+] DNS diagnostics collected.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2026-10-09_09-27-02_naice-ubuntu24_technical-support.tar.gz

$ sudo /etc/docker-naice/technical_support.sh --dns-diagnostics
[+] Сбор статистики БД для контейнера: naice-postgres
[+] Top has finished.
[+] Stats on largest files collected.
[+] Collecting active certificates from cert-storage volumes...
[+] Active certificates collected.
[+] Collecting DNS diagnostics of Docker environment...
[+] DNS diagnostics collected.
[+] Archive created.

[+] Technical support data collection complete!
[+] Archive created: 2026-10-09_09-27-02_naice-ubuntu24_technical-support.tar.gz

Результаты DNS-диагностики сохраняются в папку dns_diagnostics/ внутри архива. dns_diagnostics_report.txt – это основной файл, содержащий журнал выполнения, общую сводку и описание всех собранных файлов. 

Дополнительно в папке dns_diagnostics/dns_matrix/ сохраняются:

  • expected.txt – эталонные IP-адреса контейнеров из docker inspect;

  • from_<container>.txt – результаты резолва из каждого контейнера;

  • matrix_view.txt – итоговая матрица в табличном виде.

Что дополнительно выполняет скрипт при запуске с флагом -d:

  1. Собирает эталонные IP-адреса всех запущенных контейнеров из docker inspect;

  2. Смотрит, как каждый запущенный контейнер видит имена других запущенных контейнеров через встроенный DNS Docker 127.0.0.11;

  3. Сравнивает полученные IP с реальными IP из docker inspect;

  4. Если IP не совпадают – помечает их как MISMATCH;

  5. Строит таблицу DNS-резолвинга matrix_view.txt. Это матрица, в которой:

    1. Строки – контейнеры, из которых выполняется запрос;

    2. Столбцы – имена контейнеров, которые резолвятся;

    3. значения ячеек: <ip> (OK), BAD:<ip> (ответ не совпал с эталоном), FAIL (в контейнере нет DNS-инструментов).

  6. Копирует local-kv.db – базу Docker network из <docker-root>/network/files/local-kv.db.

  7. Собирает журнал демона Docker за последние 48 часов с фильтром по error/fail/endpoint.