Fonctionnement du modèle ODBC

Étapes pour garantir le bon fonctionnement des modèles qui collectent des métriques via la surveillance ODBC:

1. Assurez-vous que le pilote ODBC requis est installé sur le serveur ou le proxy Zabbix.\

  1. Liez le modèle à un hôte cible (si le modèle n'est pas disponible dans votre installation Zabbix, vous devrez peut-être d'abord importer le fichier .xml du modèle - voir la section des Modèles prêts à l'emploi pour les connaitre les instructions).\
  2. Ajustez les valeurs des macros obligatoires selon vos besoins.
    Si un mot de passe placé dans la valeur de la macro contient un point-virgule (;), il doit être entouré d'accolades, voir la Surveillance ODBC pour plus de détails.
  3. Configurez l'instance surveillée pour autoriser le partage de données avec Zabbix - voir les instructions dans la colonne Étapes supplémentaires/commentaires.

Cette page ne contient qu'un ensemble minimal de macros et d'étapes de configuration nécessaires au bon fonctionnement du modèle. Une description détaillée d'un modèle, y compris la liste complète des macros, des éléments et des déclencheurs, est disponible dans le fichier Readme.md du modèle (accessible en cliquant sur un nom de modèle).

Modèle Macros obligatoires Étapes/commentaires supplémentaires
MSSQL by ODBC {\$MSSQL.DSN} - le nom de la source de données système (par défaut : <Put your DSN here>)
{\$MSSQL.PORT} - le port TCP de Microsoft SQL Server (par défaut : 1433)
{\$MSSQL.USER}, {\$MSSQL.PASSWORD} - Identifiants de connexion Microsoft SQL (par défaut : non défini)		 Créez un utilisateur Microsoft SQL pour la surveillance et accordez-lui les autorisations suivantes : Afficher l'état du serveur ; Afficher n'importe quelle définition (voir la documentation Microsoft SQL pour plus de détails).

L'élément "Etat du port TCP du service" utilise les macros {HOST.CONN} et {$MSSQL.PORT} pour vérifier la disponibilité de l'instance Microsoft SQL.
MySQL by ODBC {\$MYSQL.DSN} - le nom de la source de données système (par défaut : <Put your DSN here>)
{\$MYSQL.USER}, {\$MYSQL.PASSWORD} - Identifiants de connexion MySQL ; le mot de passe peut être vide (par défaut : non défini)		 Pour accorder les privilèges requis à l'utilisateur MySQL qui sera utilisé pour la surveillance, exécutez :
GRANT USAGE,REPLICATION CLIENT,PROCESS,SHOW DATABASES,SHOW VIEW ON %% *.* TO '<username>'@'%';%%

Voir la documentation MYSQL pour plus de details.
Oracle by ODBC {\$ORACLE.DSN} - le nom de la source de données système (par défaut : <Put your DSN here>)
{\$ORACLE.PORT} - le port TCP de la base de données Oracle (par défaut : 1521)
{\$ORACLE.USER}, {\$ORACLE.PASSWORD} - Identifiants de connexion Oracle (par défaut : non définis)		 1. Pour créer un utilisateur Oracle pour la surveillance, exécutez :
CREATE USER zabbix_mon IDENTIFIED BY <PASSWORD>;
-- Accorder l'accès à l'utilisateur zabbix_mon.
GRANT CONNECT, CREATE SESSION TO zabbix_mon;
GRANT SELECT ON V_$instance TO zabbix_mon;
GRANT SELECT ON V_$database TO zabbix_mon;
GRANT SELECT ON v_$sysmetric TO zabbix_mon;
GRANT SELECT ON v$recovery_file_dest TO zabbix_mon;
GRANT SELECT ON v$active_session_history TO zabbix_mon;
GRANT SELECT ON v$osstat TO zabbix_mon;
GRANT SELECT ON v$restore_point TO zabbix_mon;
GRANT SELECT ON v$process TO zabbix_mon;
GRANT SELECT ON v$datafile TO zabbix_mon;
GRANT SELECT ON v$pgastat TO zabbix_mon;
GRANT SELECT ON v$sgastat TO zabbix_mon;
GRANT SELECT ON v$log TO zabbix_mon;
GRANT SELECT ON v$archive_dest TO zabbix_mon;
GRANT SELECT ON v$asm_diskgroup TO zabbix_mon;
GRANT SELECT ON sys.dba_data_files TO zabbix_mon;
GRANT SELECT ON DBA_TABLESPACES TO zabbix_mon;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS TO zabbix_mon;
GRANT SELECT ON DBA_USERS TO zabbix_mon;

2. Assurez-vous qu'ODBC se connecte à Oracle avec le paramètre de session NLS_NUMERIC_CHARACTERS= '.,'

3. Ajoutez un nouvel enregistrement dans odbc.ini :
[$ORACLE.DSN]
Driver = Oracle 19 ODBC driver
Servername = $ORACLE.DSN
DSN = $ORACLE.DSN

4. Vérifiez la connexion via isql :
isql $TNS_NAME $DB_USER $DB_PASSWORD

5. Configurez le serveur Zabbix ou le proxy Zabbix pour Oracle ENV Usage. Modifiez ou ajoutez un nouveau fichier : /etc/sysconfig/zabbix-server, ou pour le proxy : /etc/sysconfig/zabbix-proxy. Ajoutez ensuite les lignes suivantes au fichier :
export ORACLE_HOME=/usr/lib/oracle/19.6/client64
export PATH=$PATH:$ORACLE_HOME/bin
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:/usr/lib64:/usr/lib:$ORACLE_HOME/bin
export TNS_ADMIN=$ORACLE_HOME/network/admin

6. Redémarrez le serveur ou le proxy Zabbix.