Глава 7. Поиск и устранение неполадок

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

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

Службы менеджера и агентов управляются системным менеджером 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 — ошибки, предупреждения, информационные и отладочные сообщения.

Журналирование можно настроить в файлах конфигурации менеджера ppem-manager.yml и агента ppem-agent.yml с помощью параметра log.level.

Изменения параметров журналирования вступают в силу после перезапуска службы.