IKuznetsov в 14:24, 28 октября 2025

2025-10-28T14:24:58Z

← Предыдущая		Версия 14:24, 28 октября 2025
Строка 1:		Строка 1:
			{\| class="wikitable"
			!Версия
			!Изменения
			\|-
			\|1.2.0
			\|Улучшения:

			* Мониторинг баз данных был улучшен для поддержки всех версий Postgres, начиная с 11. Ранее он работал только для Postgres 14+.
			* Все показатели были привязаны к соответствующему типу сущности, чтобы обеспечить корректное отображение показателей при активации менеджмент зон и фильтрации по сущности.

			Исправления ошибок:

			* <code>client_port</code> измерение было удалено из следующих метрик, поскольку поле не несет ценной информации и является слишком изменчивым, что приводит к созданию слишком большого количества отдельных временных рядов.
			** <code>postgres.activity.active</code>
			** <code>postgres.activity.fastpath_function_call</code>
			** <code>postgres.activity.idle_in_transaction_aborted</code>
			** <code>postgres.activity.idle_in_transaction</code>
			** <code>postgres.activity.idle</code>
			\|-
			\|1.1.0
			\|Новые функции:

			* Новые наборы функций
			* Новый тип топологии: табличное пространство
			* Метрика разности WAL
			* Видимость на уровне запроса для самых длительных запросов
			* Новые метрики и диаграммы на экранах сущностей

			Исправления ошибок:

			* Дублирующиеся топологические сущности
			* Неправильные типы метрик
			* Неправильная метрика восстановления
			* Ссылки на панель инструментов и экраны сущностей
			\|-
			\|1.0.3
			\|
			* Исправление изменения схемы
			\|-
			\|1.0.2
			\|
			* Исправлена ссылка на конфигурации в обзорной панели.
			\|-
			\|1.0.1
			\|Начало поддержки расширения PostgreSQL
			\|}

	== Обзор ==		== Обзор ==
	Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга, реализованном в виде расширения Ключ-АСТРОМ АктивногоШлюза. Расширение запрашивает ключевые показатели производительности и работоспособности баз данных '''Postgres'''. Затем искусственный интеллект от Ключ-АСТРоМ анализирует эти показатели для выявления отклонений и проблем.		Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга, реализованном в виде расширения Ключ-АСТРОМ АктивногоШлюза. Расширение запрашивает ключевые показатели производительности и работоспособности баз данных '''Postgres'''. Затем искусственный интеллект от Ключ-АСТРоМ анализирует эти показатели для выявления отклонений и проблем.

IKuznetsov: Новая страница: «== Обзор == Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга,...»

2025-10-28T08:44:31Z

Новая страница: «== Обзор == Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга,...»

Новая страница

== Обзор ==
Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга, реализованном в виде расширения Ключ-АСТРОМ АктивногоШлюза. Расширение запрашивает ключевые показатели производительности и работоспособности баз данных '''Postgres'''. Затем искусственный интеллект от Ключ-АСТРоМ анализирует эти показатели для выявления отклонений и проблем.

== Варианты использования ==

* Контролируйте состояние работоспособности и производительность своей настройки '''PostgreSQL'''.
* Обнаруживайте аномалии и оповещайте о них.
* Примите превентивные меры для предотвращения проблем в обслуживании.

=== Мониторинг популярных запросов ===
Если мониторинг логов Ключ-АСТРОМ включён и <code>pg_stat_statements</code> представление доступно, Ключ-АСТРОМ будет собирать '''100''' самых популярных запросов (отсортированных по общему времени выполнения) каждые 5 минут и сохранять их в виде логов. Эти логи доступны либо на экране экземпляра базы данных, либо в приложении '''Базы данных''' в разделе '''Топ-запросов по общему времени выполнения'''.

Чтобы отфильтровать эти запросы на дашборде или в блокноте, можно использовать фильтры по <code>dt.extension.name = com.astromkey.extension.postgres</code> и <code>event.group = top_queries</code>. Ниже представлен пример '''DQL-запроса''':
fetch logs
| filter dt.extension.name=="com.astromkey.extension.postgres" and event.group=="top_queries"
| sort total_exec_time desc
Независимо от того, <code>pg_stat_statements</code> доступно это или нет, Ключ-АСТРОМ все равно будет собирать запросы <code>pg_stat_activity</code> как часть набора функций <code>Queries</code>, которые аналогичным образом поступают в виде логов с <code>event.group = longest_queries</code>.

=== Получение деталей плана выполнения ===
Для пользователей '''SaaS''', имеющих доступ к приложению '''Базы данных''' и включённых функциях мониторинга самых популярных запросов (см. предыдущий раздел), доступна функция получения планов выполнения для этих запросов. Это можно сделать в приложении '''Базы данных''' в разделе <code>Statement performance</code>, щёлкнув <code>Request</code> по плану выполнения конкретного запроса.

Для этого <code>query</code> расширение попытается выполнить следующее:
SELECT * from astromkey.astromkey_execution_plan({query})
и затем загрузить в Ключ-АСТРОМ первую строку столбца с именем <code>explain</code>. Эти планы выполнения загружаются в виде логов с <code>event.group = execution_plans</code>.

== Начать ==

=== Активация ===
''Действия по активации удаленного мониторинга'' (версия '''1.255+'''):

* Активируйте расширение в Ключ-АСТРОМ, перейдя по ссылке:
* Ключ-АСТРОМ → Расширения → PostgreSQL → Добавить в среду
* Добавить новую конфигурацию мониторинга

=== Требования ===

* Должно быть установлено соединение между АктивнымШлюзом, где развернуто расширение, и базой данных '''Postgres'''.
* Необходимо предоставить пользователю базы данных соответствующие разрешения.

Пример:
CREATE USER astromkey WITH PASSWORD '<PASSWORD>' INHERIT;
GRANT pg_monitor TO astromkey;
Для мониторинга самых популярных запросов:

* <code>pg_stat_statements</code> просмотр (должен быть включен) [ https://www.postgresql.org/docs/current/pgstatstatements.html#PGSTATSTATEMENTS ].
* <code>pg_stat_statements.track_planning</code> должен быть включен, чтобы разрешить выборку планов.

Для мониторинга деталей плана исполнения:

* В базе данных должна быть создана специальная функция <code>astromkey.astromkey_execution_plan</code>, к которой вы будете подключаться и из которой будут извлекаться планы выполнения.

CREATE SCHEMA astromkey;
CREATE OR REPLACE FUNCTION astromkey.astromkey_execution_plan(
<nowiki> </nowiki> query text,
<nowiki> </nowiki> OUT explain JSON
) RETURNS SETOF JSON
<nowiki> </nowiki> LANGUAGE plpgsql
<nowiki> </nowiki> VOLATILE
<nowiki> </nowiki> RETURNS NULL ON NULL INPUT
<nowiki> </nowiki> SECURITY DEFINER
<nowiki> </nowiki> ROWS 1
<nowiki> </nowiki> SET plan_cache_mode = force_generic_plan
AS
$$DECLARE
<nowiki> </nowiki> arg_count integer;
<nowiki> </nowiki> open_paren text;
<nowiki> </nowiki> close_paren text;
<nowiki> </nowiki> explain_cmd text;
<nowiki> </nowiki> json_result json;
BEGIN

<nowiki> </nowiki> /* reject statements containing a semicolon in the middle */
<nowiki> </nowiki> IF pg_catalog.strpos(
<nowiki> </nowiki> pg_catalog.rtrim(astromkey_execution_plan.query, ';'),
<nowiki> </nowiki> ';'
<nowiki> </nowiki> ) OPERATOR(pg_catalog.>) 0 THEN
<nowiki> </nowiki> RAISE EXCEPTION 'query string must not contain a semicolon';
<nowiki> </nowiki> END IF;

<nowiki> </nowiki> /* get the parameter count */
<nowiki> </nowiki> SELECT count(*) INTO arg_count
<nowiki> </nowiki> FROM pg_catalog.regexp_matches( /* extract the "$n" */
<nowiki> </nowiki> pg_catalog.regexp_replace( /* remove single quoted strings */
<nowiki> </nowiki> astromkey_execution_plan.query,
<nowiki> </nowiki> <nowiki>'''</nowiki>[^<nowiki>''</nowiki>]*<nowiki>'''</nowiki>,
<nowiki> </nowiki> <nowiki>''</nowiki>,
<nowiki> </nowiki> 'g'
<nowiki> </nowiki> ),
<nowiki> </nowiki> '\$\d{1,}',
<nowiki> </nowiki> 'g'
<nowiki> </nowiki> );

<nowiki> </nowiki> IF arg_count OPERATOR(pg_catalog.=) 0 THEN
<nowiki> </nowiki> open_paren := <nowiki>''</nowiki>;
<nowiki> </nowiki> close_paren := <nowiki>''</nowiki>;
<nowiki> </nowiki> ELSE
<nowiki> </nowiki> open_paren := '(';
<nowiki> </nowiki> close_paren := ')';
<nowiki> </nowiki> END IF;

<nowiki> </nowiki> /* construct a prepared statement */
<nowiki> </nowiki> EXECUTE
<nowiki> </nowiki> pg_catalog.concat(
<nowiki> </nowiki> 'PREPARE _stmt_',
<nowiki> </nowiki> open_paren,
<nowiki> </nowiki> pg_catalog.rtrim(
<nowiki> </nowiki> pg_catalog.repeat('unknown,', arg_count),
<nowiki> </nowiki> ','
<nowiki> </nowiki> ),
<nowiki> </nowiki> close_paren,
<nowiki> </nowiki> ' AS ',
<nowiki> </nowiki> astromkey_execution_plan.query
<nowiki> </nowiki> );

<nowiki> </nowiki> /* construct an EXPLAIN statement */
<nowiki> </nowiki> explain_cmd :=
<nowiki> </nowiki> pg_catalog.concat(
<nowiki> </nowiki> 'EXPLAIN (FORMAT JSON, ANALYZE FALSE) EXECUTE _stmt_',
<nowiki> </nowiki> open_paren,
<nowiki> </nowiki> pg_catalog.rtrim(
<nowiki> </nowiki> pg_catalog.repeat('NULL,', arg_count),
<nowiki> </nowiki> ','
<nowiki> </nowiki> ),
<nowiki> </nowiki> close_paren
<nowiki> </nowiki> );

<nowiki> </nowiki> /* get and return the plan */
<nowiki> </nowiki> EXECUTE explain_cmd INTO json_result;
<nowiki> </nowiki> RETURN QUERY SELECT json_result;

<nowiki> </nowiki> /* delete the prepared statement */
<nowiki> </nowiki> DEALLOCATE _stmt_;
END;$$;

* Обратите внимание, что функция выше определена с <code>SECURITY DEFINER</code>, то есть она выполняется с привилегиями пользователя, который её определил, а не того, кто её выполняет. Это связано с тем, что для запроса <code>EXPLAIN</code> требуются те же разрешения, что и для его выполнения, то есть пользователь, с которым определена эта функция, должен иметь достаточные привилегии для запуска <code>PREPARE</code> и <code>EXPLAIN</code> для запросов, которые она будет объяснять. Поэтому для полной функциональности убедитесь, что функция определена с соответствующим пользователем.
* Пользователю, осуществляющему мониторинг, необходимо иметь <code>USAGE</code> грант на <code>astromkey</code> схему.

GRANT USAGE ON SCHEMA astromkey to <username>

* В некоторых конфигурациях '''PostgreSQL''' вам также может потребоваться настроить <code>search_path</code> для пользователя мониторинга:

ALTER USER astromkey SET search_path to astromkey, public;

== Подробности ==

=== Ограничения ===
Популярные запросы:

* Из соображений безопасности <code>ALTER</code> утверждения исключены из коллекции самых популярных запросов.

Подробности плана выполнения:

* Доступно только для пользователей '''SaaS''' с установленным приложением '''DB'''. Разрешение <code>extensions:configuration.actions:write</code> требуется для запуска загрузки плана выполнения.
* План выполнения можно получить только из базы данных, в которой была создана функция <code>astromkey.astromkey_execution_plan</code>.

=== Лицензирование ===
Метрики, собираемые с помощью этого расширения, используют единицы данных Ключ-АСТРОМ ИИ (см. [[DDU для пользовательских событий ИИ|DDU для метрик]]).

Грубую оценку количества '''DDU''', потребляемых метрическим методом, можно получить с помощью следующей формулы:
( (11 * number of instances)
+ (29 * number of databases)
+ (1 * number of tablespaces)
) * 525.6 DDUs/year
Для логов действует стандартное потребление '''DDU''' для мониторинга логов. В зависимости от вашей модели лицензирования, см. потребление [[DDU для лога мониторинга|DDU для мониторинга логов]].

Если ваша лицензия включает пользовательские метрики. Каждая пользовательская метрика эквивалентна '''525,6 DDU/год'''. См. документацию [[Распределение затрат|Расчёт стоимости метрики]].

== Информация о совместимости ==
Расширение предназначено для работы с PostgreSQL версии 11 и более поздних версий.

Расширение PostgreSQL - История изменений

IKuznetsov в 14:24, 28 октября 2025

IKuznetsov: Новая страница: «== Обзор == Решение для мониторинга '''PostgresSQL''' основано на подходе удалённого мониторинга,...»