11 Oracle-Plugin

Übersicht

Dieser Abschnitt listet die Parameter auf, die in der Konfigurationsdatei des Oracle Zabbix Agent 2-Plugins (oracle.conf) unterstützt werden.

Beachten Sie:

  • Die Standardwerte spiegeln die Prozess-Standardeinstellungen wider, nicht die Werte 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

Parameter Mandatory Range Default Beschreibung
Plugins.Oracle.CallTimeout no 1-30 Timeout1 Die maximale Wartezeit in Sekunden, bis eine Anfrage abgeschlossen ist.
Dieser Parameter hat derzeit keine Auswirkung. Die maximale Wartezeit wird stattdessen durch das item timeout bestimmt.
Plugins.Oracle.ConnectTimeout no 1-30 Timeout1 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 item keys 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 item key 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 item key oder in einer benannten Sitzung kein Wert angegeben ist.
Plugins.Oracle.Default.Uri no tcp://localhost:1521 Standard-URI für die Verbindung zu Oracle; wird verwendet, wenn im item key oder in einer benannten Sitzung kein Wert angegeben ist.

Sollte keine eingebetteten Anmeldedaten enthalten (diese werden ignoriert).
Muss dem URI-Format entsprechen.
Es wird nur das tcp-Schema unterstützt; ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1521).
Seit Zabbix 7.4.3 ist es 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 item key 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 false Die Option legt fest, wie die Verbindungszeichenfolge (ConnString) im Metrikschlüssel commonParams interpretiert wird, um eine Verbindung zum Oracle-Server herzustellen.
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 sie nicht ausdrücklich in ConnString angegeben sind), 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.
Dieser Parameter wird seit Zabbix 7.4.3 unterstützt.
Plugins.Oracle.Sessions.<SessionName>.Password no Passwort der benannten Sitzung.
<SessionName> - Name einer Sitzung, der in item keys 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, der in item keys verwendet wird.
Plugins.Oracle.Sessions.<SessionName>.Uri no Verbindungszeichenfolge der benannten Sitzung für Oracle.
<SessionName> - Name einer Sitzung, der in item keys verwendet wird.

Sollte keine eingebetteten Anmeldedaten enthalten (diese werden ignoriert).
Muss dem URI-Format entsprechen.
Es wird nur das tcp-Schema unterstützt; ein Schema kann weggelassen werden.
Ein Port kann weggelassen werden (Standard=1521).
Seit Zabbix 7.4.3 ist es 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, der in item keys verwendet wird.

Siehe auch:

Fußnoten

1 Das Timeout wird durch die Option Timeout in der Konfigurationsdatei des Zabbix Agent 2 definiert (zabbix_agent2.conf oder zabbix_agent2.win.conf).