Wtyczka Oracle

Przegląd

Parametry konfiguracji umożliwiają dostosowanie działania wtyczki Oracle.

Zaleca się określanie ich w osobnym pliku konfiguracyjnym (np. oracle.conf), a nie w pliku konfiguracyjnym agenta 2. Następnie użyj dyrektywy Include, aby dołączyć ten plik do konfiguracji Zabbix agent 2.

Wszystkie parametry są opcjonalne, chyba że wyraźnie zaznaczono, że dany parametr jest obowiązkowy.

Należy pamiętać, że:

  • Wartości domyślne odzwierciedlają domyślne ustawienia procesu, a nie wartości w dostarczonych plikach konfiguracyjnych.
  • Wartości obsługują zmienne środowiskowe.
  • Zabbix obsługuje pliki konfiguracyjne wyłącznie w kodowaniu UTF-8 bez BOM.
  • Komentarze rozpoczynające się od "#" są obsługiwane tylko na początku wiersza.

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.

Parametry

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Maksymalny czas oczekiwania w sekundach na zakończenie żądania.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Maksymalny czas oczekiwania w sekundach na nawiązanie połączenia.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle dla systemów Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle dla systemów Windows, gdzie * jest nazwą dysku z zmiennej środowiskowej ProgramFiles		 Pełna ścieżka do katalogu zawierającego pliki .sql z niestandardowymi zapytaniami.
Przykład: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Jeśli ustawione, włącza wykonywanie klucza pozycji oracle.custom.query. Jeśli wyłączone, żadne zapytania nie będą ładowane z katalogu niestandardowych zapytań.
Plugins.Oracle.Default.Password no Domyślne hasło do łączenia z Oracle; używane, jeśli nie podano wartości w kluczu pozycji lub nazwanej sesji.
Plugins.Oracle.Default.Service no Domyślna nazwa usługi do łączenia z Oracle (SID nie jest obsługiwany); używana, jeśli nie podano wartości w kluczu pozycji lub nazwanej sesji.
Plugins.Oracle.Default.Uri no Domyślny URI do łączenia z Oracle; używany, jeśli nie podano wartości w kluczu pozycji lub nazwanej sesji.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi odpowiadać formatowi URI.
Obsługiwane są tylko schematy tcp i tcps; schemat może zostać pominięty.
Port może zostać pominięty (domyślnie=1521).
Możliwe jest również określenie klucza TNS lub wartości TNS jako ciągu połączenia. Wartość TNS musi być zapisana bez spacji.
Przykłady: tcp://127.0.0.1:1521
localhost
zbx_tns_example (klucz TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (wartość TNS)
Plugins.Oracle.Default.User no Domyślna nazwa użytkownika do łączenia z Oracle; używana, jeśli nie podano wartości w kluczu pozycji lub nazwanej sesji.
Plugins.Oracle.KeepAlive no 60-900 300 Maksymalny czas oczekiwania (w sekundach) przed zamknięciem nieużywanych połączeń wtyczki.
Plugins.Oracle.ResolveTNS no true / false true Opcja określa, jak interpretować ciąg połączenia (ConnString) podczas łączenia z serwerem Oracle.
Jeśli ma wartość false, do ConnString zostaną dodane domyślny schemat i port (jeśli ich brakuje). Jeśli opcja ma wartość true, domyślny schemat i port zostaną pominięte (chyba że zostały jawnie określone w ConnString), a ConnString zostanie przekazany do klienta Oracle bez zmian. Jeśli klient Oracle znajdzie ConnString w pliku tnsnames.ora, do połączenia z serwerem Oracle zostanie użyty znaleziony opis połączenia.
Plugins.Oracle.Sessions.<SessionName>.Password no Hasło nazwanej sesji.
<SessionName> - określ nazwę sesji do użycia w kluczach pozycji.
Plugins.Oracle.Sessions.<SessionName>.Service no Nazwa usługi nazwanej sesji używana do połączenia (SID nie jest obsługiwany).
<SessionName> - określ nazwę sesji do użycia w kluczach pozycji.
Plugins.Oracle.Sessions.<SessionName>.Uri no Ciąg połączenia nazwanej sesji dla Oracle.
<SessionName> - określ nazwę sesji do użycia w kluczach pozycji.

Nie powinien zawierać osadzonych poświadczeń (zostaną zignorowane).
Musi odpowiadać formatowi URI.
Obsługiwane są tylko schematy tcp i tcps; schemat może zostać pominięty.
Port może zostać pominięty (domyślnie=1521).
Możliwe jest również określenie klucza TNS lub wartości TNS jako ciągu połączenia. Wartość TNS musi być zapisana bez spacji.
Przykłady: tcp://127.0.0.1:1521
localhost
zbx_tns_example (klucz TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (wartość TNS)
Plugins.Oracle.Sessions.<SessionName>.User no Nazwa użytkownika nazwanej sesji.
<SessionName> - określ nazwę sesji do użycia w kluczach pozycji.

Zobacz także: