Complemento de Oracle

Descripción general

Los parámetros de configuración permiten personalizar el comportamiento del plugin de Oracle.

Se recomienda especificarlos en su propio archivo de configuración (por ejemplo, oracle.conf), en lugar de hacerlo en el archivo de configuración del agent 2. Luego, use la directiva Include para incluir este archivo en la configuración de Zabbix agent 2.

Todos los parámetros son opcionales, salvo que se indique explícitamente que el parámetro es obligatorio.

Tenga en cuenta que:

  • Los valores predeterminados reflejan los valores predeterminados del proceso, no los valores de los archivos de configuración suministrados.
  • Los valores admiten variables de entorno.
  • Zabbix solo admite archivos de configuración en codificación UTF-8 sin BOM.
  • Los comentarios que comienzan con "#" solo se admiten al principio de la línea.

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.

Parámetros

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout El tiempo máximo de espera, en segundos, para que se complete una solicitud.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout El tiempo máximo de espera, en segundos, para que se establezca una conexión.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle para sistemas Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle para sistemas Windows, donde * es el nombre de la unidad de la variable de entorno ProgramFiles
Ruta completa de un directorio que contiene archivos .sql con consultas personalizadas.
Ejemplo: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Si se establece, habilita la ejecución de la clave de item oracle.custom.query. Si está deshabilitado, no se cargarán consultas desde la ruta del directorio de consultas personalizadas.
Plugins.Oracle.Default.Password no Contraseña predeterminada para conectarse a Oracle; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.
Plugins.Oracle.Default.Service no Nombre de servicio predeterminado para conectarse a Oracle (SID no es compatible); se usa si no se especifica ningún valor en una clave de item o sesión con nombre.
Plugins.Oracle.Default.Uri no URI predeterminada para conectarse a Oracle; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.

No debe incluir credenciales incrustadas (se ignorarán).
Debe coincidir con el formato URI.
Solo se admiten los esquemas tcp y tcps; se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=1521).
También es posible especificar la clave TNS o el valor TNS como cadena de conexión. El valor TNS debe componerse sin espacios en blanco.
Ejemplos: tcp://127.0.0.1:1521
localhost
zbx_tns_example (clave TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valor TNS)
Plugins.Oracle.Default.User no Nombre de usuario predeterminado para conectarse a Oracle; se usa si no se especifica ningún valor en una clave de item o sesión con nombre.
Plugins.Oracle.KeepAlive no 60-900 300 El tiempo máximo de espera (en segundos) antes de cerrar las conexiones del plugin que no se estén usando.
Plugins.Oracle.ResolveTNS no true / false true La opción especifica cómo interpretar la cadena de conexión (ConnString) para conectarse al servidor Oracle.
Si se establece en false, el esquema y el puerto predeterminados se agregarán a ConnString (si faltan). Si la opción se establece en true, el esquema y el puerto predeterminados se omitirán (a menos que se especifiquen explícitamente en ConnString), y ConnString se pasará al cliente de Oracle tal como está. Si el cliente de Oracle encuentra ConnString en el archivo tnsnames.ora, se usará la descripción de conexión encontrada para conectarse al servidor Oracle.
Plugins.Oracle.Sessions.<SessionName>.Password no Contraseña de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Oracle.Sessions.<SessionName>.Service no Nombre de servicio de la sesión con nombre que se usará para la conexión (SID no es compatible).
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.
Plugins.Oracle.Sessions.<SessionName>.Uri no Cadena de conexión de la sesión con nombre para Oracle.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

No debe incluir credenciales incrustadas (se ignorarán).
Debe coincidir con el formato URI.
Solo se admiten los esquemas tcp y tcps; se puede omitir un esquema.
Se puede omitir un puerto (predeterminado=1521).
También es posible especificar la clave TNS o el valor TNS como cadena de conexión. El valor TNS debe componerse sin espacios en blanco.
Ejemplos: tcp://127.0.0.1:1521
localhost
zbx_tns_example (clave TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valor TNS)
Plugins.Oracle.Sessions.<SessionName>.User no Nombre de usuario de la sesión con nombre.
<SessionName> - define el nombre de una sesión para usarlo en las claves de item.

Véase también: