Расширения Oracle Database

Материал из Документация Ключ-АСТРОМ

Расширение Oracle Database

Сбор метрик и журналов аудита Oracle Database для мониторинга производительности и безопасности.

Начало работы

Обзор

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

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

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

Расширение Oracle Database предоставляет серверный мониторинг со статистикой доступности и производительности, SQL-операторами и аналитикой логов.

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

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

Требования

  • Решите, какой сервер Oracle Database отслеживать. Расширение поддерживает Oracle Database 12.2+ со следующими конфигурациями:
  * Автономные серверы Oracle
  * Oracle Multitenant (CDB/PDB)
  * Oracle RAC
  * Oracle AWS RDS
  • Назначьте одну или несколько групп АктивныйШлюз, которые подключаются к вашему серверу Oracle Database для сбора данных. Все АктивныеШлюзы в каждой группе должны подключаться к вашему серверу Oracle Database.
  • Создайте выделенного пользователя базы данных в вашем экземпляре базы данных с необходимыми разрешениями, как описано ниже. Ключ-АСТРОМ использует этого пользователя для выполнения запросов мониторинга к вашей базе данных Oracle.

Аутентификация учётных записей пользователей

Используйте выделенную учётную запись пользователя для мониторинга. Вы можете найти скрипты создания пользователя на GitHub. Эти скрипты создают пользователя с ролью CREATE_SESSION и разрешениями SELECT на следующие представления производительности:

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

В качестве альтернативы вы можете назначить роль SELECT_CATALOG_ROLE пользователю мониторинга.

Начиная с версии 3.9.2+, расширение запрашивает локальный IP-адрес каждой ноды в конфигурациях RAC с помощью функции UTL_INADDR.get_host_address. Поэтому требуется следующее разрешение списка контроля доступа:

BEGIN
  DBMS_NETWORK_ACL_ADMIN.create_acl (
    acl          => 'astromkey.xml',
    description  => 'Allow DNS resolution checks to get RAC node IP addresses',
    principal    => '<ASTROMKEY_USER>',
    is_grant     => TRUE,
    privilege    => 'resolve',
    start_date   => SYSTIMESTAMP,
    end_date     => NULL);

    FOR instance_host IN (
      SELECT DISTINCT host_name
    FROM gv$instance -- Retrieves all RAC node hostnames
  ) LOOP
    DBMS_NETWORK_ACL_ADMIN.assign_acl (
      acl         => 'astromkey.xml',
      host        => instance_host.host_name, -- Assign ACL to each instance host
      lower_port  => NULL,
      upper_port  => NULL
    );
  END LOOP;

  COMMIT;
END;
/

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

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

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

Чтобы использовать планы выполнения запросов с функцией «Анализ служб базы данных», предоставьте доступ к представлениям V$SQL_PLAN, V$SESSION, V$SQL_PLAN_STATISTICS_ALL и V$SQL. Эти разрешения включены в скрипты создания пользователя.

Информация о совместимости

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

  • Oracle DB 12.2+

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

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

Активация и настройка

Выполните следующие шаги, чтобы настроить серверный мониторинг для баз данных Oracle.

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

Чтобы отслеживать здоровье и производительность сервера Oracle Database, активируйте расширение Oracle Database. Расширение запрашивает представления производительности базы данных для сбора метрик и событий.

Добавление экземпляра БД

  1. Перейдите в раздел Расширения.
  2. Выберите и установите расширение Oracle Database. Это включает расширение в вашей среде мониторинга.
  * Требуемое разрешение: Изменение настроек мониторинга
  1. Выберите Добавить экземпляр БД в приложении Базы данных. Откроется мастер Добавить экземпляр БД.
  2. Выберите раздел Oracle в мастере.

Выбор типа размещения

Выберите тип размещения из предложенных вариантов. Этот выбор определяет, какой скрипт создаст необходимые объекты базы данных на более позднем этапе процесса.

  1. В мастере Добавить экземпляр БД выберите тип хоста, соответствующий вашим требованиям.
  2. Выберите Далее.

Выбор группы АктивныйШлюз

Выберите группу АктивныйШлюз, чтобы определить, какие АктивныеШлюзы будут запускать расширение.

Выберите Следующий шаг.

Принятие лицензионного соглашения

Расширение Oracle Database требует принятия лицензионного соглашения о перераспределении Ключ-АСТРОМ для драйвера Oracle JDBC.

Создание подключения

Настройте подключение к вашему экземпляру базы данных. Укажите необходимые учётные данные непосредственно в мастере или используйте безопасные альтернативы:

  1. Назовите подключение, чтобы вы могли идентифицировать его позже.
  2. Добавьте данные в разделе Настроить подключение.
  3. Выберите подключение. Используйте Выбрать из существующих хостов или Ввести вручную, чтобы добавить данные подключения.
  4. Добавьте Идентификатор базы данных: либо Service Name, либо SID.
  5. Добавьте Имя службы.
  6. Предоставьте учётные данные для аутентификации пользователя мониторинга astromkey, которого вы создали, напрямую или используйте безопасные альтернативы.
  * Базовые учётные данные: Ключ-АСТРОМ маскирует предоставленные данные аутентификации, чтобы предотвратить их извлечение.
  * Хранилище учётных данных: используйте учётные данные из хранилища для безопасного хранения и извлечения учётных данных базы данных.
  1. При необходимости включите SSL для установления безопасного соединения для вашей конфигурации, включая настройку truststore.
  2. Выберите Далее.

Установка экземпляра

Добавьте ручные конфигурации на основе требований мониторинга.

Выберите Создать мониторинг экземпляра БД.

Начало работы для клиентов Oracle Database

Выполните следующие шаги, чтобы настроить клиентский мониторинг для баз данных Oracle.

  • Если приложение, подключающееся к серверу Oracle Database, работает на виртуальной машине или физическом сервере, установите ЕдиныйАгент на эту машину, чтобы начать.
  • Если приложение, которое подключается к серверу Oracle Database, работает как рабочая нагрузка в Kubernetes или OpenShift, настройте Ключ-АСТРОМ на Kubernetes или OpenShift.
  • Активируйте следующие функции ЕдиныйАгент для получения полной аналитики трассировки:
  * Node.js Oracle DB
  * PHP Oracle
  • Активируйте мониторинг логов для получения полной аналитики логов.

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

Детали

Пакет расширения

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

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

Лицензирование и затраты

Получение расширения бесплатно, вы платите только за данные (метрики и логи), которые собирает расширение.

Подписка на платформу Ключ-АСТРОМ

С лицензией подписки на платформу Ключ-АСТРОМ (DPS):

  • Для метрик потребление лицензии основано на количестве принятых точек данных метрик. Это тарифицируется как метрики.
  • Для логов применяется обычное потребление для аналитики логов.

Классическая лицензия

С классической лицензией Ключ-АСТРОМ:

  • Для метрик приём метрик потребляет Davis Data Units (DDU) со скоростью 0,001 DDU на точку данных метрики.
  • Для логов применяется обычное потребление DDU для мониторинга логов.

Мониторинг планов выполнения

Для SaaS-клиентов с доступом к Database Services Classic функция мониторинга планов выполнения также доступна при анализе производительности операторов.

Чтобы эта функция работала, пакет DBMS_XPLAN должен быть доступен, а пользователь мониторинга должен иметь разрешение на вызов функции DISPLAY_CURSOR. Согласно официальной документации, требуются разрешения SELECT или READ на следующие представления:

  • V$SQL_PLAN
  • V$SESSION
  • V$SQL_PLAN_STATISTICS_ALL
  • V$SQL

Маскирование конфиденциальных данных

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

Следующие конфигурации показывают, как маскировать конфиденциальные данные в отслеживаемых операторах:

  1. Создайте новое правило обработки в разделе Настройки > Мониторинг логов > Обработка.
  2. Определение процессора: USING(INOUT content) | FIELDS_ADD(content: REPLACE_PATTERN(content, "(\"'\"):p1 (LD):p2 (\"'\"):p3", "${p1}${p2|sha1}${p3}"))

В качестве альтернативы создайте или измените ваше пользовательское расширение для распространения таких правил по вашей среде.

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')"
        }

DQL и логи

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

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

SELECT name, value FROM v$parameter WHERE name = 'audit_trail';

Значение OS означает, что журналы аудита хранятся локально в файловой системе.

SELECT value FROM v$parameter WHERE name = 'audit_file_dest';

Указывает расположение файла лога.

Добавление правил безопасности для модуля логов ЕдиныйАгент

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

  • на Linux/UNIX: /var/lib/astromkey/oneagent/agent/config/logmodule
  • на Windows: %PROGRAMDATA%\astromkey\oneagent\agent\config\logmodule
{
  "@version": "1.0.0",
  "allowed-log-paths-configuration": [
      {
          "directory-pattern": "/u01/app/oracle/admin/oracle_standalone/adump/",
          "file-pattern": "*.aud",
          "action": "INCLUDE"
      }
  ]
}

Перезапуск ЕдиныйАгент не требуется. Конфигурация вступает в силу в течение 1 минуты.

Настройка пользовательского источника логов и правил приёма логов

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

Правила приёма логов Чтобы захватывать только ORA-01017 (неудачные попытки входа с неверным именем пользователя или паролем), настройте правило приёма логов следующим образом:

  • Содержимое лога соответствует: (.*)RETURNCODE:\[(\d+)\] "1017 И
  • Источник лога соответствует: /u01/app/oracle/admin/oracle_standalone/adump/*

Доступ к логам

Получите доступ к собранным логам с помощью следующего запроса DQL:

fetch logs
| filter matchesValue(log.source, "/u01/app/oracle/admin/oracle_standalone/adump/*")

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

Правило обработки логов

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

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

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

Извлекайте метрики из записей логов, чтобы включить оповещения:

  • Ключ метрики: например, log.oracle.invalid_credentials
  • Совпадение: matchesValue(log.source, "/u01/app/oracle/admin/oracle_standalone/adump/*")
  • Измерение метрики: появление записей логов
  • Размерности: укажите атрибуты лога, которые будут использоваться в качестве размерностей метрики

Наборы функций

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

В сильно сегментированных сетях наборы функций могут отражать сегменты вашей среды. Затем при создании конфигурации мониторинга вы можете выбрать набор функций и соответствующую группу АктивныйШлюз, которая может подключиться к этому конкретному сегменту.

Все метрики, не отнесённые ни к одному набору функций, считаются стандартными и всегда сообщаются.

Метрика наследует набор функций подгруппы, которая, в свою очередь, наследует набор функций группы. Кроме того, набор функций, определённый на уровне метрики, переопределяет набор функций, определённый на уровне подгруппы, который, в свою очередь, переопределяет набор функций, определённый на уровне группы.

tablespaces (detailed)

Название метрики Ключ метрики Описание
Total size com.astromkey.extension.sql-oracle.tablespaces.totalSpace Общий размер табличного пространства, включая расширяемость. Охватывает как выделенное, так и невыделенное пространство вплоть до максимально возможного расширения табличного пространства.
Free space com.astromkey.extension.sql-oracle.tablespaces.freeSpace Общий объём свободного пространства, доступного в табличном пространстве, в байтах.
Used space com.astromkey.extension.sql-oracle.tablespaces.usedSpace Общий объём используемого пространства в табличном пространстве, в байтах.
Allocated space com.astromkey.extension.sql-oracle.tablespaces.allocatedSpace Общий объём используемого пространства в табличном пространстве, в байтах.
Tablespace usage com.astromkey.extension.sql-oracle.tablespaces.usage Процент использования табличного пространства относительно общего размера (включая расширяемость).

Data guard

Название метрики Ключ метрики Описание
Dataguard severe events com.astromkey.extension.sql-oracle.dataguard.severeEvents Подсчитывает количество фатальных и серьёзных событий Data guard, произошедших за последний день. Если это число больше 0, проверьте его размерности, чтобы принять меры по конкретным событиям.
NOLOGGING activity com.astromkey.extension.sql-oracle.dataguard.nologgingActivity Подсчитывает количество файлов, содержащих активность NOLOGGING за последний день. Если число больше 0, резервная база данных уязвима; проверьте размерности, чтобы узнать, какие файлы необходимо обновить на резервном узле.
Archive destination status com.astromkey.extension.sql-oracle.dataguard.archiveDestErrStatus Подсчитывает количество недействительных или ошибочных статусов архивных назначений.
Seq. difference com.astromkey.extension.sql-oracle.dataguard.seqDifference Отслеживает разницу в порядковых номерах между последним архивированным и применённым журналом redo.

io

Название метрики Ключ метрики Описание
Physical bytes read com.astromkey.extension.sql-oracle.io.bytesRead.count Общий размер в байтах операций чтения с диска всей активностью экземпляра базы данных
Physical bytes written com.astromkey.extension.sql-oracle.io.bytesWritten.count Общий размер в байтах всех операций записи на диск для экземпляра базы данных
Total wait time com.astromkey.extension.sql-oracle.io.wait.count Общее время, проведённое во всех состояниях ожидания, кроме класса Idle

waitEvents

Название метрики Ключ метрики Описание
Number of wait events by wait class com.astromkey.extension.sql-oracle.wait.count Общее количество ожиданий по классу ожидания, исключая события 'Idle'
Seconds waited by wait class com.astromkey.extension.sql-oracle.wait.time.count Общее время ожидания по классу ожидания, исключая события 'Idle'

Datafiles

Название метрики Ключ метрики Описание
Datafile status com.astromkey.extension.sql-oracle.datafile.status Метрика состояния, представляющая статус файлов данных и временных файлов по контейнерам (база данных и любые PDB).
Datafile number of corrupted blocks com.astromkey.extension.sql-oracle.datafile.corrupted_blocks Метрика, представляющая количество повреждённых блоков, о которых сообщает V$DATABASE_BLOCK_CORRUPTION для каждого файла данных

asm (detailed)

Название метрики Ключ метрики Описание
Free space com.astromkey.extension.sql-oracle.asm.disk.free_mb Свободное дисковое пространство, доступное на этом диске Oracle ASM
Total space com.astromkey.extension.sql-oracle.asm.disk.total_mb Общее дисковое пространство, доступное на этом диске Oracle ASM
Used space com.astromkey.extension.sql-oracle.asm.disk.usage Процент используемого дискового пространства на этом диске Oracle ASM
Reads com.astromkey.extension.sql-oracle.asm.disk.reads.count Количество операций чтения с этого диска Oracle ASM
Writes com.astromkey.extension.sql-oracle.asm.disk.writes.count Количество операций записи на этот диск Oracle ASM

default

Название метрики Ключ метрики Описание
Cluster topology com.astromkey.extension.sql-oracle.cluster_topology Метрика состояния, размерности которой представляют все кластеры Oracle и связанные с ними экземпляры и хосты
Database topology com.astromkey.extension.sql-oracle.database_topology Метрика состояния, размерности которой представляют все экземпляры Oracle и связанные с ними базы данных
Instance status com.astromkey.extension.sql-oracle.status Метрика состояния, представляющая детали подключённого экземпляра Oracle.
Instance Uptime com.astromkey.extension.sql-oracle.uptime Время работы экземпляра Oracle в секундах.
Database status com.astromkey.extension.sql-oracle.db_status Метрика состояния, представляющая детали подключённой базы данных Oracle.

rac

Название метрики Ключ метрики Описание
Instance ping com.astromkey.extension.sql-oracle.rac.instance_ping Представляет текущий межэкземплярный ping сообщений 8K, как указано в GV$INSTANCE_PING.
— com.astromkey.extension.sql-oracle.rac.interconnects —

tablespaces

Название метрики Ключ метрики Описание
Total size com.astromkey.extension.sql-oracle.tablespaces.totalSpace Общий размер табличного пространства, включая расширяемость.
Free space com.astromkey.extension.sql-oracle.tablespaces.freeSpace Общий объём свободного пространства, доступного в табличном пространстве, в байтах.
Used space com.astromkey.extension.sql-oracle.tablespaces.usedSpace Общий объём используемого пространства в табличном пространстве, в байтах.
Tablespace usage com.astromkey.extension.sql-oracle.tablespaces.usage Процент использования табличного пространства относительно общего размера (включая расширяемость).

waitEvents (detailed)

Название метрики Ключ метрики Описание
Number of wait events com.astromkey.extension.sql-oracle.wait.events.count Общее количество ожиданий по событию ожидания, исключая события 'Idle'. Собираются только 20 наиболее времязатратных событий.
Seconds waited com.astromkey.extension.sql-oracle.wait.events.time.count Общее время ожидания по событию ожидания, исключая события 'Idle'. Собираются только 20 наиболее времязатратных событий.

queryPerformance

Название метрики Ключ метрики Описание
Connection management time com.astromkey.extension.sql-oracle.queries.connectionManagement.count Время, затраченное на выполнение вызовов подключения и отключения сессии
PL SQL exec time com.astromkey.extension.sql-oracle.queries.plSqlExec.count Время, затраченное на запуск интерпретатора PL/SQL
SQL exec time com.astromkey.extension.sql-oracle.queries.sqlExec.count Время, затраченное на выполнение SQL
SQL parse time com.astromkey.extension.sql-oracle.queries.sqlParse.count Время, затраченное на разбор SQL
DB Time com.astromkey.extension.sql-oracle.queries.dbTime.count Время, затраченное на выполнение пользовательских вызовов базы данных
DB CPU com.astromkey.extension.sql-oracle.queries.cpuTime.count Время CPU, затраченное на выполнение пользовательских вызовов базы данных

cpu

Название метрики Ключ метрики Описание
CPU cores com.astromkey.extension.sql-oracle.cpu.cores Количество ядер CPU
Background CPU usage (per second) com.astromkey.extension.sql-oracle.cpu.backgroundTotal Использование CPU фоновыми процессами в сантисекундах в секунду
Foreground CPU usage (per second) com.astromkey.extension.sql-oracle.cpu.foregroundTotal Использование CPU процессами переднего плана в сантисекундах в секунду

FRA

Название метрики Ключ метрики Описание
FRA Usage com.astromkey.extension.sql-oracle.fra.usage Процент использования диска в области быстрого восстановления.
FRA limit com.astromkey.extension.sql-oracle.fra.limit Максимальный объём дискового пространства (в байтах), который база данных может использовать для области быстрого восстановления.
FRA used com.astromkey.extension.sql-oracle.fra.used Объём дискового пространства (в байтах), используемого файлами области быстрого восстановления.
FRA reclaimable com.astromkey.extension.sql-oracle.fra.reclaimable Общий объём дискового пространства (в байтах), который можно освободить, удалив устаревшие, избыточные и другие низкоприоритетные файлы.

sessions

Название метрики Ключ метрики Описание
Active Sessions com.astromkey.extension.sql-oracle.sessions.active Количество активных сессий
Blocked Sessions com.astromkey.extension.sql-oracle.sessions.blocked Количество заблокированных сессий
Total sessions com.astromkey.extension.sql-oracle.sessions.all Общее количество сессий
User calls com.astromkey.extension.sql-oracle.sessions.userCalls.count Общее количество входов, разборов или вызовов выполнения
Deadlocks com.astromkey.extension.sql-oracle.sessions.deadlocks.count Общее количество взаимоблокировок

limits

Название метрики Ключ метрики Описание
Sessions utilization com.astromkey.extension.sql-oracle.limits.sessions_utilization Использование сессий на экземпляре как процент от лимита.
Processes utilization com.astromkey.extension.sql-oracle.limits.processes_utilization Использование процессов на экземпляре как процент от лимита.

memory

Название метрики Ключ метрики Описание
PGA aggregate limit com.astromkey.extension.sql-oracle.memory.pga.size.pgaAggregateLimit Лимит агрегированной памяти PGA, потребляемой экземпляром
PGA aggregate target com.astromkey.extension.sql-oracle.memory.pga.size.pgaAggregateTarget Целевая агрегированная память PGA, доступная всем серверным процессам, подключённым к экземпляру
PGA memory used com.astromkey.extension.sql-oracle.memory.pga.used Память PGA, потребляемая рабочими областями
Allocated PGA com.astromkey.extension.sql-oracle.memory.pga.allocated Текущий объём памяти PGA, выделенный экземпляром
Shared pool free com.astromkey.extension.sql-oracle.memory.sga.cacheBuffer.sharedPoolFree Объём свободной памяти SGA, доступной в общем пуле
Redo log space wait time com.astromkey.extension.sql-oracle.memory.sga.redoBuffer.redoLogSpaceWaitTime.count Общее прошедшее время ожидания запроса пространства журнала redo
Redo size increase com.astromkey.extension.sql-oracle.memory.sga.redoBuffer.redoSizeIncrease.count Общий объём сгенерированного redo в байтах
Redo write time com.astromkey.extension.sql-oracle.memory.sga.redoBuffer.redoWriteTime.count Общее прошедшее время записи из буфера журнала redo в текущий файл журнала redo
Logical reads com.astromkey.extension.sql-oracle.memory.sessionLogicalReads.count Сумма «db block gets» плюс «consistent gets»
Physical reads com.astromkey.extension.sql-oracle.memory.physicalReads.count Общее количество блоков данных, прочитанных с диска
Physical reads direct com.astromkey.extension.sql-oracle.memory.physicalReadsDirect.count Количество операций чтения напрямую с диска, минуя кэш буферов
Sorts in memory com.astromkey.extension.sql-oracle.memory.memorySorts.count Количество операций сортировки, полностью выполненных в памяти
Sorts on disk com.astromkey.extension.sql-oracle.memory.diskSorts.count Количество операций сортировки, потребовавших хотя бы одной записи на диск
DB Block gets from cache com.astromkey.extension.sql-oracle.memory.dbBlockGetsFromCache.count Количество раз, когда согласованное чтение было запрошено для блока из кэша буферов.
Consistent gets from cache com.astromkey.extension.sql-oracle.memory.consistentGetsFromCache.count Количество раз, когда блок CURRENT был запрошен из кэша буферов.
Physical reads into cache com.astromkey.extension.sql-oracle.memory.physicalReadsCache.count Общее количество блоков данных, прочитанных с диска в кэш буферов.
Library cache hit ratio com.astromkey.extension.sql-oracle.memory.libraryCacheHitRatio Коэффициент попаданий в библиотечный кэш

backupJob

Название метрики Ключ метрики Описание
Input bytes com.astromkey.extension.sql-oracle.backup-input_bytes Сумма размеров всех входных файлов, для которых выполнено резервное копирование.
Output bytes com.astromkey.extension.sql-oracle.backup-output_bytes Выходной размер всех созданных частей.
Elapsed seconds com.astromkey.extension.sql-oracle.backup-elapsed_seconds Количество прошедших секунд.
Compression ratio com.astromkey.extension.sql-oracle.backup-compression_ratio Коэффициент сжатия.
Input bytes per second com.astromkey.extension.sql-oracle.backup-input_bytes_per_second Скорость чтения входных данных в секунду.
Output bytes per second com.astromkey.extension.sql-oracle.backup-output_bytes_per_second Скорость записи выходных данных в секунду.
Auto - backup count com.astromkey.extension.sql-oracle.backup-autobackup_count_number Количество авторезервных копий, выполненных этим заданием.
Backup state com.astromkey.extension.sql-oracle.backup.state Метрика состояния, представляющая детали задания резервного копирования.
Time since last backup com.astromkey.extension.sql-oracle.backup.time_since Время, прошедшее с момента успешного завершения последнего резервного копирования.

asm

Название метрики Ключ метрики Описание
Free space com.astromkey.extension.sql-oracle.asm.disk_group.free_mb Свободное дисковое пространство, доступное в этой группе дисков Oracle ASM
Total space com.astromkey.extension.sql-oracle.asm.disk_group.total_mb Общее дисковое пространство, доступное в этой группе дисков Oracle ASM
Used space com.astromkey.extension.sql-oracle.asm.disk_group.usage Процент используемого дискового пространства в этой группе дисков Oracle ASM

multitenancy

Название метрики Ключ метрики Описание
Total size com.astromkey.extension.sql-oracle.pdb-total_size Показывает дисковое пространство (в байтах), используемое PDB, включая файлы данных и временные файлы.
Block size com.astromkey.extension.sql-oracle.pdb-block_size Текущий размер блока для PDB
Diagnostic size com.astromkey.extension.sql-oracle.pdb-diagnostic_size Показывает текущее использование дискового пространства (в байтах) диагностическими трассировками, созданными в PDB.
Audit files size com.astromkey.extension.sql-oracle.pdb-audit_files_size Показывает текущее использование дискового пространства (в байтах) унифицированными файлами аудита (формат .bin) в текущем PDB.
Max size com.astromkey.extension.sql-oracle.pdb-max_size Показывает максимальный объём дискового пространства (в байтах), который может использоваться файлами данных и временными файлами в PDB.
Max diagnostic size com.astromkey.extension.sql-oracle.pdb-max_diagnostic_size Показывает максимальный объём дискового пространства (в байтах), который может использоваться диагностическими трассировками, созданными в PDB.
Max audit size com.astromkey.extension.sql-oracle.pdb-max_audit_size Показывает максимальный объём дискового пространства (в байтах), который может использоваться унифицированными файлами аудита (формат .bin) в PDB.

Часто задаваемые вопросы

Как это расширение собирает данные из моих баз данных? Это расширение работает на ваших АктивныхШлюзах Ключ-АСТРОМ и подключается к настроенным базам данных. Расширение выполняет только запросы SELECT для сбора данных, и большинство из них нацелены на представления GV$ или V$.

Как часто выполняются эти запросы мониторинга? Начиная с версии 3.2.0 переменные конфигурации query-interval и heavy-query-interval управляют частотой выполнения запросов. Большинство запросов выполняются каждые query-interval минут (по умолчанию: 1 минута), а запросы в наборах

  • asm (detailed)
  • tablespaces
  • tablespaces (detailed)
  • Blocked sessions
  • TopN

выполняются каждые heavy-query-interval минут (по умолчанию: 5 минут).

Как настроить тайм-аут запроса? По умолчанию запросы мониторинга расширения истекают через 10 секунд. Для запросов в следующих наборах функций переменная long-running-query-timeout позволяет указать собственный тайм-аут в секундах:

  • asm (detailed)
  • tablespaces
  • tablespaces (detailed)
  • TopN

В чём разница между набором функций и набором функций (detailed)? Следующие наборы функций имеют обычную и детальную версии:

  • asm и asm (detailed) — из-за высокого потребления лицензии, связанного с мониторингом тысяч дисков ASM, набор asm захватывает только данные групп дисков ASM, тогда как asm (detailed) захватывает данные всех дисков.
  • waitEvents и waitEvents (detailed) — для контроля потребления лицензии набор waitEvents собирает метрики времени ожидания, агрегированные по классу ожидания, тогда как waitEvents (detailed) собирает метрики для топ-20 событий ожидания.
  • tablespaces и tablespaces (detailed) — из-за высокого потребления CPU, вызванного соединением метрик табличных пространств с данными файлов, набор tablespaces не собирает метрику com.astromkey.extension.sql-oracle.tablespaces.allocatedSpace, поступающую из CDB_DATA_FILES. Кроме того, набор tablespaces собирает данные только для табличных пространств с более чем 50 % используемого пространства. Одновременно следует включать только один из этих наборов.

Почему у меня отсутствуют метрики Data Guard? Для некоторых метрик Data Guard отсутствие данных — это правильное поведение. Следующие метрики показывают точки данных только тогда, когда есть проблемы, требующие дополнительного исследования:

  • NOLOGGING activity
  • Data Guard severe events
  • Archive destination status

Почему у меня отсутствуют метрики использования CPU? Расширение собирает метрики com.astromkey.extension.sql-oracle.cpu.backgroundTotal и com.astromkey.extension.sql-oracle.cpu.foregroundTotal из представления GV$METRIC, отфильтрованного по группе метрик System Metrics Long Duration (Group ID 2). Поскольку эта группа заполняется только на уровне CDB, эти метрики доступны только тогда, когда расширение подключается к CDB, а не к PDB.

Почему метрики использования табличных пространств, сообщаемые Ключ-АСТРОМ, отличаются от того, что я привык видеть? Ключ-АСТРОМ выводит все метрики табличных пространств из представления DBA_TABLESPACE_USAGE_METRICS, которое предоставляет собственные расчёты Oracle.

Почему я вижу дублирующиеся сущности? При мониторинге конфигураций RAC расширение автоматически обнаруживает ноды из представлений GV$. Настройте мониторинг только для слушателя кластера, а не для каждой отдельной ноды.

Почему я не вижу свои базы данных? Если данных для базы данных вообще нет, наиболее вероятная причина — проблема подключения между АктивныйШлюз и сервером базы данных.

Где искать диагностические логи? Подробные сообщения об ошибках находятся в каталоге логов АктивныйШлюз на сервере.

Устранение неполадок

Для устранения неполадок этого расширения используйте руководства в сообществе Ключ-АСТРОМ.

Расширения

Изучите в разделе Расширения.

Сбор метрик и журналов аудита Oracle Database для мониторинга производительности и безопасности.

Источник — https://doc.ruscomtech.ru/index.php?title=Расширения_Oracle_Database&oldid=6762