Aller au contenu principal

DB2 Database

Contenu du Pack

Objets supervisés

Le Pack DB2 collecte les données pour:

  • Connection-time
  • Connected-users
  • Database-logs
  • Database-usage
  • Hadr
  • Tablespaces

Règles de découvertes

Nom de la règleDescription
App-DB-Db2-Tablespace-NameDécouvre les tablespaces et supervise l'utilisation

Métriques collectées

Metric nameDescriptionUnit
connection.time.millisecondsConnection established timems

Prérequis

Installation des dépendances du Plugin

RPM

Pour utiliser le Pack DB2, il est nécessaire d'installer l'outil de ligne de commande wget et la collection de compilateurs GNU (gcc).

yum install -y gcc wget ksh

DB2 driver package

Se connecter sur le site du support IBM et télécharger l'archive data_server_driver_package_linuxx64_v11.5.tar.gz.

Installer l'archive avec les commande suivantes :

tar zxf ibm_data_server_driver_package_linuxx64_v11.5.tar.gz
mv dsdriver/ /opt/
cd /opt/dsdriver/
./installDSDriver
echo "/opt/dsdriver/lib/" > /etc/ld.so.conf.d/db2-x86_64.conf
/sbin/ldconfig

Bibliothèque Perl pour DB2

En tant que root, exécuter:

cd /usr/local/src 
wget https://cpan.metacpan.org/authors/id/R/RO/ROCKETDB/DBD-DB2-1.89.tar.gz
tar zxvf DBD-DB2-1.89.tar.gz
cd DBD-DB2-1.89/
export DB2LIB=/opt/dsdriver/lib/
export DB2_HOME=/opt/dsdriver/
perl Makefile.PL

Compiler la bibliothèque:

make

Puis l'installer:

make install

Compte d'utilisateur

La façon la plus sûre de récupérer des informations du serveur DB2 est de créer un utilisateur dédié à Centreon.

Ce compte utilisateur doit avoir la permission de lecture sur les tables suivantes :

  • syscat.tablespaces
  • sysibmadm.applications
  • sysibmadm.container_utilization
  • sysibmadm.log_utilization
  • sysibmadm.tbsp_utilization

Ce compte utilisateur doit avoir la permission d'exécuter la procédure SYSPROC.GET_DBSIZE_INFO et l'authorité SYSMON.

Installation

  1. Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Databases-Db2
  1. Sur l'interface Web de Centreon, installer le Pack DB2 Database depuis la page Configuration > Plugin Packs > Gestionnaire

Configuration

Ce Pack est conçu de manière à avoir dans Centreon un hôte par base de données IBM DB2. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle App-DB-Db2-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:

MandatoryNameDescription
XDB2PORTPort used (Default: 50000)
XDB2DATABASEName for the Db2 database system
XDB2USERNAMEDB2 username account
XDB2PASSWORDDB2 password account
DB2EXTRAOPTIONSAny extra option you may want to add to the command (eg. a --verbose flag)

Comment puis-je tester le Plugin et que signifient les options des commandes ?

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis un collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/usr/lib/centreon/plugins/centreon_database_db2.pl \
--plugin=database::db2::plugin \
--mode=database-usage \
--server='10.30.2.79' \
--database='TEST' \
--port='50000' \
--username='myusername' \
--password='mypassword' \
--verbose

La commande devrait retourner un message de sortie de la forme ci-dessous:

OK: database 'TEST' space usage total: 99.84 GB used: 698.34 MB (0.68%) free: 99.16 GB (99.32%) | 'TEST#database.space.usage.bytes'=732266496B;;;0;107204739072 'TEST#database.space.free.bytes'=106472472576B;;;0;107204739072 'TEST#database.space.usage.percentage'=0.68%;;;0;100

Cette commande contrôle le taux d'utilisation de la base de données (--mode=database-usage).

Pour chaque mode, la liste de toutes les métriques, seuils associés et options complémentaires peuvent être affichés en ajoutant le paramètre --help à la commande:

/usr/lib/centreon/plugins/centreon_database_db2.pl \
--plugin=database::db2::plugin \
--mode=database-usage \
--help

Diagnostique

Diagnostique des plugins