Сбор диагностической информации (collect-logs)

Утилита collect-logs собирает в архив логи и сведения о состоянии узла и кластера Nova Container Platform. Архив можно передать в техническую поддержку для анализа неполадки.

Утилита установлена на каждом узле кластера по пути /bin/collect-logs. Это не команда nova-ctl: утилита запускается непосредственно на узле кластера с правами root (через sudo).

1. Режимы сбора данных

За один запуск утилита работает в одном из следующих режимов:

-a — сбор всех данных. На мастер-узле собираются сведения о состоянии кластера и логи узла, на остальных узлах — только логи узла.
-k — сбор только сведений о состоянии Kubernetes: вывод kubectl cluster-info dump, списки узлов и подов, журнал аудита API-сервера, состояние etcd. Режим работает только на мастер-узле.
-l — сбор только логов и файлов узла.
--help или запуск без параметров — вывод справки.

Параметр -d <директория> задает директорию, в которую будет сохранен архив. Значение по умолчанию: /tmp. Если указанной директории нет, она будет создана.

Справка утилиты

$ collect-logs --help

Nova Container Platform (c) Orionsoft

A tool for gathering diagnostic data from clusters and nodes.
The collected data is saved to a corresponding archive in the specified directory.
All confidential information is excluded.

Options:
  -a Collect all logs (cluster-info dump and node logs)
  -k Collect kubernetes logs (cluster-info dump)
  -l Collect node logs
  -d <directory> Save the collected bundle to the specified directory (default: /tmp)

2. Запуск сбора данных

Подключитесь к узлу кластера по SSH. Чтобы собрать сведения о состоянии кластера, подключитесь к мастер-узлу.
Запустите утилиту в нужном режиме:
```
sudo collect-logs -a -d /var/tmp/nova-support
```
Дождитесь завершения работы утилиты. Архив будет сохранен в указанной директории с именем следующего вида:
```
<директория>/nova-logs-<FQDN узла>_<ДД-ММ-ГГГГ>.tar.gz
```
Передайте архив в техническую поддержку.

При запуске утилита удаляет из выбранной директории архивы, созданные ранее на этом же узле.
В режиме -k на узле, который не является мастер-узлом, утилита ничего не собирает и не выводит никаких сообщений.
Для работы утилиты на диске узла должно быть достаточно свободного места под временную копию директории /var/log.

3. Содержимое архива

В архив попадают:

директории /var/log, /etc/kubernetes, /opt/nova/conf.d, /opt/nova/manifests;
конфигурация containerd;
список подключенных репозиториев и установленных пакетов ОС;
сетевые маршруты и сокеты;
сведения о дисках и памяти;
вывод dmesg;
ошибки из журнала systemd (система, kubelet, containerd);
статусы служб;
факты Puppet.

Файлы .key, .pem и *admin.conf в архив не попадают.

4. Логи Nova Universe

Получение логов сервера управления Nova Universe описано в разделе Получение логов из Nova Universe.