RRDtool
Contenu du connecteur de supervision​
Objets supervisés​
Le connecteur de supervision inclue la supervision Query.
Métriques collectées​
- Query
| Metric name | Description | Unit |
|---|---|---|
| dsname#datasource.value.minimum.count | Minimun value on timeframe | |
| dsname#datasource.value.average.count | Average value on timeframe | |
| dsname#datasource.value.maximum.count | Maximul value on timeframe |
Prérequis​
La sonde permet de requêter RRDtool avec :
- la ligne de commande avec le binaire
rrdtool(exécution en locale ou en ssh) - le module perl (exécution en locale)
rrdcached n'est pas encore supporté.
Installation​
- Online License
- Offline License
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Databases-Rrdtool
- Sur l'interface Web de Centreon, installer le connecteur de supervision RRDtool depuis la page Configuration > Gestionnaire de connecteurs de supervision
- Installer le Plugin sur tous les Collecteurs Centreon :
yum install centreon-plugin-Applications-Databases-Rrdtool
- Sur le serveur Central Centreon, installer le connecteur de supervision via le RPM:
yum install centreon-pack-applications-databases-rrdtool
- Sur l'interface Web de Centreon, installer le connecteur de supervision RRDtool depuis la page Configuration > Gestionnaire de connecteurs de supervision
Configuration d'un service​
- Local
- SSH
- sshcli backend
- plink backend
- libssh backend (par défaut)
- Créer un service et appliquer le modèle de service the App-DB-Rrdtool-Local-Query.
Une fois le modèle appliqué, certaines Macros doivent être renseignées :
| Mandatory | Name | Description |
|---|---|---|
| X | RRDFILE | Ficher rrd cible |
| X | DSNAME | Datasource cible (Défaut: 'value') |
| X | TIMEFRAME | Set timeframe in seconds (E.g '3600' to check last 60 minutes) (Défaut: 600) |
- Créer un service et appliquer le modèle de service App-DB-Rrdtool-SSH-Query.
Une fois le modèle appliqué, certaines Macros doivent être renseignées :
| Mandatory | Name | Description |
|---|---|---|
| X | RRDFILE | Ficher rrd cible |
| X | DSNAME | Datasource cible (Défaut: 'value') |
| X | TIMEFRAME | Période en seconde (cf: '3600' pour les 60 dernières minutes) (Défaut: 600) |
- Sur votre hôte, certaines Macros doivent être renseignées :
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Nom du backend: sshcli |
| X | SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur |
| SSHPASSWORD | Ne peut pas être utilisé avec le backend. Seulement avec la clé d'authentication | |
| SSHPORT | Par default: 22 | |
| SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Nom du backend: plink |
| X | SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur |
| SSHPASSWORD | Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée | |
| SSHPORT | Par default: 22 | |
| SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Nom du backend: libssh |
| SSHUSERNAME | Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur | |
| SSHPASSWORD | Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée | |
| SSHPORT | Par default: 22 | |
| SSHEXTRAOPTIONS | Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Avec ce backend, vous n'avez pas à valider manuellement le fingerprint du serveur cible.
FAQ​
Comment faire le test en ligne de commande et que signifient les principales options ?​
Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon avec l'utilisateur centreon-engine :
/usr/lib/centreon/plugins/centreon_rrdtool.pl \
--plugin=database::rrdtool::local::plugin \
--custommode=perlmod \
--mode=query \
--rrd-file='/var/lib/centreon/metrics/1490.rrd' \
--ds-name='value' \
--timeframe='3600' \
--warning-value-maximum=50 \
--critical-value-maximum=100
Exemple de sortie:
OK: datasource 'value': 3.12 (min), 4.52 (avg), 5.13 (max) | 'value#datasource.value.minimum.count'=3.12;;;; 'value#datasource.value.average.count'=4.52;;;; 'value#datasource.value.maximum.count'=5.13;0:50;0:100;;
La commande ci-dessus contrôle (--mode=query) une métrique de la base de données RRDtool /var/lib/centreon/metrics/1490.rrd (les fichiers Centreon rrd sont visibles dans l'interface : Administration > Parameters > Data).
Le plugin vérifie la datasource value (--ds-name='value'. Centreon utilise toujours value comme datasource. Il est toujours possible de vérifier le nom de la datasource avec la commande: rrdtool info /var/lib/centreon/metrics/1490.rrd) during the last hour (--timeframe='3600').
Cette commande déclenchera une alarme WARNING si la valeur maxium est supérieur à 50 (--warning-value-maximum=50)
et une alarme CRITICAL si la valeur est supérieur à 100 (--critical-value-maximum=100).
Toutes les options et leur utilisation peuvent être consultées avec le paramètre --help ajouté à la commande:
/usr/lib/centreon/plugins/centreon_rrdtool.pl \
--plugin=database::rrdtool::local::plugin \
--custommode=perlmod \
--help