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

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

2026-09-15T18:50:32Z

← Предыдущая версия		Версия от 18:50, 15 сентября 2026
Строка 10:		Строка 10:
	* Добавлены метрики времени работы, состояния RAC, заблокированных сеансов, взаимных блокировок и повреждённых блоков данных.		* Добавлены метрики времени работы, состояния RAC, заблокированных сеансов, взаимных блокировок и повреждённых блоков данных.
	* Добавлены метрики и журналы для анализа наиболее ресурсоёмких SQL-запросов.		* Добавлены метрики и журналы для анализа наиболее ресурсоёмких SQL-запросов.
	* Добавлены сущности топологии для кластера, экземпляра, базы данных, заданий резервного копирования, групп и дисков ASM.		* Добавлены сущности топологии для кластера, экземпляра, базы данных, заданий резервного копирования, групп и дисков ASM.
	* Идентификаторы типов топологии переведены в пространство имён <code>sql:ru_ruscomtech_extension_sql-oracle_</code>. Ссылки на прежние типы <code>sql:com_dynatrace_extension_sql-oracle_</code> в пользовательских дашбордах и правилах необходимо обновить.
	* Добавлены и обновлены оповещения о недоступности экземпляров и PDB, состоянии табличных пространств, файлов данных и Data Guard.		* Добавлены и обновлены оповещения о недоступности экземпляров и PDB, состоянии табличных пространств, файлов данных и Data Guard.
	* Добавлен обзорный дашборд <code>documents/overview.dashboard.json</code>.		* Добавлен обзорный дашборд <code>documents/overview.dashboard.json</code>.

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

2026-09-15T18:18:46Z

@@ Строка 2: / Строка 2: @@
 !Версия
 !Изменения
 |-
 |2.3.0

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

2025-10-28T14:19:48Z

@@ Строка 1: / Строка 1: @@
 == Обзор ==
 Ключ-АСТРОМ автоматически определяет все приложения и микросервисы, развернутые в вашей системе, а также то, как ваша система использует '''Oracle Database'''.
@@ Строка 141: / Строка 230: @@
 Настройте правила безопасности '''LogAgent''', чтобы разрешить доступ к локальным файлам, добавив файл <code>oracle.json</code> в:
-* в Linux/UNIX: <code>/var/lib/dynatrace/oneagent/agent/config/logmodule</code>
+* в Linux/UNIX: <code>/var/lib/astromkey/oneagent/agent/config/logmodule</code>
-* в Windows: <code>%PROGRAMDATA%\dynatrace\oneagent\agent\config\logmodule</code>
+* в Windows: <code>%PROGRAMDATA%\astromkey\oneagent\agent\config\logmodule</code>
+  {

IKuznetsov: Новая страница: «== Обзор == Ключ-АСТРОМ автоматически определяет все приложения и микросервисы, развернут...»

2025-10-27T13:39:03Z

Новая страница: «== Обзор == Ключ-АСТРОМ автоматически определяет все приложения и микросервисы, развернут...»

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

== Обзор ==
Ключ-АСТРОМ автоматически определяет все приложения и микросервисы, развернутые в вашей системе, а также то, как ваша система использует '''Oracle Database'''.

Ключ-АСТРОМ диагностирует аномалии в режиме реального времени с помощью ИИ и выявляет первопричину медленно работающих или ошибочных '''SQL-запросов'''. Глубокий анализ кода в сочетании с облачным мониторингом серверов баз данных поможет вам обеспечить надежную производственную среду.

Расширение '''Oracle Database''' дополняет информацию об использовании базы данных на стороне клиента, обеспечивая возможность наблюдения на стороне сервера, начиная со статистики доступности и производительности и заканчивая отдельными '''SQL-запросами''' и данными логов.

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

* Понять зависимости приложений от баз данных: какие запросы выполняются и какова их производительность.
* Повысить производительность приложений за счёт оптимизации типичных паттернов БД, например проблемы 1+N-запросов.
* Определить, как приложения нагружают базу данных.
* Понять, как нехватка ресурсов или ошибки на стороне БД влияют на приложения.
* Анализировать аудит-логи БД, чтобы выявлять неудачные попытки входа.
* Отслеживать состояние и производительность серверов '''Oracle''' (одиночных или мультиарендных).
* Отслеживать наиболее ресурсоёмкие запросы.
* Ускорить диагностику проблем в приложениях, вызванных базой данных.

== Начать ==
Это удалённое расширение, работающее через АктивныйШлюз в вашей среде и подключающееся к каждой базе данных '''Oracle''', которую необходимо отслеживать. Выполняется серия запросов к различным представлениям баз данных, и данные отправляются обратно в Ключ-АСТРОМ.

=== Начало работы для клиентов Oracle Database: ===
Если приложение, подключающееся к серверу '''Oracle Database''', работает на виртуальной машине или на физическом сервере, установите на него ЕдиныйАгент, чтобы начать работу.

Если приложение, подключающееся к серверу '''Oracle Database''', работает как рабочая нагрузка в '''Kubernetes''' или '''OpenShift''', настройте Ключ-АСТРОМ на '''Kubernetes''' или '''OpenShift''' .

Активируйте следующие функции ЕдиногоАгента, чтобы получить полную информацию об отслеживании:

* '''Node.js Oracle DB'''
* '''PHP Oracle'''

=== Начните работу для серверов Oracle Database: ===
Если ваш сервер '''Oracle Database''' работает на виртуальной машине или на аппаратном уровне, установите на нем ЕдиныйАгент, чтобы начать работу с показателями производительности системы.

Активируйте удалённое расширение '''Oracle Database''', чтобы получить полную информацию о состоянии и производительности сервера '''Oracle Database''', включая метрики и события. Расширение собирает данные, напрямую запрашивая представления производительности базы данных, поэтому для его работы требуется подключение к ней.

Для мониторинга рекомендуется создать отдельную учётную запись пользователя. Для удобства скрипты создания пользователей можно найти [https://github.com/dynatrace-extensions/convenience-scripts/tree/main/oracle-db здесь]. Эти скрипты создают пользователя с ролями <code>CREATE_SESSION</code> и разрешениями <code>SELECT</code> для следующих представлений производительности:

* <code>CDB_DATA_FILES</code>
* <code>CDB_TABLESPACE_USAGE_METRICS</code>
* <code>CDB_TABLESPACES</code>
* <code>CDB_TEMP_FILES</code>
* <code>GV_$ARCHIVE_DEST</code>
* <code>GV_$ARCHIVE_DEST_STATUS</code>
* <code>V_$ASM_DISK_STAT</code>
* <code>V_$ASM_DISKGROUP_STAT</code>
* <code>V_$BACKUP_SET_DETAILS</code>
* <code>GV_$CLUSTER_INTERCONNECTS</code>
* <code>GV_$CONTAINERS</code>
* <code>V_$CONTAINERS</code>
* <code>GV_$CON_SYS_TIME_MODEL</code>
* <code>GV_$CON_SYSSTAT</code>
* <code>GV_$DATABASE</code>
* <code>V_$DATABASE</code>
* <code>V_$DATABASE_BLOCK_CORRUPTION</code>
* <code>GV_$DATAFILE</code>
* <code>V_$DATAFILE</code>
* <code>GV_$DATAGUARD_STATUS</code>
* <code>GV_$INSTANCE</code>
* <code>GV_$INSTANCE_PING</code>
* <code>GV_$LIBRARYCACHE</code>
* <code>V_$LOG</code>
* <code>GV_$METRIC</code>
* <code>GV_$METRICGROUP</code>
* <code>GV_$PARAMETER</code>
* <code>GV_$PDBS</code>
* <code>GV_$PGASTAT</code>
* <code>V_$RECOVER_FILE</code>
* <code>V_$RECOVERY_FILE_DEST</code>
* <code>GV_$RESOURCE_LIMIT</code>
* <code>V_$RMAN_BACKUP_JOB_DETAILS</code>
* <code>GV_$SESSION</code>
* <code>V_$SESSION</code>
* <code>GV_$SGASTAT</code>
* <code>GV_$SQL</code>
* <code>V_$SQL</code>
* <code>GV_$SQLAREA</code>
* <code>V_$SQL_PLAN</code>
* <code>GV_$SQL_PLAN</code>
* <code>V_$SQL_PLAN_STATISTICS_ALL</code>
* <code>GV_$SYSSTAT</code>
* <code>GV_$SYSTEM_EVENT</code>
* <code>GV_$SYSTEM_WAIT_CLASS</code>
* <code>V_$TABLESPACE</code>
* <code>V_$TEMPFILE</code>

В качестве альтернативы <code>SELECT_CATALOG_ROLE</code> можно назначить пользователю, осуществляющему мониторинг.

Для мониторинга мультиарендной конфигурации '''Oracle DB''' убедитесь, что расширение указывает на '''CDB'''. Обнаружение и мониторинг '''PDB''' будут выполняться автоматически. В этом случае необходимы явные разрешения на доступ к данным во всех контейнерах:

<code>alter user <your_username> set container_data=all container = current;</code>

Эти привилегии уже включены в скрипты создания пользователей.

Пользователям приложения '''Базы данных''', желающим использовать планы выполнения запросов, также необходимо предоставить разрешение для представлений <code>V$SQL_PLAN</code>, <code>V$SESSION</code>, <code>V$SQL_PLAN_STATISTICS_ALL</code> и <code>V$SQL</code>. Эти разрешения включены в скрипты создания пользователей. Подробнее см. в разделе '''Мониторинг планов выполнения''' ниже.

Наконец, активируйте мониторинг логов, чтобы получить полную картину логов.

'''Примечание''':

При использовании набора функций '''TopN''' расширение выводит отчеты о наиболее затратных по времени запросах на странице сущностей экземпляра '''Oracle''' в разделе '''Логи'''. Включение этой функции может привести к раскрытию конфиденциальных данных в отчетах о запросах.

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

==== Этот пакет расширения содержит: ====

* Определения топологии и взаимосвязей для кластеров '''RAC''', заданий резервного копирования, баз данных, экземпляров, дисков '''ASM''' и групп дисков '''ASM'''.
* Классический и новый дашборд, предлагающий обзор мониторинга среды '''Oracle Database'''.
* Оповещения об ошибках резервного копирования, недоступных '''PDB''', недоступных экземплярах, высоком использовании табличного пространства и т.д.
* Страница унифицированного анализа для вышеупомянутой топологии

== Информация о совместимости ==
Поддерживаются следующие версии '''Oracle''':

* '''Oracle DB 12.2+'''

Поддерживаются следующие архитектуры:

* Автономные серверы '''Oracle'''
* '''Oracle Multitenant (CDB/PDB)'''
** Настройка мониторинга '''CDB''' для обнаружения всех '''PDB'''
* '''Oracle AWS RDS'''
* '''Oracle RAC'''
** Настройка мониторинга для '''SCAN''' обнаружения всех экземпляров и баз данных.

== Управление логами и аналитика ==

=== Отслеживание файлов логов аудита ===

==== Проверка местоположения файла логов ====

* <code>SELECT name, value FROM v$parameter WHERE name = 'audit_trail';</code>

<code>OS</code> означает, что логи аудита хранятся локально в файле.

* <code>SELECT value FROM v$parameter WHERE name = 'audit_file_dest';</code>

указывает местоположение файла логов

==== Добавить правила безопасности LogAgent ====
Настройте правила безопасности '''LogAgent''', чтобы разрешить доступ к локальным файлам, добавив файл <code>oracle.json</code> в:

* в Linux/UNIX: <code>/var/lib/dynatrace/oneagent/agent/config/logmodule</code>
* в Windows: <code>%PROGRAMDATA%\dynatrace\oneagent\agent\config\logmodule</code>

{
"@version": "1.0.0",
"allowed-log-paths-configuration": [
{
"directory-pattern": "/u01/app/oracle/admin/oracle_standalone/adump/",
"file-pattern": "*.aud",
"action": "INCLUDE"
}
]
}
Перезапуск агента не требуется, данная конфигурация будет применена в течение 1 минуты.

==== Настройте собственный источник логов и правила приема логов ====

===== Пользовательский источник логов =====
Используйте местоположение файла логов, полученное с помощью запроса, выполненного на первом этапе, например <code>/u01/app/oracle/admin/oracle_standalone/adump/*</code>.

===== Правила приема логов =====
Пример конфигурации, которая включает только сообщения <code>ORA-01017</code> о попытках входа с недействительным именем пользователя или паролем, можно настроить с помощью: <code>Log content is any of: (.*)RETURNCODE:\[(\d+)\] "1017 AND Log source is any of: /u01/app/oracle/admin/oracle_standalone/adump/*</code>

==== Доступ к логам ====
Доступ к логам, собранным описанным выше способом, можно получить с помощью следующего '''DQL-запроса''': <code>fetch logs | filter matchesValue(log.source, "/u01/app/oracle/admin/oracle_standalone/adump/*")</code>.

==== Извлечение метрик ====

===== Правило обработки логов =====
Настройте правило обработки логов для извлечения атрибутов лога из его содержимого:

* '''Имя правила''': предпочтительное имя
* '''Сопоставитель''': <code>matchesValue(log.source, "/u01/app/oracle/admin/oracle_standalone/adump/*")</code>
* '''Определение процессора''':

PARSE(content, "
DATA ' RETURNCODE:['INT']' SPACE '\"' INT:ora.returncode LD") |
PARSE(content, "
DATA ' USERID:['INT']'SPACE CSVDQS:ora.userid LD") |
PARSE(content, "
DATA ' USERHOST:['INT']'SPACE CSVDQS:ora.userhost LD")

===== Извлечение метрических данных =====
Извлеките показатели из записей логов для включения оповещений:

* '''Метрический ключ''': например <code>log.oracle.invalid_credentials</code>
* '''Сопоставитель''': <code>matchesValue(log.source, "/u01/app/oracle/admin/oracle_standalone/adump/*")</code>
* '''Метрические измерения''': <code>Occurence of logs records</code>
* '''Измерения''': укажите атрибуты журнала, которые будут использоваться в качестве метрических измерений.

== Мониторинг плана выполнения ==
Для клиентов SaaS, имеющих доступ к приложению «Базы данных», функция мониторинга плана выполнения также доступна при анализе эффективности выполнения выписок.

Для работы функции <code>DBMS_XPLAN</code> пакет должен быть доступен, а пользователь, настроенный в расширении Ключ-АСТРОМ, должен иметь разрешения на вызов функции <code>DISPLAY_CURSOR</code>. Согласно официальной документации, это означает, что для следующих представлений <code>SELECT</code>, <code>READ</code> требуются разрешения:

* <code>V$SQL_PLAN</code>
* <code>V$SESSION</code>
* <code>V$SQL_PLAN_STATISTICS_ALL</code>
* <code>V$SQL</code>

В дополнение к этому, разрешение <code>SELECT</code> также требуется для <code>V$SQL_PLAN</code>.

== Маскировка конфиденциальных данных ==
Отслеживание производительности запросов может раскрыть конфиденциальные данные в отчётах. Поэтому Ключ-АСТРОМ предоставляет дополнительный механизм, позволяющий маскировать выбранные атрибуты.

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

* Создать новое правило обработки можно в разделе <code>Настройки -> Мониторинг -> Процессы</code>
** Определение процесса: <code>USING(INOUT content) | FIELDS_ADD(content: REPLACE_PATTERN(content, "(\"'\"):p1 (LD):p2 (\"'\"):p3", "${p1}${p2|sha1}${p3}"))</code>
* Или создайте/измените свое собственное расширение для распространения таких правил в вашей среде:

logProcessingRules:
- ruleName: TopN statements masking
query: event.group="query_performance"
enabled: true
ProcessorDefinition:
rule: |
USING(INOUT content) | FIELDS_ADD(content: REPLACE_PATTERN(content, "(\"'\"):p1 (LD):p2 (\"'\"):p3", "${p1}${p2|sha1}${p3}"))
RuleTesting:
sampleLog: |
{
"event.group": "query_performance",
"content": "/*dt:ownQuery*/SELECT DECODE(name, 'sessions', value) AS sessions_limit, DECODE(name, 'processes', value) AS processes_limit FROM v$parameter WHERE name IN('sessions', 'processes')"
}
Измените это правило в соответствии с вашим вариантом использования.

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

Грубую оценку количества '''DDU''', потребляемых метрическим методом, можно получить с помощью следующей формулы:
(55 * number of instances * 525.6) + (7 * number of databases * 525.6) + (8 * number of backup jobs per year * 0.005) + (5 * number of ASM disks * 525.6) + (3 * number of ASM disk groups * 525.6)
Для логов действует стандартное потребление '''DDU''' для мониторинга логов. В зависимости от вашей модели лицензирования, см. потребление [[DDU для лога мониторинга|DDU для мониторинга логов]].