Plugin Oracle

Vue d'ensemble

Les paramètres de configuration permettent de personnaliser le comportement du plugin Oracle.

Il est recommandé de les spécifier dans leur propre fichier de configuration (par exemple oracle.conf), plutôt que dans le fichier de configuration de l'agent 2. Utilisez ensuite la directive Include pour inclure ce fichier dans la configuration de Zabbix agent 2.

Tous les paramètres sont facultatifs, sauf indication explicite précisant que le paramètre est obligatoire.

Notez que :

  • Les valeurs par défaut reflètent les valeurs par défaut du processus, et non celles des fichiers de configuration fournis.
  • Les valeurs prennent en charge les variables d'environnement.
  • Zabbix prend en charge les fichiers de configuration uniquement en encodage UTF-8 sans BOM.
  • Les commentaires commençant par "#" ne sont pris en charge qu'au début de la ligne.

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.

Paramètres

Parameter Mandatory Range Default Description
Plugins.Oracle.CallTimeout no 1-30 global timeout Temps d'attente maximal, en secondes, pour qu'une requête soit exécutée.
Plugins.Oracle.ConnectTimeout no 1-30 global timeout Temps d'attente maximal, en secondes, pour qu'une connexion soit établie.
Plugins.Oracle.CustomQueriesPath no /usr/local/share/zabbix/custom-queries/oracle pour les systèmes Unix

*:\Program Files\Zabbix Agent 2\Custom Queries\Oracle pour les systèmes Windows, où * est le nom du lecteur provenant de la variable d'environnement ProgramFiles		 Chemin complet d'un répertoire contenant des fichiers .sql avec des requêtes personnalisées.
Exemple : /etc/zabbix/oracle/sql
Plugins.Oracle.CustomQueriesEnabled no false Si cette option est définie, elle active l'exécution de la clé d'élément oracle.custom.query. Si elle est désactivée, aucune requête ne sera chargée depuis le chemin du répertoire des requêtes personnalisées.
Plugins.Oracle.Default.Password no Mot de passe par défaut pour la connexion à Oracle ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.Oracle.Default.Service no Nom de service par défaut pour la connexion à Oracle (SID n'est pas pris en charge) ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.Oracle.Default.Uri no URI par défaut pour la connexion à Oracle ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.

Ne doit pas inclure d'identifiants intégrés (ils seront ignorés).
Doit correspondre au format URI.
Seuls les schémas tcp et tcps sont pris en charge ; un schéma peut être omis.
Un port peut être omis (par défaut=1521).
Il est également possible de spécifier la clé TNS ou la valeur TNS comme chaîne de connexion. La valeur TNS doit être composée sans espaces.
Exemples : tcp://127.0.0.1:1521
localhost
zbx_tns_example (clé TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valeur TNS)
Plugins.Oracle.Default.User no Nom d'utilisateur par défaut pour la connexion à Oracle ; utilisé si aucune valeur n'est spécifiée dans une clé d'élément ou une session nommée.
Plugins.Oracle.KeepAlive no 60-900 300 Temps d'attente maximal (en secondes) avant la fermeture des connexions de plugin inutilisées.
Plugins.Oracle.ResolveTNS no true / false true Cette option spécifie comment interpréter la chaîne de connexion (ConnString) pour la connexion au serveur Oracle.
Si elle est définie sur false, le schéma et le port par défaut seront ajoutés à ConnString (s'ils sont absents). Si l'option est définie sur true, le schéma et le port par défaut seront omis (sauf s'ils sont explicitement spécifiés dans ConnString), et ConnString sera transmis au client Oracle tel quel. Si le client Oracle trouve ConnString dans le fichier tnsnames.ora, la description de connexion trouvée sera utilisée pour se connecter au serveur Oracle.
Plugins.Oracle.Sessions.<SessionName>.Password no Mot de passe de la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.Oracle.Sessions.<SessionName>.Service no Nom de service de la session nommée à utiliser pour la connexion (SID n'est pas pris en charge).
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.
Plugins.Oracle.Sessions.<SessionName>.Uri no Chaîne de connexion de la session nommée pour Oracle.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.

Ne doit pas inclure d'identifiants intégrés (ils seront ignorés).
Doit correspondre au format URI.
Seuls les schémas tcp et tcps sont pris en charge ; un schéma peut être omis.
Un port peut être omis (par défaut=1521).
Il est également possible de spécifier la clé TNS ou la valeur TNS comme chaîne de connexion. La valeur TNS doit être composée sans espaces.
Exemples : tcp://127.0.0.1:1521
localhost
zbx_tns_example (clé TNS)
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=localhost)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=xe))) (valeur TNS)
Plugins.Oracle.Sessions.<SessionName>.User no Nom d'utilisateur de la session nommée.
<SessionName> - définir le nom d'une session à utiliser dans les clés d'élément.

Voir aussi :