Aleksandr.Zubarev в 18:10, 15 сентября 2026

2026-09-15T18:10:27Z

IKuznetsov: Новая страница: «= Расширение DB Query для Ключ-АСТРОМ = Расширение '''DB Query''' предназначено для мониторинга баз данных через выполнение пользовательских запросов и извлечения метрик. Оно поддерживает основные реляционные СУБД и '''MongoDB''', позволяя превращать результаты запр...»

2026-08-25T22:41:08Z

Новая страница: «= Расширение DB Query для Ключ-АСТРОМ = Расширение '''DB Query''' предназначено для мониторинга баз данных через выполнение пользовательских запросов и извлечения метрик. Оно поддерживает основные реляционные СУБД и '''MongoDB''', позволяя превращать результаты запр...»

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

= Расширение DB Query для Ключ-АСТРОМ =
Расширение '''DB Query''' предназначено для мониторинга баз данных через выполнение пользовательских запросов и извлечения метрик. Оно поддерживает основные реляционные СУБД и '''MongoDB''', позволяя превращать результаты запросов в метрики и измерения Ключ-АСТРОМ.

== Возможности расширения ==

* Подключение к базам данных '''PostgreSQL''', '''Oracle''', '''MySQL''', '''MariaDB''', '''SQL Server''' и '''MongoDB'''.
* Выполнение произвольных запросов ('''SQL''' или '''MongoDB'''-команд) и преобразование результатов в метрики и размерности.
* Настройка интервала выполнения запросов и расписания запуска по времени.
* Ограничение времени выполнения запроса.
* Проверка доступности подключения лёгким запросом ('''fastcheck''').
* Создание сущностей '''DB Query Host''' и '''DB Query Endpoint''' с топологическими связями.
* Готовый обзорный дашборд.
* Отображение ошибок подключения и выполнения в статусе расширения.

== Поддерживаемые базы данных ==

* '''PostgreSQL'''
* '''Oracle'''
* '''MySQL'''
* '''MariaDB'''
* '''SQL Server'''
* '''MongoDB'''

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

* АктивныйШлюз с включённым выполнением расширений (или ЕдиныйАгент с '''EEC''').
* Сетевой доступ к базе данных.
* Учётные данные с правами на выполнение запросов.
* Для '''MongoDB''' — зависимость '''pymongo''' (включена в расширение).

== Конфигурация ==
Конфигурация каждого endpoint задаётся через '''JSON''' со следующими основными полями:

* <code>name</code> — имя endpoint.
* <code>db_name</code> — имя базы данных.
* <code>query</code> — запрос ('''SQL''' или '''JSON''' для '''MongoDB''').
* <code>metric_columns</code> — колонки, значения которых станут метриками.
* <code>dimension_columns</code> — колонки, значения которых станут измерениями.
* <code>Query interval (minutes)</code> — интервал выполнения в минутах.
* <code>Query timeout (minutes)</code> — ограничение времени выполнения (по умолчанию 10 минут).
* <code>Execution times</code> — конкретное время запуска ('''HH:MM''', можно несколько через запятую); если пусто, используется интервал.

== Метрики ==
Расширение отправляет служебную метрику <code>ru.ruscomtech.dbquery.host.status</code> для отображения хоста на обзорном дашборде.

== История версий ==

=== Версия 0.2.30 ===

* Лимит поля '''Query''' увеличен до 10000 символов.
* Добавлено поле '''Query timeout (minutes)''' для ограничения времени выполнения одного запроса. По умолчанию 10 минут; применяется для '''Postgres''', '''Oracle''', '''MySQL''', '''MariaDB''', '''SQLServer''' и '''MongoDB'''.
* Добавлено поле '''Execution times''' для запуска конкретного endpoint по расписанию. Формат: '''HH:MM''' по локальному времени хоста/АктивногоШлюза; несколько значений через запятую, например <code>09:00,18:30</code>.
* Запуск по '''Execution times''' выполняется в окне от указанного времени до +5 минут. Если поле пустое, endpoint выполняется по старому правилу через '''Query interval (minutes)'''.
* <code>fastcheck()</code> проверяет подключение к БД лёгким запросом: '''MongoDB''' — <code>ping</code>, '''Oracle''' — <code>SELECT 1 FROM dual</code>, '''MySQL/MariaDB/SQLServer''' — <code>SELECT 1</code>, '''Postgres''' — <code>SELECT 1</code>.
* Ошибки выполнения '''query''' больше не отображаются как '''OK''': последняя ошибка endpoint сохраняется и возвращается в '''runtime status'''.
* Ошибки подключения, авторизации и конфигурации мапятся в соответствующие '''StatusValue'''; ошибка '''Oracle''' <code>DPY-6005: cannot connect to database</code> классифицируется как <code>DEVICE_CONNECTION_ERROR</code>.
* Исправлена ошибка '''UnboundLocalError''' после неуспешного подключения к '''MongoDB''' или другой БД.
* Русифицированы описания полей.
* Добавлена служебная метрика <code>ru.ruscomtech.dbquery.host.status</code> для отображения '''DB Query Host''' на '''overview dashboard'''.
* Плитка '''DB Query Host''' теперь содержит '''Data Explorer''' query и показывает хосты по <code>device.address</code>.
* Метрика <code>ru.ruscomtech.dbquery.host.status</code> отправляется в каждом цикле <code>query()</code> для валидной конфигурации, даже если endpoint пропущен по расписанию или интервалу.

=== Версия 0.2.11 ===

* Добавлена поддержка '''MongoDB'''.
* Добавлена зависимость '''pymongo'''.
* Для '''MongoDB''' поле '''query''' принимает '''JSON''':
** raw '''MongoDB''' command для выполнения через <code>db.command(...)</code>;
** wrapper с <code>collection</code> и <code>operation</code>.
* Поддержанные операции '''MongoDB''': <code>find</code>, <code>find_one</code>, <code>count_documents</code>, <code>estimated_document_count</code>, <code>aggregate</code>.
* Поля <code>dimension_columns</code> и <code>metric_columns</code> работают для '''MongoDB''' по возвращаемым полям документов, так же как для '''SQL'''-колонок.

=== Версия 0.2.10 ===

* Добавлены '''topology''' entities для '''DB Query Host''' и '''DB Query Endpoint'''.
* Добавлен '''overview dashboard'''.

=== Версия 0.2.1 ===

* Добавлена поддержка '''Oracle'''.
* Добавлена функция ожидания после каждого выполнения.

== Примеры конфигурации ==

=== Пример MongoDB count ===
<pre>
{
"name": "mongo_orders_open",
"db_name": "mydb",
"query": "{\"collection\":\"orders\",\"operation\":\"count_documents\",\"filter\":{\"status\":\"open\"}}",
"metric_columns": "count"
}
</pre>

=== Пример MongoDB aggregate ===
<pre>
{
"name": "mongo_orders_by_status",
"db_name": "mydb",
"query": "{\"collection\":\"orders\",\"operation\":\"aggregate\",\"pipeline\":[{\"$group\":{\"_id\":\"$status\",\"total\":{\"$sum\":1}}}]}",
"dimension_columns": "_id",
"metric_columns": "total"
}
</pre>

DB Query - История изменений

Aleksandr.Zubarev в 18:10, 15 сентября 2026