Oracle-Plugin

Übersicht

Konfigurationsparameter ermöglichen die Anpassung des Verhaltens des Oracle-Plugins.

Es wird empfohlen, sie in einer eigenen Konfigurationsdatei (z. B. oracle.conf) anzugeben, statt in der Konfigurationsdatei von Agent 2. Verwenden Sie dann die Direktive Include, um diese Datei in die Konfiguration von Zabbix Agent 2 einzubinden.

Alle Parameter sind optional, sofern nicht ausdrücklich angegeben ist, dass der Parameter obligatorisch ist.

Beachten Sie:

  • Die Standardwerte entsprechen den Prozess-Standardeinstellungen, nicht den Werten in den mitgelieferten Konfigurationsdateien.
  • Werte unterstützen Umgebungsvariablen.
  • Zabbix unterstützt Konfigurationsdateien nur in UTF-8-Kodierung ohne BOM.
  • Kommentare, die mit "#" beginnen, werden nur am Zeilenanfang unterstützt.

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

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Die maximale Wartezeit in Sekunden, bis eine Anfrage abgeschlossen ist.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Die maximale Wartezeit in Sekunden, bis eine Verbindung hergestellt ist.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle für Unix-Systeme

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle für Windows-Systeme, wobei * der Laufwerksname aus der Umgebungsvariable ProgramFiles ist		 Vollständiger Pfad zu einem Verzeichnis mit .sql-Dateien mit benutzerdefinierten Abfragen.
Beispiel: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Wenn gesetzt, wird die Ausführung des Datenpunkt-Schlüssels oracle.custom.query aktiviert. Wenn deaktiviert, werden keine Abfragen aus dem Verzeichnispfad für benutzerdefinierte Abfragen geladen.
Plugins.Oracle.Default.Password no Standardpasswort für die Verbindung zu Oracle; wird verwendet, wenn im Datenpunkt-Schlüssel oder in einer benannten Sitzung kein Wert angegeben ist.
Plugins.Oracle.Default.Service no Standard-Servicename für die Verbindung zu Oracle (SID wird nicht unterstützt); wird verwendet, wenn im Datenpunkt-Schlüssel oder in einer benannten Sitzung kein Wert angegeben ist.
Plugins.Oracle.Default.Uri no Standard-URI für die Verbindung zu Oracle; wird verwendet, wenn im Datenpunkt-Schlüssel oder in einer benannten Sitzung kein Wert angegeben ist.

Darf keine eingebetteten Anmeldedaten enthalten (sie werden ignoriert).
Muss dem URI-Format entsprechen.
Es werden nur die Schemata tcp und tcps unterstützt; ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1521).
Es ist auch möglich, den TNS-Schlüssel oder den TNS-Wert als Verbindungszeichenfolge anzugeben. Der TNS-Wert muss ohne Leerzeichen zusammengesetzt sein.
Beispiele: tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS-Schlüssel)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS-Wert)
Plugins.Oracle.Default.User no Standardbenutzername für die Verbindung zu Oracle; wird verwendet, wenn im Datenpunkt-Schlüssel oder in einer benannten Sitzung kein Wert angegeben ist.
Plugins.Oracle.KeepAlive no 60-900 300 Die maximale Wartezeit in Sekunden, bevor ungenutzte Plugin-Verbindungen geschlossen werden.
Plugins.Oracle.ResolveTNS no true / false true Die Option legt fest, wie die Verbindungszeichenfolge (ConnString) für die Verbindung zum Oracle-Server interpretiert wird.
Wenn sie auf false gesetzt ist, werden das Standardschema und der Standardport zu ConnString hinzugefügt (falls nicht vorhanden). Wenn die Option auf true gesetzt ist, werden das Standardschema und der Standardport weggelassen (sofern in ConnString nicht ausdrücklich angegeben), und ConnString wird unverändert an den Oracle-Client übergeben. Wenn der Oracle-Client ConnString in der Datei tnsnames.ora findet, wird die gefundene Verbindungsbeschreibung für die Verbindung zum Oracle-Server verwendet.
Plugins.Oracle.Sessions.<SessionName>.Password no Passwort der benannten Sitzung.
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.
Plugins.Oracle.Sessions.<SessionName>.Service no Servicename der benannten Sitzung, der für die Verbindung verwendet wird (SID wird nicht unterstützt).
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.
Plugins.Oracle.Sessions.<SessionName>.Uri no Verbindungszeichenfolge der benannten Sitzung für Oracle.
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.

Darf keine eingebetteten Anmeldedaten enthalten (sie werden ignoriert).
Muss dem URI-Format entsprechen.
Es werden nur die Schemata tcp und tcps unterstützt; ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1521).
Es ist auch möglich, den TNS-Schlüssel oder den TNS-Wert als Verbindungszeichenfolge anzugeben. Der TNS-Wert muss ohne Leerzeichen zusammengesetzt sein.
Beispiele: tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS-Schlüssel)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS-Wert)
Plugins.Oracle.Sessions.<SessionName>.User no Benutzername der benannten Sitzung.
<SessionName> - Name einer Sitzung, die in Datenpunkt-Schlüsseln verwendet wird.

Siehe auch: