Oracle-Plugin

Übersicht

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

Es wird empfohlen, sie in einer eigenen Konfigurationsdatei anzugeben (z. B. oracle.conf) und nicht 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.

Diese Seite ist wie folgt aufgebaut:

  • Parameterübersicht (um die vollständigen Details eines Parameters anzuzeigen, klicken Sie auf seinen Namen)
  • Parameterdetails
Parameter Beschreibung
Plugins.Oracle.CallTimeout Geben Sie die maximale Wartezeit in Sekunden an, bis eine Anfrage abgeschlossen ist.
Plugins.Oracle.ConnectTimeout Geben Sie die maximale Wartezeit in Sekunden an, bis eine Verbindung hergestellt ist.
Plugins.Oracle.CustomQueriesPath Geben Sie den vollständigen Pfadnamen des Verzeichnisses an, das .sql-Dateien mit benutzerdefinierten Abfragen enthält.
Plugins.Oracle.CustomQueriesEnabled Aktivieren Sie die Ausführung des Datenpunkt-Schlüssels oracle.custom.query.
Plugins.Oracle.Default.Password Geben Sie das Standardpasswort an.
Plugins.Oracle.Default.Service Geben Sie den Standard-Servicenamen an.
Plugins.Oracle.Default.URI Geben Sie die Standard-URI an.
Plugins.Oracle.Default.User Geben Sie den Standard-Benutzernamen an.
Plugins.Oracle.KeepAlive Legen Sie die maximale Wartezeit in Sekunden fest, bevor ungenutzte Plugin-Verbindungen geschlossen werden.
Plugins.Oracle.ResolveTNS Geben Sie an, wie die Verbindungszeichenfolge (ConnString) für die Verbindung mit dem Oracle-Server interpretiert werden soll.
Plugins.Oracle.Sessions.<SessionName>.Password Geben Sie das Passwort der benannten Sitzung an.
Plugins.Oracle.Sessions.<SessionName>.Service Geben Sie den Servicenamen der benannten Sitzung an.
Plugins.Oracle.Sessions.<SessionName>.URI Geben Sie die URI der benannten Sitzung an.
Plugins.Oracle.Sessions.<SessionName>.User Geben Sie den Benutzernamen der benannten Sitzung an.

Beachten Sie Folgendes:

  • 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 Anfang der Zeile unterstützt.

Parameterdetails

Plugins.Oracle.CallTimeout

Geben Sie die maximale Wartezeit in Sekunden an, bis eine Anforderung abgeschlossen ist.

Standard: default timeout
Bereich: 1-30

Plugins.Oracle.ConnectTimeout

Geben Sie die maximale Wartezeit in Sekunden an, bis eine Verbindung hergestellt wird.

Standard: default timeout
Bereich: 1-30

Plugins.Oracle.CustomQueriesPath

Geben Sie den vollständigen Pfadnamen des Verzeichnisses an, das .sql-Dateien mit benutzerdefinierten Abfragen enthält.

Standardwerte:
/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)

Beispiel:

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

Aktiviert die Ausführung des Datenpunkt-Schlüssels oracle.custom.query.
Wenn diese Option deaktiviert ist, werden keine Abfragen aus dem Verzeichnispfad für benutzerdefinierte Abfragen geladen.

Standard: false
Bereich: true/false

Plugins.Oracle.Default.Password

Geben Sie das Standardpasswort für die Verbindung zu Oracle an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.Oracle.Default.Service

Geben Sie den Standarddienstnamen für die Verbindung zu Oracle an (SID wird nicht unterstützt).
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.Oracle.Default.Uri

Geben Sie die Standard-URI für die Verbindung zu Oracle an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.
Eingebettete Anmeldedaten werden ignoriert.
Muss dem URI-Format entsprechen.
Unterstützte Schemas: tcp, tcps
Das Schema kann weggelassen werden.
Der 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 werden.

Beispiele:

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

Geben Sie den Standardbenutzernamen für die Verbindung zu Oracle an.
Wird verwendet, wenn in einem Datenpunkt-Schlüssel oder einer benannten Sitzung kein Wert angegeben ist.

Plugins.Oracle.KeepAlive

Legt die maximale Wartezeit (in Sekunden) fest, bevor ungenutzte Plugin-Verbindungen geschlossen werden.

Standard: 300
Bereich: 60-900

Plugins.Oracle.ResolveTNS

Geben Sie an, wie die Verbindungszeichenfolge (ConnString) für die Verbindung zum Oracle-Server interpretiert werden soll.
Wenn der Wert auf false gesetzt ist, werden das Standardschema und der Standardport zu ConnString hinzugefügt (falls sie fehlen).
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.

Standard: true
Bereich: true/false

Plugins.Oracle.Sessions.<SessionName>.Password

Geben Sie das Passwort der benannten Sitzung für die Verbindung zu Oracle an.
<SessionName> - Name einer Sitzung definieren, die in Datenpunkt-Schlüsseln verwendet wird.

Plugins.Oracle.Sessions.<SessionName>.Service

Geben Sie den Namen des benannten Sitzungsdienstes für die Verbindung zu Oracle an (SID wird nicht unterstützt).
<SessionName> - Name einer Sitzung definieren, der in Datenpunktschlüsseln verwendet wird.

Plugins.Oracle.Sessions.<SessionName>.Uri

Geben Sie die URI der benannten Sitzung für die Verbindung zu Oracle an.
<SessionName> - definiert den Namen einer Sitzung zur Verwendung in Datenpunkt-Schlüsseln.
Eingebettete Anmeldedaten werden ignoriert.
Muss dem URI-Format entsprechen.
Unterstützte Schemas: tcp, tcps
Das Schema kann weggelassen werden.
Der 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 key)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS value)
Plugins.Oracle.Sessions.<SessionName>.User

Geben Sie den Benutzernamen der benannten Sitzung für die Verbindung zu Oracle an.
<SessionName> - Name einer Sitzung festlegen, die in Datenpunkt-Schlüsseln verwendet wird.

Siehe auch