Плагин Oracle

Обзор

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

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

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

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

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

Parameter details

Plugins.Oracle.CallTimeout

Specify the maximum wait time in seconds for a request to be completed.

Default: default timeout
Range: 1-30

Plugins.Oracle.ConnectTimeout

Specify the maximum wait time in seconds for a connection to be established.

Default: default timeout
Range: 1-30

Plugins.Oracle.CustomQueriesPath

Specify full pathname of the directory containing .sql files with custom queries.

Defaults:
/usr/local/share/zabbix/custom-queries/oracle - for Unix systems,
*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle - for Windows systems (where * is the drive name from the ProgramFiles environment variable)

Example: 

/etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled

Enable execution of the oracle.custom.query item key.
If disabled, no queries will be loaded from the custom query directory path.

Default: false
Range: true/false

Plugins.Oracle.Default.Password

Specify the default password for connecting to Oracle.
Used if no value is specified in an item key or named session.

Plugins.Oracle.Default.Service

Specify the default service name for connecting to Oracle (SID is not supported).
Used if no value is specified in an item key or named session.

Plugins.Oracle.Default.Uri

Specify the default URI for connecting to Oracle.
Used if no value is specified in an item key or named session.
Embedded credentials will be ignored.
Must match the URI format.
Supported schemes: tcp, tcps
The schema can be omitted.
The port can be omitted (default=1521).
It is also possible to specify the TNS key or TNS value as the connection string. The TNS value must be composed without whitespaces.

Examples: 

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.Default.User

Specify the default username for connecting to Oracle.
Used if no value is specified in an item key or named session.

Plugins.Oracle.KeepAlive

Set the maximum time of waiting (in seconds) before unused plugin connections are closed.

Default: 300
Range: 60-900

Plugins.Oracle.ResolveTNS

Specify how to interpret the connection string (ConnString) for connecting to the Oracle server.
If it is set to false the default scheme and port will be added to ConnString (if absent).
If the option is set to true, the default scheme and port will be omitted (unless explicitly specified in ConnString), and ConnString will be passed to the Oracle client as is. If the Oracle client finds ConnString in the tnsnames.ora file, the connection description found will be used to connect to the Oracle server.

Default: true
Range: true/false

Plugins.Oracle.Sessions.<SessionName>.Password

Specify the named session password for connecting to Oracle.
<SessionName> - define name of a session for using in item keys.

Plugins.Oracle.Sessions.<SessionName>.Service

Specify the named session service name for connecting to Oracle (SID is not supported).
<SessionName> - define name of a session for using in item keys.

Plugins.Oracle.Sessions.<SessionName>.Uri

Specify the named session URI for connecting to Oracle.
<SessionName> - define name of a session for using in item keys.
Embedded credentials will be ignored.
Must match the URI format.
Supported schemes: tcp, tcps
The schema can be omitted.
The port can be omitted (default=1521).
It is also possible to specify the TNS key or TNS value as the connection string. The TNS value must be composed without whitespaces.

Examples: 

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

Specify the named session username for connecting to Oracle.
<SessionName> - define name of a session for using in item keys.

Параметры

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Максимальное время ожидания в секундах до завершения запроса.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Максимальное время ожидания в секундах до установления соединения.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle для Unix-систем

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle для Windows-систем, где * — имя диска из переменной среды ProgramFiles		 Полный путь к каталогу, содержащему файлы .sql с пользовательскими запросами.
Пример: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Если задано, включает выполнение ключа элемента данных oracle.custom.query. Если отключено, запросы не будут загружаться из пути к каталогу пользовательских запросов.
Plugins.Oracle.Default.Password no Пароль по умолчанию для подключения к Oracle; используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.Oracle.Default.Service no Имя службы по умолчанию для подключения к Oracle (SID не поддерживается); используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.Oracle.Default.Uri no URI по умолчанию для подключения к Oracle; используется, если значение не указано в ключе элемента данных или именованной сессии.

Не должен содержать встроенные учетные данные (они будут проигнорированы).
Должен соответствовать формату URI.
Поддерживаются только схемы tcp и tcps; схему можно опустить.
Порт можно опустить (по умолчанию=1521).
Также можно указать ключ TNS или значение TNS в качестве строки подключения. Значение TNS должно быть составлено без пробелов.
Примеры: tcp://127.0.0.1:1521
localhost
zbx_tns_example (ключ TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (значение TNS)
Plugins.Oracle.Default.User no Имя пользователя по умолчанию для подключения к Oracle; используется, если значение не указано в ключе элемента данных или именованной сессии.
Plugins.Oracle.KeepAlive no 60-900 300 Максимальное время ожидания (в секундах) до закрытия неиспользуемых подключений плагина.
Plugins.Oracle.ResolveTNS no true / false true Параметр определяет, как интерпретировать строку подключения (ConnString) для подключения к серверу Oracle.
Если установлено значение false, к ConnString будут добавлены схема и порт по умолчанию (если они отсутствуют). Если параметр установлен в true, схема и порт по умолчанию будут опущены (если они явно не указаны в ConnString), а ConnString будет передан клиенту Oracle как есть. Если клиент Oracle найдет ConnString в файле tnsnames.ora, для подключения к серверу Oracle будет использовано найденное описание подключения.
Plugins.Oracle.Sessions.<SessionName>.Password no Пароль именованной сессии.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.
Plugins.Oracle.Sessions.<SessionName>.Service no Имя службы именованной сессии, используемое для подключения (SID не поддерживается).
<SessionName> - задайте имя сессии для использования в ключах элементов данных.
Plugins.Oracle.Sessions.<SessionName>.Uri no Строка подключения именованной сессии для Oracle.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

Не должна содержать встроенные учетные данные (они будут проигнорированы).
Должна соответствовать формату URI.
Поддерживаются только схемы tcp и tcps; схему можно опустить.
Порт можно опустить (по умолчанию=1521).
Также можно указать ключ TNS или значение TNS в качестве строки подключения. Значение TNS должно быть составлено без пробелов.
Примеры: tcp://127.0.0.1:1521
localhost
zbx_tns_example (ключ TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (значение TNS)
Plugins.Oracle.Sessions.<SessionName>.User no Имя пользователя именованной сессии.
<SessionName> - задайте имя сессии для использования в ключах элементов данных.

См. также: