- Complemento de Oracle
- Parameter details
- Plugins.Oracle.CallTimeout
- Plugins.Oracle.ConnectTimeout
- Plugins.Oracle.CustomQueriesPath
- Plugins.Oracle.CustomQueriesEnabled
- Plugins.Oracle.Default.Password
- Plugins.Oracle.Default.Service
- Plugins.Oracle.Default.Uri
- Plugins.Oracle.Default.User
- Plugins.Oracle.KeepAlive
- Plugins.Oracle.ResolveTNS
- Plugins.Oracle.Sessions.<SessionName>.Password
- Plugins.Oracle.Sessions.<SessionName>.Service
- Plugins.Oracle.Sessions.<SessionName>.Uri
- Plugins.Oracle.Sessions.<SessionName>.User
- Parámetros
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:1521localhostzbx_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:1521localhostzbx_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:
- Descripción de los parámetros de configuración generales de Zabbix agent 2: Zabbix agent 2 (UNIX) / Zabbix agent 2 (Windows)
- Instrucciones para configurar plugins