Поиск и устранение неисправностей

В этом разделе описаны способы поиска и устранения проблем.

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

Проверка состояния служб

Сервисы менеджера и агента управляются системным менеджером systemd:

ppem — служба менеджера.
ppem-agent — служба агента.

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

# systemctl status ppem
● ppem.service - PostgresPro Enterprise Manager
     Loaded: loaded (/lib/systemd/system/ppem.service; enabled; preset: enabled)
     Active: active (running) since Sat 2024-11-16 15:43:01 MSK; 48min ago
   Main PID: 53582 (ppem-manager)
      Tasks: 7 (limit: 3512)
     Memory: 226.9M
        CPU: 8.445s
     CGroup: /system.slice/ppem.service
             └─53582 /usr/sbin/ppem-manager -config /etc/ppem-manager.yml

Вывод статуса содержит:

ppem.service — имя и описание сервиса. Индикатор точки ("●") использует цветовую индикацию для подсветки общего состояния сервиса.

Белый цвет — нейтральное состояние "inactive" или "deactivating".

Красный цвет — состояние ошибки "failed" или "error".

Зеленый цвет — нормальное состояние "active", "reloading" или "activating".
Loaded — статус конфигурации сервиса, означающий, что конфигурация загружена в память и это нормальное состояние.
Active — статус выполнения сервиса, означающий, что сервис успешно запущен и активен в данный момент. Также рядом отображается время запуска и продолжительность выполнения.
Main PID — идентификатор и название главного процесса в списке процессов операционной системы.
Tasks — общее количество процессов и потоков, порожденных главным процессом.
Memory и CPU — использование системных ресурсов, памяти и процессорного времени.
CGroup — контрольная группа, в которую помещены процессы сервиса.
Дополнительно после основной секции будут отображаться последние записи служебных сообщений.

В нормальном состоянии сервисы менеджера и агентов должны быть в состоянии Active.

Проверка журналов сообщений

Службы менеджера и агента в процессе работы могут отправлять служебные сообщения. По умолчанию и менеджер и агент используют стандартный вывод (stdout) для отправки служебных журналов и сообщений. Сообщения перехватываются средствами systemd и могут быть просмотрены с помощью journalctl:

# journalctl -u ppem
...

Для вывода поступающих новых сообщений доступна опция -f:

# journalctl -fu ppem
...

Настройка уровня детализации журналирования

Журналирование имеет несколько уровней детализации:

error — журналирование только ошибок.
warning — журналирование ошибок и предупреждений.
info — журналирование ошибок, предупреждений и информативных сообщений. Этот уровень используется по умолчанию.
debug — журналирование ошибок, предупреждений, информативных сообщений и отладочных сообщений.

Настройка журналирования выполняется в файлах конфигурации /etc/ppem-manager.yml и /etc/ppem-agent.yml в параметре log.level. Изменения настроек журналирования вступают в силу после перезапуска службы.