diag

Сбор диагностической информации о сервере в архив для передачи в техподдержку

Примечание

Команда собирает в один архив:

  • Версию сервера rude relay --version

  • Конфигурационные файлы (/etc/default/rudesktop, /etc/relay.cfg, /etc/rudesktop-relay.toml, /etc/rudesktop/settings, /etc/hosts) — пароли и секреты вырезаются

  • Текущие значения rude constance (тоже без секретов)

  • Список устройств по типу ОС из таблицы peers_server

  • Конфиги peers_relay

  • Информацию об ОС, hostname, аппаратном и сетевом обеспечении

  • Список установленных пакетов

  • Логи сервера (/var/log/rudesktop/), nginx (/var/log/nginx/), syslog, PostgreSQL и /var/log/messages

Зачем нужна

Команда собирает «диагностический пакет» сервера для технической поддержки RuDesktop — конфиги, логи, версии, состояние ОС и БД — в один архив. Перед упаковкой автоматически вырезает пароли и секреты из конфигов; при необходимости архив можно зашифровать GPG-паролем для безопасной передачи

Типичные случаи применения:

  • обращение в техническую поддержку: одной командой собрать всё нужное, не выискивая логи и конфиги вручную

  • разбор инцидента собственными силами — снимок состояния сервера на момент проблемы

  • передача данных стороннему специалисту по защищённому каналу с шифрованием через -P

  • архивирование снимков состояния сервера по расписанию для последующего разбора

Синтаксис

rude diag [-o out_dir] [-P password]

Параметры

Параметр

Описание

-o

Каталог, в который сохранится архив (по умолчанию /tmp/)

-P

Пароль для шифрования архива (используется GPG). При наличии флага архив сохраняется в формате .tar.gz.gpg

Важно

Без указания -P архив сохраняется в формате .tar.gz. С паролем — архив шифруется через GPG и сохраняется как .tar.gz.gpg. Чтобы распаковать зашифрованный архив:

gpg --decrypt rude_diag_<дата>.tar.gz.gpg | tar -xzvf -

Пример

  1. Чтобы выполнить сбор диагностики без указания пути и пароля, введите следующее:

    rude diag

    Архив будет сохранён по пути /tmp/rude_diag_[ДАТА]_[ВРЕМЯ].tar.gz

  2. Чтобы указать другой каталог для архива:

    rude diag -o /home/user

    Архив будет сохранён в /home/user/rude_diag_[ДАТА]_[ВРЕМЯ].tar.gz

  3. Чтобы создать зашифрованный архив с паролем:

    rude diag -P 123456

    Архив будет сохранён по пути /tmp/rude_diag_[ДАТА]_[ВРЕМЯ].tar.gz.gpg

  4. С указанием каталога и пароля:

    rude diag -o /home/user -P 123456

    Архив будет сохранён в /home/user/rude_diag_[ДАТА]_[ВРЕМЯ].tar.gz.gpg