Диагностика производительности в Managed Service for PostgreSQL
Managed Service for PostgreSQL предоставляет встроенный инструмент для диагностики производительности кластера СУБД. Этот инструмент помогает анализировать метрики производительности PostgreSQL для сессий и запросов.
Активировать сбор статистики
Включите опцию Сбор статистики при создании кластера или изменении его настроек (по умолчанию опция отключена).
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы включить сбор статистики, передайте параметр --performance-diagnostics
в команде изменения кластера:
yc managed-postgresql cluster update <имя_или_идентификатор_кластера> \
...
--performance-diagnostics enabled=true,`
`sessions-sampling-interval=<интервал_сбора_сессий>,`
`statements-sampling-interval=<интервал_сбора_запросов> \
...
Допустимые значения параметров:
sessions-sampling-interval
— от1
до86400
секунд.statements-sampling-interval
— от60
до86400
секунд.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
Полный список доступных для изменения полей конфигурации кластера Managed Service for PostgreSQL см. в документации провайдера Terraform
. -
Чтобы настроить сбор статистики, добавьте в блок
config
блокperformance_diagnostics
:resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" { ... config { ... performance_diagnostics { enabled = <активация_сбора_статистики> sessions_sampling_interval = <интервал_сбора_сессий> statements_sampling_interval = <интервала_сбора_запросов> } ... } ... }
Где:
enabled
— активация сбора статистики:true
илиfalse
.sessions_sampling_interval
— интервал сбора сессий от1
до86400
секунд.statements_sampling_interval
— интервала сбора запросов от60
до86400
секунд.
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
Ограничения по времени
Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for PostgreSQL:
- создание, в том числе путем восстановления из резервной копии, — 30 минут;
- изменение — 60 минут;
- удаление — 15 минут.
Операции, длящиеся дольше указанного времени, прерываются.
Как изменить эти ограничения?Добавьте к описанию кластера блок
timeouts
, например:resource "yandex_mdb_postgresql_cluster" "<имя_кластера>" { ... timeouts { create = "1h30m" # Полтора часа update = "2h" # 2 часа delete = "30m" # 30 минут } }
-
Чтобы включить сбор статистики, воспользуйтесь методом REST API create или update для ресурса Cluster или вызовом gRPC API ClusterService/Create или ClusterService/Update и передайте в запросе:
-
Идентификатор кластера в параметре
clusterId
.Идентификатор можно получить со списком кластеров в каталоге.
-
Значение
true
в параметреconfig.performanceDiagnostics.enabled
. -
Интервал сбора сессий в параметре
config.performanceDiagnostics.sessionsSamplingInterval
. Допустимые значения — от1
до86400
секунд. -
Интервал сбора запросов в параметре
config.performanceDiagnostics.statementsSamplingInterval
. Допустимые значения — от60
до86400
секунд. -
Список полей конфигурации кластера, подлежащих изменению, в параметре
updateMask
.
Важно
Этот метод API сбросит все настройки кластера, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, обязательно передайте название полей, подлежащих изменению, в параметре updateMask
.
Получить статистику по сессиям
- В консоли управления
перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL. - Нажмите на имя нужного кластера и выберите вкладку Диагностика производительности → Сессии.
Для просмотра статистики по сессиям:
- Задайте интересующий временной интервал.
- (Опционально) Настройте фильтры.
- Выберите нужный срез данных.
Чтобы показать или скрыть отдельные категории, нажмите на имя категории в легенде графика.
Для просмотра истории запросов в рамках сессии:
- Задайте интересующий временной интервал.
- (Опционально) Настройте фильтры.
Чтобы получить статистику по сессиям, воспользуйтесь вызовом gRPC API PerformanceDiagnosticsService/ListRawSessionStates и передайте в запросе:
-
Идентификатор кластера в параметре
cluster_id
.Идентификатор можно получить со списком кластеров в каталоге.
-
Период, за который надо запросить данные:
- начало периода в параметре
from_time
; - конец периода в параметре
to_time
.
- начало периода в параметре
-
Параметры пагинации:
- максимально допустимое количество результатов на одной странице в параметре
page_size
; - токен предыдущей страницы с результатами для получения следующей страницы в параметре
page_token
.
- максимально допустимое количество результатов на одной странице в параметре
Подробнее про отображаемые сведения см. в документации PostgreSQL
Получить статистику по запросам
- В консоли управления
перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL. - Нажмите на имя нужного кластера и выберите вкладку Диагностика производительности → Запросы.
Для просмотра статистики запросов за интервал:
- Выберите интересующий временной интервал.
- (Опционально) Настройте фильтры.
Чтобы получить сведения об относительном изменении статистических характеристик запросов:
- В поле Интервал 1 выберите временной интервал, статистика за который будет основой для расчетов.
- В поле Интервал 2 выберите временной интервал, статистика за который будет сравниваться со статистикой первого интервала.
- (Опционально) Настройте фильтры.
Например, пусть в первом интервале было выполнено 10 запросов SELECT * FROM cities
, а во втором — 20. Тогда при сравнении статистических данных разница по метрике количество запросов
(столбец Calls
в таблице) будет равняться +100%
.
Чтобы получить статистику по запросам, воспользуйтесь вызовом gRPC API PerformanceDiagnosticsService/ListRawStatements и передайте в запросе:
-
Идентификатор кластера в параметре
cluster_id
.Идентификатор можно получить со списком кластеров в каталоге.
-
Период, за который надо запросить данные:
- начало периода в параметре
from_time
; - конец периода в параметре
to_time
.
- начало периода в параметре
-
Параметры пагинации:
- максимально допустимое количество результатов на одной странице в параметре
page_size
; - токен предыдущей страницы с результатами для получения следующей страницы в параметре
page_token
.
- максимально допустимое количество результатов на одной странице в параметре
Подробнее про отображаемые сведения см. в документации расширений pg_stat_statements
Получить информацию о плане выполнения запроса
Модуль auto_explain
EXPLAIN
Чтобы включить логирование запросов, измените настройки СУБД:
-
В поле Shared preload libraries выберите значение
auto_explain
. -
Включите настройку Auto explain log analyze.
-
Задайте настройки модуля
auto_explain
:Важно
Установка значения
0
для настройки Auto explain log min duration или включение настройки Auto explain log timing могут существенно снизить производительность кластера.