8.3. Анализ файлов журнала службы управления Postgres ProGate #

Журналы службы управления Postgres ProGate можно получить командой journalctl -u progate.service.

Журналы не должны содержать ошибок. Если служба управления запущена корректно, записи журнала выглядят примерно так:

10:08AM INF goose: successfully migrated database to version: 20260310150000
0:08AM INF pprof handlers registered
10:08AM INF pprof handlers registered
10:08AM INF static files handler registered
10:08AM INF app starts with version version=1.1.0 date_build=2026-03-16:13:07:07 branch=HEAD hash=b318e80c
10:08AM INF server started port=8081
10:08AM INF process monitor started
10:08AM INF notifier service started
10:08AM INF password expiration reporter started
10:08AM INF transfer scheduler started

Если возникают ошибки при запуске или работе службы управления, журнал предоставляет диагностическую информацию, представленную в Таблице 8.1.

Таблица 8.1. Основные ошибки службы управления Postgres ProGate

ОшибкаОписаниеДействия по исправлению
10:11AM ERR failed to notify error="notifier: notify: notifier: process new security events: txman: begin tx: failed to connect to user=masked database=progate: 172.18.0.1:5450 (172.18.0.1): dial error: dial tcp 172.18.0.1:5450: connect: connection refused" service=notifierВ процессе работы службы управления было потеряно соединение со служебной базой данных.Проверьте работоспособность и доступность служебной базы данных. Служба управления автоматически восстанавливает соединение, когда база данных становится вновь доступной.
10:17AM ERR Failed to initialize app err="app: init app: provide db: failed to connect to user=masked database=dbaas: 172.18.0.1:5450 (172.18.0.1): dial error: dial tcp 172.18.0.1:5450: connect: connection refused"В процессе запуска службы управления возникла ошибка подключения к служебной базе данных.Проверьте параметры подключения в конфигурации службы управления и доступность служебной базы данных. Для восстановления работоспособности требуется перезапустить службу.
10:20AM ERR Failed to initialize app err="(SQLSTATE: 28000): invalid credentials"Указаны некорректные учётные данные для подключения к служебной базе данных.Проверьте имя пользователя и пароль для подключения к служебной базе данных.
2026/04/08 10:36:06 ERROR Failed to initialize app err="app: init app: provide config: config validation failed: config: validate: Key: 'Config.Fields.Auth.AccessTokenSecret' Error:Field validation for 'AccessTokenSecret' failed on the 'min' tag: Key: 'Config.Fields.Auth.AccessTokenSecret' Error:Field validation for 'AccessTokenSecret' failed on the 'min' tag"Ошибка при проверке параметров конфигурации.Исправьте конфигурацию службы управления. В данном примере значение AccessTokenSecret ниже минимально требуемого. За подробностями обратитесь к Таблице 3.1.