Oracle spraudnis

Pārskats

Konfigurācijas parametri ļauj pielāgot Oracle spraudņa darbību.

Ieteicams tos norādīt atsevišķā konfigurācijas failā (piem., oracle.conf), nevis aģenta 2 konfigurācijas failā. Pēc tam izmantojiet direktīvu Include, lai iekļautu šo failu Zabbix aģenta 2 konfigurācijā.

Visi parametri ir neobligāti, ja vien nav skaidri norādīts, ka parametrs ir obligāts.

Ņemiet vērā:

  • Noklusējuma vērtības atspoguļo procesa noklusējumus, nevis vērtības piegādātajos konfigurācijas failos.
  • Vērtības atbalsta vides mainīgos.
  • Zabbix atbalsta konfigurācijas failus tikai UTF-8 kodējumā bez BOM.
  • Komentāri, kas sākas ar "#", tiek atbalstīti tikai rindas sākumā.

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.

Parametri

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Maksimālais gaidīšanas laiks sekundēs, līdz pieprasījums tiek izpildīts.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Maksimālais gaidīšanas laiks sekundēs, līdz tiek izveidots savienojums.
Plugins.Oracle.CustomQueriesPath no /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		 Pilns ceļš uz direktoriju, kurā atrodas .sql faili ar pielāgotiem vaicājumiem.
Piemērs: /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Ja iestatīts, iespējo oracle.custom.query vienums atslēgas izpildi. Ja atspējots, no pielāgoto vaicājumu direktorija ceļa netiks ielādēts neviens vaicājums.
Plugins.Oracle.Default.Password no Noklusējuma parole savienojumam ar Oracle; tiek izmantota, ja vienums atslēgā vai nosauktajā sesijā nav norādīta vērtība.
Plugins.Oracle.Default.Service no Noklusējuma pakalpojuma nosaukums savienojumam ar Oracle (SID netiek atbalstīts); tiek izmantots, ja vienums atslēgā vai nosauktajā sesijā nav norādīta vērtība.
Plugins.Oracle.Default.Uri no Noklusējuma URI savienojumam ar Oracle; tiek izmantots, ja vienums atslēgā vai nosauktajā sesijā nav norādīta vērtība.

Nedrīkst ietvert iegultus akreditācijas datus (tie tiks ignorēti).
Jāatbilst URI formātam.
Tiek atbalstītas tikai tcp un tcps shēmas; shēmu var arī nenorādīt.
Portu var nenorādīt (noklusējums=1521).
Ir iespējams arī norādīt TNS atslēgu vai TNS vērtību kā savienojuma virkni. TNS vērtība jānorāda bez atstarpēm.
Piemēri: tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS atslēga)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS vērtība)
Plugins.Oracle.Default.User no Noklusējuma lietotājvārds savienojumam ar Oracle; tiek izmantots, ja vienums atslēgā vai nosauktajā sesijā nav norādīta vērtība.
Plugins.Oracle.KeepAlive no 60-900 300 Maksimālais gaidīšanas laiks (sekundēs) pirms neizmantotie spraudņa savienojumi tiek slēgti.
Plugins.Oracle.ResolveTNS no true / false true Šī opcija nosaka, kā interpretēt savienojuma virkni (ConnString), veidojot savienojumu ar Oracle serveri.
Ja tā ir iestatīta uz false, ConnString tiks pievienota noklusējuma shēma un ports (ja tie nav norādīti). Ja opcija ir iestatīta uz true, noklusējuma shēma un ports netiks iekļauti (ja vien tie nav skaidri norādīti ConnString), un ConnString tiks nodota Oracle klientam tāda, kāda tā ir. Ja Oracle klients atrod ConnString failā tnsnames.ora, savienojuma izveidei tiks izmantots atrastais savienojuma apraksts.
Plugins.Oracle.Sessions.<SessionName>.Password no Nosauktās sesijas parole.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienums atslēgās.
Plugins.Oracle.Sessions.<SessionName>.Service no Nosauktās sesijas pakalpojuma nosaukums, ko izmantot savienojumam (SID netiek atbalstīts).
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienums atslēgās.
Plugins.Oracle.Sessions.<SessionName>.Uri no Nosauktās sesijas savienojuma virkne Oracle.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienums atslēgās.

Nedrīkst ietvert iegultus akreditācijas datus (tie tiks ignorēti).
Jāatbilst URI formātam.
Tiek atbalstītas tikai tcp un tcps shēmas; shēmu var arī nenorādīt.
Portu var nenorādīt (noklusējums=1521).
Ir iespējams arī norādīt TNS atslēgu vai TNS vērtību kā savienojuma virkni. TNS vērtība jānorāda bez atstarpēm.
Piemēri: tcp://127.0.0.1:1521
localhost
zbx_tns_example (TNS atslēga)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (TNS vērtība)
Plugins.Oracle.Sessions.<SessionName>.User no Nosauktās sesijas lietotājvārds.
<SessionName> - definējiet sesijas nosaukumu izmantošanai vienums atslēgās.

Skatiet arī: