Журналы KUMA

В KUMA предусмотрены следующие типы журналов:

• Журналы установщика.
• Журналы компонентов.

Вы также можете создать отчет с диагностическими данными о вашем устройстве с помощью утилиты collect.sh. Подробную информацию о работе с утилитой см. в Базе знаний.

Журналы установщика

KUMA автоматически создает файлы с журналами установки, изменения конфигурации или удаления.

Журналы хранятся в директории ./log/ в директории установщика. В названии файла журнала используется дата и время запуска соответствующего скрипта.

Названия формируются в следующих форматах:

• Журнал установки: install-YYYYMMDD-HHMMSS.log, например install-20231031-102409.log.
• Журналы удаления: uninstall-YYYYMMDD-HHMMSS.log, например uninstall-20231031-134011.log.
• Журналы изменения конфигурации: expand-YYYYMMDD-HHMMSS.log, например expand-20231031-105805.log.

При каждом запуске скрипта установки, изменения конфигурации или удаления решение создает новый файл. Ротация или автоматическое удаление журналов не предусмотрено.

Журнал содержит строки файла инвентаря, использованного при вызове соответствующей команды, и журнал ansible. Для каждой задачи последовательно отображается время запуска задачи (Вторник 31 октября 2023 10:29:14 +0300), время выполнения предыдущей задачи (0:00:02.611) и общее время с момента запуска установки, изменения конфигурации или удаления (0:04:56.906).

Журналы компонентов

По умолчанию для всех компонентов KUMA в журнале регистрируются только ошибки. Чтобы получать детализированные данные в журналах, следует настроить в параметрах компонента режим Отладка.

Журнал Ядра KUMA пополняется до максимального размера 5 ГБ или до достижения максимального срока жизни 7 дней в зависимости от того, что наступит раньше. Журналы остальных компонентов KUMA пополняются, пока файл не достигнет размера 5 ГБ. После этого журнал архивируется, и события начинают записываться в новый журнал. Каждый архив журнала хранится в течение 7 дней, после этого архив удаляется. Одновременно на сервере хранится не более 4 архивов журнала каждого компонента. При создании пятого архива самый старый архив удаляется.

Режим Отладка доступен для следующих объектов:

Просмотр журналов Ядра в Kubernetes

Файлы журналов Ядра KUMA архивируются, по достижении 100 МБ записывается новый журнал. Одновременно хранится не более 5 файлов. При появлении нового журнала, если становится больше 5 файлов, самый старый файл удаляется.

На рабочих узлах можно просмотреть журналы контейнеров и подов, размещенных на этих узлах, в файловой системе узла, например:

/var/log/pods/kuma_core-deployment-<UID>/core/*.log

Чтобы просмотреть журналы контейнера:

k0s kubectl logs -l app=core -n kuma

Чтобы включить просмотр журналов в реальном времени, добавьте ключ -f:

k0s kubectl logs -f -l app=core -n kuma

Чтобы просмотреть журналы предыдущего пода, который был замещен новым (например, при восстановлении после критической ошибки или после повторного развертывания), добавьте ключ --previous:

k0s kubectl logs -l app=core -n kuma --previous

Для доступа к журналам с других хостов, не входящих в кластер, требуется файл k0s-kubeconfig.yml с реквизитами доступа, который создается при установке KUMA, и локально установленная утилита управления кластером kubectl. Файл k0s-kubeconfig.yml создается в директории artifacts внутри директории с установщиком. Контроллер кластера или балансировщик трафика, указанные в параметре server файла k0s-kubeconfig.yml, должны быть доступны по сети.

Путь к файлу необходимо экспортировать в переменную: 

export KUBECONFIG=/<путь к файлу>/k0s-kubeconfig.yml

Для просмотра журналов воспользуйтесь утилитой kubeclt:

kubectl logs -l app=core -n kuma