Plugin Oracle

Panoramica

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

Si consiglia di specificarli in un file di configurazione separato (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.

Questa pagina è strutturata come segue:

  • Panoramica dei parametri (per vedere i dettagli completi di un parametro, fare clic sul suo nome)
  • Dettagli dei parametri
Parameter Description
Plugins.Oracle.CallTimeout Specifica il tempo massimo di attesa, in secondi, per il completamento di una richiesta.
Plugins.Oracle.ConnectTimeout Specifica il tempo massimo di attesa, in secondi, per l'instaurazione di una connessione.
Plugins.Oracle.CustomQueriesPath Specifica il percorso completo della directory contenente i file .sql con query personalizzate.
Plugins.Oracle.CustomQueriesEnabled Abilita l'esecuzione della chiave item oracle.custom.query.
Plugins.Oracle.Default.Password Specifica la password predefinita.
Plugins.Oracle.Default.Service Specifica il nome del servizio predefinito.
Plugins.Oracle.Default.URI Specifica l'URI predefinito.
Plugins.Oracle.Default.User Specifica il nome utente predefinito.
Plugins.Oracle.KeepAlive Imposta il tempo massimo di attesa (in secondi) prima che le connessioni del plugin non utilizzate vengano chiuse.
Plugins.Oracle.ResolveTNS Specifica come interpretare la stringa di connessione (ConnString) per connettersi al server Oracle.
Plugins.Oracle.Sessions.<SessionName>.Password Specifica la password della sessione denominata.
Plugins.Oracle.Sessions.<SessionName>.Service Specifica il nome del servizio della sessione denominata.
Plugins.Oracle.Sessions.<SessionName>.URI Specifica l'URI della sessione denominata.
Plugins.Oracle.Sessions.<SessionName>.User Specifica il nome utente della sessione denominata.

Si noti che:

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

Dettagli dei parametri

Plugins.Oracle.CallTimeout

Specifica il tempo massimo di attesa, in secondi, affinché una richiesta venga completata.

Predefinito: default timeout
Intervallo: 1-30

Plugin.Oracle.ConnectTimeout

Specifica il tempo massimo di attesa, in secondi, per stabilire una connessione.

Predefinito: default timeout
Intervallo: 1-30

Plugins.Oracle.CustomQueriesPath

Specifica il percorso completo della directory contenente i file .sql con query personalizzate.

Valori predefiniti:
/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à ricavato dalla variabile di ambiente ProgramFiles)

Esempio:

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

Abilita l'esecuzione della chiave item oracle.custom.query.
Se disabilitato, non verranno caricate query dal percorso della directory delle query personalizzate.

Predefinito: false
Intervallo: true/false

Plugins.Oracle.Default.Password

Specifica la password predefinita per la connessione a Oracle.
Utilizzata se non è specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.Oracle.Default.Service

Specifica il nome del servizio predefinito per la connessione a Oracle (SID non è supportato).
Utilizzato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.Oracle.Default.Uri

Specifica l'URI predefinito per la connessione a Oracle.
Usato se non è specificato alcun valore in una chiave item o in una sessione denominata.
Le credenziali incorporate verranno ignorate.
Deve corrispondere al formato URI.
Schemi supportati: tcp, 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)
Plugin.Oracle.Default.User

Specifica il nome utente predefinito per la connessione a Oracle.
Utilizzato se non viene specificato alcun valore in una chiave item o in una sessione denominata.

Plugins.Oracle.KeepAlive

Imposta il tempo massimo di attesa (in secondi) prima che le connessioni del plugin inutilizzate vengano chiuse.

Predefinito: 300
Intervallo: 60-900

Plugins.Oracle.ResolveTNS

Specifica come interpretare la stringa di connessione (ConnString) per connettersi al server Oracle.
Se è impostato 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.

Predefinito: true
Intervallo: true/false

Plugins.Oracle.Sessions.<SessionName>.Password

Specifica la password della sessione denominata per la connessione a Oracle.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Plugins.Oracle.Sessions.<SessionName>.Service

Specificare il nome del servizio della sessione denominata per la connessione a Oracle (SID non è supportato).
<SessionName> - definire il nome di una sessione da usare nelle chiavi degli item.

Plugins.Oracle.Sessions.<SessionName>.Uri

Specifica l'URI della sessione denominata per la connessione a Oracle.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.
Le credenziali incorporate verranno ignorate.
Deve corrispondere al formato URI.
Schemi supportati: tcp, tcps
Lo schema può essere omesso.
La porta può essere omessa (default=1521).
È inoltre 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 (TNS key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)
Plugins.Oracle.Sessions.<SessionName>.User

Specifica il nome utente della sessione denominata per la connessione a Oracle.
<SessionName> - definisce il nome di una sessione da usare nelle chiavi degli item.

Vedi anche