Утилита сбора логов и диагностической информации ls-sos-report

Пакет ls-sos-report содержит утилиту /usr/sbin/ls-sos-report, которая используется для сбора информации о системе и продуктах хостинговой редакции МСВСфера ОС на сервере, где эта утилита запускается. Запуск утилиты ls-sos-report осуществляется пользователем вручную, в конфиграции по умолчанию автоматический запуск утилиты не предусмотрен. Утилита ls-sos-report использует утилиту sos из пакета sos для сборка информации о системе. Утилита ls-sos-report генерирует файл архива, который содержит собранную информацию. Этот архив может быть передан службе поддержки МСВСфера ОС для диагностики проблем на сервере пользователя. Дополнительно генерируется файл с контрольной суммой sha256 для файла архива. По умолчанию эти файлы создаются в директории /var/tmp.

Утилита ls-sos-report поддерживает все опции команды sos report. Эти опции можно указывать в командной строке при вызове утилиты ls-sos-report, они передаются в утилиту sos при вызове утилиты ls-sos-report без изменений.

Описание всех поддерживаемых опций можно получить по команде man sos-report.

При запуске утилиты ls-sos-report без параметров, она запускается в интерактивном режиме. При этом в консоль выводится стандартное приглашение утилиты sos. Пользователю предлагается нажать CTRL-C для завершения программы или ENTER для продолжения. После нажатия ENTER программа запрашивает идентификатор ошибки или отчёта об ошибке (баг репорта (bug report)) в системе отслеживания ошибок МСВСфера ОС, этот идентификатор будет включён в имя создаваемого утилитой архива. Если такой идентификатор отсутствует или неизвестен, то можно ничего не указывать и нажать ENTER. Далее выполнение программы продолжится, будет выполнен сбор информации о системе и создание файла архива с этой информацией, а также файла контрольной суммы архива.

Для запуска утилиты ls-sos-report в неинтерактивном режиме (без запроса ввода от пользователя) можно использовать опцию --batch.

$ sudo ls-sos-report --batch

Чтобы указать идентификатор ошибки или отчёта об ошибке в системе отслеживания ошибок МСВСфера ОС, можно использовать опцию --label. Этот идентификатор будет включён в имя создаваемого утилитой архива.

$ sudo ls-sos-report --label=ISSUE-8942

Чтобы снизить нагрузку на систему, создаваемую утилитой ls-sos-report, можно использовать опцию --low-priority. Эта опция устанавливает низкий приоритет (niceness=19), а также снижает приоритет операций ввода-вывода для процесса сбора данных, чтобы он не влиял на другие процессы в системе.

$ sudo ls-sos-report --low-priority

Путь к директории, где будут созданы файл архива и файл контрольной суммы, можно изменить при помощи опции --tmp-dir.

$ sudo ls-sos-report --tmp-dir=/root

Размер собираемых данных для файлов журналов или вывода команд по умолчанию ограничен размером 25Mb. Если файл данных или вывод команды больше этого значения, то в архив сохраняется только конец файла или вывода команды при помощи команды tail чтобы удовлетворить ограничение. Это ограничение на размер собираемых данных можно изменить при помощи опции --log-size, указав новое значение в мегабайтах. Если указать значение 0, то это отменяет ограничение на размер собираемых данных, что может привести к очень сильному увеличению размера файла.

$ sudo ls-sos-report --log-size=10

Размер собираемых данных для файлов журналов по умолчанию ограничен размером в 100Mb. Если файл журнала больше этого значения, то в архив сохраняется конец файла при помощи команды tail чтобы удовлетворить ограничение. Это ограничение на размер собираемых данных можно изменить при помощи опции --journal-size, указав новое значение в мегабайтах. Если указать значение 0, то это отменяет ограничение на размер собираемых данных, что может привести к очень сильному увеличению размера файла архива.

$ sudo ls-sos-report --journal-size=50

Чтобы убрать ограничение на размер всех (любых) собираемых данных, можно использовать опцию --all-logs.

$ sudo ls-sos-report --all-logs

Чтобы не выполнять сбор общей информации о системе и выполнить сбор информации только по продуктам МСВСфера 9 Сервер редакция для хостинг-провайдеров (это уменьшит размер архива), запустите только один плагин hosting, выполнив команду:

$ sudo sos report -o hosting

Чтобы выполнить сбор максимально подробной информации обо всех компонентах системы, выполните команду:

$ sudo sos report

Плагин hosting для утилиты sos собирает следующую информацию:

  • сведения о конфигурации продуктов хостинговой редакции ОС МСВ Сфера

  • информацию о конфигурации веб-серверов Apache и nginx

  • логи для продуктов хостинговой редакции ОС МСВ Сфера

  • логи панели управления ispmanager

  • информацию о rpm-пакетах, установленных в системе

  • сведения о дисковых устройствах

  • сведения о пользователях и группах пользователей

  • сведения о процессах, которые работают на сервере

  • и прочую диагностическую информацию

Утилита ls-sos-report собирает, в дополнение к перечисленному выше, такую информацию:

  • конфигурация cgroups

  • конфигурация cron

  • дата и время

  • конфигурация пакетного менеджера DNF

  • конфигурация файловых систем

  • сведения о ядре Linux

  • список файлов системных библиотек

  • сведения об оперативной памяти и ее использовании

  • конфигурация сервера nginx

  • настройки PAM

  • сведения о процессоре (CPU)

  • сведения о процессах, которые работают на сервере

  • данные о конфигурации и производительности сервера (pcp, sar, monit и т.п.)

  • сведения об интерпретаторе python и его пакетах

  • сведения о настройках SELINUX

  • сведения о сервисах systemd

  • конфигурация tuned

  • конфигурация fapolicyd

  • конфигурация kpatch

  • сведения о memcached

  • и прочую диагностическую информацию

Не собирается информация: пароли, ssh-ключи.