Plugin Oracle

Panoramica

I parametri di configurazione consentono di personalizzare il comportamento del plugin Oracle.

Si consiglia di specificarli in un file di configurazione dedicato (ad esempio oracle.conf), anziché nel file di configurazione di agent 2. Quindi usare la direttiva Include per includere questo file nella configurazione di Zabbix agent 2.

Tutti i parametri sono opzionali, a meno che non sia esplicitamente indicato che il parametro è obbligatorio.

Nota che:

  • I valori predefiniti riflettono i valori predefiniti del processo, non i valori presenti nei file di configurazione forniti.
  • I valori supportano le variabili di ambiente.
  • Zabbix supporta file di configurazione solo in codifica UTF-8 senza BOM.
  • I commenti che iniziano con "#" sono supportati solo all'inizio della riga.

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.

Parametri

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Tempo massimo di attesa, in secondi, per il completamento di una richiesta.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Tempo massimo di attesa, in secondi, per l'instaurazione di una connessione.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle per sistemi Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle per sistemi Windows, dove * è il nome dell'unità dalla variabile di ambiente ProgramFiles		 Percorso completo di una directory contenente file .sql con query personalizzate.
Esempio: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Se impostato, abilita l'esecuzione della chiave item oracle.custom.query. Se disabilitato, non verrà caricato alcun query dal percorso della directory delle query personalizzate.
Plugins.Oracle.Default.Password no Password predefinita per la connessione a Oracle; usata se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Plugins.Oracle.Default.Service no Nome del servizio predefinito per la connessione a Oracle (SID non è supportato); usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Plugins.Oracle.Default.Uri no URI predefinito per la connessione a Oracle; usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Sono supportati solo gli schemi tcp e tcps; lo schema può essere omesso.
La porta può essere omessa (default=1521).
È anche possibile specificare la chiave TNS o il valore TNS come stringa di connessione. Il valore TNS deve essere composto senza spazi.
Esempi: tcp://127.0.0.1:1521
localhost
zbx_tns_example (chiave TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valore TNS)
Plugins.Oracle.Default.User no Nome utente predefinito per la connessione a Oracle; usato se non viene specificato alcun valore in una chiave item o in una sessione denominata.
Plugins.Oracle.KeepAlive no 60-900 300 Tempo massimo di attesa (in secondi) prima che le connessioni del plugin non utilizzate vengano chiuse.
Plugins.Oracle.ResolveTNS no true / false true L'opzione specifica come interpretare la stringa di connessione (ConnString) per la connessione al server Oracle.
Se impostata su false, lo schema e la porta predefiniti verranno aggiunti a ConnString (se assenti). Se l'opzione è impostata su true, lo schema e la porta predefiniti verranno omessi (a meno che non siano specificati esplicitamente in ConnString) e ConnString verrà passato al client Oracle così com'è. Se il client Oracle trova ConnString nel file tnsnames.ora, verrà utilizzata la descrizione di connessione trovata per connettersi al server Oracle.
Plugins.Oracle.Sessions.<SessionName>.Password no Password della sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Oracle.Sessions.<SessionName>.Service no Nome del servizio della sessione denominata da usare per la connessione (SID non è supportato).
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.
Plugins.Oracle.Sessions.<SessionName>.Uri no Stringa di connessione della sessione denominata per Oracle.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.

Non deve includere credenziali incorporate (verranno ignorate).
Deve corrispondere al formato URI.
Sono supportati solo gli schemi tcp e tcps; lo schema può essere omesso.
La porta può essere omessa (default=1521).
È anche possibile specificare la chiave TNS o il valore TNS come stringa di connessione. Il valore TNS deve essere composto senza spazi.
Esempi: tcp://127.0.0.1:1521
localhost
zbx_tns_example (chiave TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valore TNS)
Plugins.Oracle.Sessions.<SessionName>.User no Nome utente della sessione denominata.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi item.

Vedi anche: