Плагин Oracle

Обзор

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

Рекомендуется указывать их в отдельном файле конфигурации (например, oracle.conf), а не в файле конфигурации агента 2. Затем используйте директиву Include, чтобы включить этот файл в конфигурацию Zabbix agent 2.

Все параметры являются необязательными, если явно не указано, что параметр обязателен.

Эта страница имеет следующую структуру:

  • Обзор параметров (чтобы увидеть полные сведения о параметре, щелкните его имя)
  • Сведения о параметрах
Parameter Description
Plugins.Oracle.CallTimeout Укажите максимальное время ожидания в секундах для завершения запроса.
Plugins.Oracle.ConnectTimeout Укажите максимальное время ожидания в секундах для установления соединения.
Plugins.Oracle.CustomQueriesPath Укажите полное имя пути к каталогу, содержащему файлы .sql с пользовательскими запросами.
Plugins.Oracle.CustomQueriesEnabled Включите выполнение ключа элемента данных oracle.custom.query.
Plugins.Oracle.Default.Password Укажите пароль по умолчанию.
Plugins.Oracle.Default.Service Укажите имя службы по умолчанию.
Plugins.Oracle.Default.URI Укажите URI по умолчанию.
Plugins.Oracle.Default.User Укажите имя пользователя по умолчанию.
Plugins.Oracle.KeepAlive Установите максимальное время ожидания (в секундах) перед закрытием неиспользуемых подключений плагина.
Plugins.Oracle.ResolveTNS Укажите, как интерпретировать строку подключения (ConnString) для подключения к серверу Oracle.
Plugins.Oracle.Sessions.<SessionName>.Password Укажите пароль именованной сессии.
Plugins.Oracle.Sessions.<SessionName>.Service Укажите имя службы именованной сессии.
Plugins.Oracle.Sessions.<SessionName>.URI Укажите URI именованной сессии.
Plugins.Oracle.Sessions.<SessionName>.User Укажите имя пользователя именованной сессии.

Обратите внимание:

  • Значения по умолчанию отражают значения по умолчанию процесса, а не значения в поставляемых файлах конфигурации.
  • Значения поддерживают переменные среды.
  • Zabbix поддерживает файлы конфигурации только в кодировке UTF-8 без BOM.
  • Комментарии, начинающиеся с "#", поддерживаются только в начале строки.

Подробности параметра

Plugins.Oracle.CallTimeout

Укажите максимальное время ожидания в секундах для завершения запроса.

По умолчанию: default timeout
Диапазон: 1-30

Plugins.Oracle.ConnectTimeout

Укажите максимальное время ожидания в секундах для установления соединения.

По умолчанию: default timeout
Диапазон: 1-30

Плагины.Oracle.CustomQueriesPath

Укажите полный путь к каталогу, содержащему файлы .sql с пользовательскими запросами.

По умолчанию:
/usr/local/share/zabbix/custom-queries/oracle - для систем Unix,
*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle - для систем Windows (где * - это имя диска из переменной среды ProgramFiles)

Пример:

/etc/zabbix/oracle/sql
Плагины.Oracle.CustomQueriesEnabled

Включает выполнение ключа элемента данных oracle.custom.query.
Если отключено, запросы не будут загружаться из пути к каталогу пользовательских запросов.

По умолчанию: false
Диапазон: true/false

Плагины.Oracle.Default.Password

Укажите пароль по умолчанию для подключения к Oracle.
Используется, если значение не указано в ключе элемента данных или именованной сессии.

Плагины.Oracle.Default.Service

Укажите имя службы по умолчанию для подключения к Oracle (SID не поддерживается).
Используется, если значение не указано в ключе элемента данных или именованной сессии.

Plugins.Oracle.Default.Uri

Укажите URI по умолчанию для подключения к Oracle.
Используется, если значение не указано в ключе элемента данных или именованной сессии.
Встроенные учетные данные будут проигнорированы.
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, tcps
Схема может быть опущена.
Порт может быть опущен (по умолчанию=1521).
Также можно указать ключ TNS или значение TNS в качестве строки подключения. Значение TNS должно быть составлено без пробелов.

Примеры:

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)
Плагины.Oracle.Default.User

Укажите имя пользователя по умолчанию для подключения к Oracle.
Используется, если значение не указано в ключе элемента данных или именованной сессии.

Plugins.Oracle.KeepAlive

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

По умолчанию: 300
Диапазон: 60-900

Plugins.Oracle.ResolveTNS

Укажите, как интерпретировать строку подключения (ConnString) для подключения к серверу Oracle.
Если для нее задано значение false, к ConnString будут добавлены схема и порт по умолчанию (если они отсутствуют).
Если для параметра задано значение true, схема и порт по умолчанию не будут добавлены (если они не указаны явно в ConnString), а ConnString будет передана клиенту Oracle как есть. Если клиент Oracle найдет ConnString в файле tnsnames.ora, для подключения к серверу Oracle будет использовано найденное описание подключения.

По умолчанию: true
Диапазон: true/false

Plugins.Oracle.Sessions.<SessionName>.Password

Укажите пароль для именованной сессии, используемой для подключения к Oracle.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

Plugins.Oracle.Sessions.<SessionName>.Service

Укажите имя службы именованной сессии для подключения к Oracle (SID не поддерживается).
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

Plugins.Oracle.Sessions.<SessionName>.Uri

Укажите URI именованной сессии для подключения к Oracle.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.
Встроенные учетные данные будут проигнорированы.
Должен соответствовать формату URI.
Поддерживаемые схемы: tcp, tcps
Схема может быть опущена.
Порт может быть опущен (по умолчанию=1521).
Также можно указать ключ TNS или значение TNS в качестве строки подключения. Значение TNS должно быть составлено без пробелов.

Примеры:

tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)
Plugins.Oracle.Sessions.<SessionName>.User

Укажите имя пользователя для именованной сессии, используемой для подключения к Oracle.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

См. также