Облачная платформаEvolution

Клиентские логи сервиса Managed PostgreSQL®


Клиентские логи сервиса Managed PostgreSQL® содержат детальную техническую информацию о событиях управления кластером. Они позволяют отслеживать ошибки в работе сервисов и приложений, находить узкие места и быстро реагировать на инциденты.

Примечание

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

Включение логирования

Сервис Managed PostgreSQL® передает логи по умолчанию в лог-группу default.

Вы можете выбрать лог-группу при создании кластера.

Просмотр и фильтрация логов

Логи передаются и хранятся централизованно в сервисе «Клиентское логирование».

Для просмотра логов перейдите в раздел личного кабинета Мониторинг → Логирование → Просмотр логов и выберите лог-группу, указанную при создании кластера.

По умолчанию отображаются логи всех сервисов и ресурсов.

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

Ниже описаны уровни лога и метки, которые передает сервис Managed PostgreSQL®.

Уровни логов

Фильтрация по уровням логов позволяет классифицировать логи по важности и срочности реагирования.

В таблицах показано соответствие нативных уровней логирования PostgreSQL и PgBouncer уровням сервиса «Клиентское логирование».

PostgreSQL

Уровень PostgreSQL

Уровень в логах

DEBUG1 - DEBUG5

DEBUG

INFO

INFO

NOTICE

NOTICE

WARNING

NOTICE

ERROR

WARN

LOG

INFO

FATAL

ERROR

PANIC

CRITICAL

PgBouncer

Уровень PgBouncer

Уровень в логах

DEBUG

DEBUG

NOISE

TRACE

LOG

INFO

WARNING

WARN

FATAL

FATAL

ERROR

ERROR

Метки сервиса

Метки передаются в поле labels и позволяют детализировать запрос. Формат обращения к метке в выражении: labels.<label-name>="value".

Для фильтрации записей сервиса Managed PostgreSQL® применяются следующие метки.

Название метки

Описание

Значение

product_type

Название сервиса

postgres

cluster_id

Идентификатор кластера

—

cluster_name

Название кластера

—

postgres_component

Компонент PostgreSQL

  • database — база данных.

  • pooler — пулер соединений.

postgres_instance_role

Текущая роль узла в кластере

  • primary — основной узел (чтение и запись).

  • replica — реплика (только чтение).

postgres_instance_index

Порядковый номер узла внутри кластера.

Строка, нумерация начинается с 1.

Примеры запросов

Примеры запросов к логам для решения частых задач Managed PostgreSQL®:

  • Логи кластера по названию:

    labels.product_type="postgres" AND labels.cluster_name="<cluster_name>"

    Где <cluster_name> — название кластера.

  • Потенциальные проблемы кластера:

    labels.product_type="postgres" AND labels.cluster_id="<cluster_id>" AND level in ["NOTICE", "WARN", "ERROR", "CRITICAL", "FATAL"]

    Где <cluster_id> — идентификатор кластера.

  • Проблемы PgBouncer:

    labels.product_type="postgres" AND labels.cluster_id="<cluster_id>" AND labels.postgres_component="pooler" AND level in ["WARN", "ERROR", "FATAL"]
  • Логи с реплик:

    labels.product_type="postgres" AND labels.cluster_id="<cluster_id>" AND labels.postgres_instance_role="replica"
  • Логи конкретного хоста:

    labels.product_type="postgres" AND labels.cluster_id="<cluster_id>" AND labels.postgres_component="database" AND labels.postgres_instance_index="2"

Отправка уведомлений о событиях в логах

На основе логов вы можете настроить уведомление о событиях или отклонениях в работе сервиса. Это позволит оперативно реагировать на инциденты, сбои и ошибки, а также снизить время простоя.

Чтобы настроить уведомления:

  1. Настройте правила алертов.

  2. Настройте рассылки уведомлений в случае срабатывания правил.