Supervision d’environnement virtuel

Les environnements virtuels ont une grande importance dans les architectures informatiques de toutes les entreprises et c'est pour ça que sa supervision est essentielle. Avec Pandora FMS Enterprise vous aurez accés à Amazon EC2, VMware, Nutanix, XenServer, OpenNebula, IBM, HMC et HPVM.

Pour surveiller EC2 dans des environnements Enterprise, veuillez vous diriger vers ce lien Discovery

Cette surveillance spécifique utilise le CloudWatch API pour surveiller ses instances dans le service Amazon EC2. Il faut avoir Cloudwatch d’activé dans son instance. Vous pouvez obtenir le plugin gratuit dans la section de la bibliothèque de modules.

L’idée principale de ce plugin de serveur à distance, c’est d’obtenir une information de ses instances en utilisant le serveur de plugin de Pandora FMS. Cela signifie qu’il faudra inscrire le plugin dans le serveur et configurer les différents modules pour qu’ils récupèrent l’information de ses serveurs EC2.

Voici un exemple de l’exécution :

 /home/slerena/ec2_plugin.sh \
          -A AKIAILTVCAS26GTKLD4A \
          -S CgmQ6DxUWES05txju+alJLoM57acDudHogkLotWk \
          -i i_9d0b4af1 \
          -n AWS/EC2 \
          -m CPUUtilization

Il renverra un % de valeur numérique de la métrique CPUUtilization dans l’instance i-9d0b4af1

Pour l’installation, il faudra :

1. Avoir JAVA de disponible dans son serveur Pandora FMS avec son répertoire correspondant JAVAHOME.

2. Copier ce plugin sur un chemin d’accès et définir les autorisations sur 755 et définir le chemin d’accès de base dans la variable AWS_CLOUDWATCH_HOME qui est présente dans les premières lignes du plugin. Il faut éditer les premières lignes du plugin.

Le plugin a différents fichiers :

/ec2_plugin.sh - Plugin itself /bin/* - Composants d’Amazon CloudWatch (Surveillance) Command Line Tools, inclus dans ce paquet. Ces scripts sont distribués sous la Licence Apache.

Mettez le paquet complet dans un répertoire accessible pour le serveur. Par exemple :

/usr/share/pandora_server/plugin/ec2

Et définissez le AWS_CLOUDWATCH_HOME dans /usr/share/pandora_server/plugin/ec2

En cas de doute sur l’installation, exécutez directement cette commande :

/usr/share/pandora_server/plugin/ec2/mon-cmd --version

Vous devriez voir apparaître un message similaire à :

Amazon CloudWatch CLI version 1.0.9.5 (API 2010-08-01)

Si vous obtenez la même chaîne, alors le plugin peut être utilisé.

Si non, il faudra sûrement installer et configurer de façon adéquate les outils de ligne de commandes d’Amazon CloudWatch (surveillance).

Pré-requis :

• Assurez-vous d’avoir la version Java 1.5 ou une version plus récente d’installée sur votre système :

java -version

• Décompressez le fichier .zip de déploiement.
• Définissez les variables suivantes de l’environnement :
  • AWS_CLOUDWATCH_HOME - Le répertoire où sont copiés les fichiers de déploiement pour les tester avec :

Unix: ls ${AWS_CLOUDWATCH_HOME}/bin (should list mon-list-metrics ...)
 Windows: dir %AWS_CLOUDWATCH_HOME%\bin (should list mon-list-metrics ...)

• JAVA_HOME - Répertoire Home de l’installation de Java.
• Ajoutez à Path le suivant

 ${AWS_CLOUDWATCH_HOME}/bin

• Sur Windows :

%AWS_CLOUDWATCH_HOME%\bin à son chemin d’accès

Mettez vos références AWS d’utilisateur dans l’outil de ligne de commandes. Il existe deux façons pour fournir les références :

1. Les mots de passe AWS
2. En utilisant les certificats X.509

• Indiquez de façon explicite les références dans la ligne de commande :

1. –I ACCESS_KEY –S SECRET_KEY

• Créer un fichier identifiant. Le déploiement comprend un fichier de modèle :

${AWS_CLOUDWATCH_HOME}/credential-file-path.template.

Editez une copie de ce fichier pour ajouter votre information.Sur UNIX, limitez les autorisations pour le propriétaire du fichier d'identifiants (credential-file) :

$ chmod 600 <archive crée précédemment>.

Une fois l’archive créé, il existe plusieurs façons pour le référencer :

• Fixez la variable suivante de l’environnement :

export AWS_CREDENTIAL_FILE=<credential-file>

• Vous pouvez aussi fournir l’option suivante avec chaque commande :

1. –aws-credential-file <credential file>

Enregistrez votre certificat et mots de passe privés dans les fichiers : e.g. my-cert.pem et my-pk.pem.

Il existe deux modes pour fournir l’information certifiée à la ligne de commandes :

• Fixez les variables suivantes d’environnement :

EC2_CERT=/path/to/cert/file
EC2_PRIVATE_KEY=/path/to/key/file

• Indiquez les fichiers directement sur la ligne de commandes pour toutes les commandes :

 <command> \
      --ec2-cert-file-path=/path/to/cert/file \
      --ec2-private-key-file-path=/path/to/key/file

En fixant la variable de l’environnement SERVICE_JVM_ARGS, vous pourrez passer de façon arbitraire les propriétés JVM à la ligne de commande.

Par exemple, la ligne suivante fixe les propriétés sur Linux/UNIX :

export SERVICE_JVM_ARGS="-Dhttp.proxyHost=http://my.proxy.com -Dhttp.proxyPort=8080"

Vérifiez que votre installation fonctionne correctement. Exécutez la commande suivante :

$ mon-cmd --help

Vous devriez voir la page d’utilisation pour toutes les commandes de surveillance.

$ mon-list-metrics --headers

Vous devriez également voir une ligne d’en-tête. Si vous avez quelques métriques définies, vous devriez la voir aussi.

Avec Pandora FMS Enterprise, vous pourrez avoir accès à VMware Monitoring Plugin, un plugin qui permet d’avoir facilement l’architecture VMware sous contrôle.

Avec ce système, il est possible de surveiller les architectures comme ci-dessous :

Pandora FMS peut surveiller VCenter, des serveurs ESXi et les composants qui virtualisent : Datastores et Machines Virtuelles. Pandora FMS s’appuie sur l’API que fournit le SDK de VMware par Perl pour la collecte de données.

Suivez les étapes décrites sur Discovery pour surveiller votre infrastructure VMware grâce à Discovery.

Les pré-requis pour le fonctionnement de la tâche de surveillance de VMware sont les suivant :

• Pandora FMS v7.0NG.732 ou plus récent.
• VMware vSphere SDK pour Perl

Discovery Applications VMware utilise les métriques qui fournissent l’API des vCenter et ESXi de VMware. La disponibilité de ces métriques dépend des niveaux configurés pour la collecte de statistiques.

Ces niveaux peuvent être modifiés dans le menu vCenter Server Settings et dans l’option Statistics. Pour chaque option de temps et chaque niveau, vous obtiendrez la description des compteurs que collecte le vCenter. Le niveau minimum pour surveiller avec le plugin de Pandora FMS est le Niveau 2.

En dépendant de la configuration du vCenter, il est possible que quelques modules ne fassent pas l’objet de rapport de données sur Pandora FMS. Ceci peut être dû à :

• Il faut d'installer quelque plugins sur le vCenter.
• Qu’il soit nécessaire d’installer un agent VMware (vmware-tools) dans l’entité.
• Simplement parce que l’entité est éteinte (machine virtuelle ou ESXi).

Pour résoudre ces problèmes, il faudra consulter la documentation de VMware.

Quelques solutions, comme par exemple la surveillance de l’état de l’hardware (Hardware Status), pourraient nécessiter une configuration avancée, aussi bien pour le vCenter que les host qui supportent les ESX.

A partir de la version 732 de Pandora FMS, la surveillance de VMware s’effectue en utilisant le système Discovery Applications .

Si pour une raison particulière, vous souhaitez configurer manuellement le plugin en dehors de cette fonctionnalité, vous pouvez utiliser le mode classique décrit ci-dessous.

S’il est requis de déployer ou de mettre à jour votre version du plugin de VMware® par une autre plus récente, veuillez suivre les étapes décrites ci-après :

1. Accéder au répertoire dans lequel les fichiers du plugin VMware ont été extraits.

2. Copiez vmware-plugin.{pl,conf} au répertoire correspondant.

sudo cp vmware-plugin.pl vmware-plugin.conf /usr/share/pandora_server/util/plugin/
sudo chown pandora:apache /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf}
sudo chmod g+w /usr/share/pandora_server/util/plugin/vmware-plugin.conf

3. Vérifiez les données nécessaires pour configurer le plugin et utiliser l'API de Pandora FMS.

Dans le menu "Configuration" de la console de Pandora FMS, vous pouvez assigner un mot de passe à l’API, tout comme les autorisations d’origines.

4. Editez le fichier de configuration vmware-plugin.conf

5. Vérifiez la disponibilité de VMware® SDK for Perl

Vous pouvez lancer un script avec le contenu suivant pour valider votre installation de VMware® SDK Perl

#!/usr/bin/perl

use strict;
use warnings;

use VMware::VIRuntime;

print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

Exécutez le script :

perl check_vmware.pl

La sortie doit être similaire à la suivante :

VMware SDK Version: 6.5.0

L’url du centre de téléchargements pour le software software VMware® requis est :

https://my.vmware.com/web/vmware/details?downloadGroup=VS-PERL-SDK65&productId=614

Tout d’abord, décompressez le SDK avec la commande suivante :

# tar -xzvf VMware-vSphere-Perl-SDK-x.x.x-xxxxxx.i386.tar.gz

Maintenant, compilez et installez le SDK avec les commandes suivantes :

 # perl Makefile.PL
 # make
 # make install

Si l’installation s’est effectuée correctement et n’a présentée aucune erreur, vous pourrez vous connecter avec le vCenter® en suivant la commande suivante :

 # /usr/lib/vmware-viperl/apps/general/connect.pl \
      --server <vcenter_ip> \
      --username <vcenter_user> \
      --password <vcenter_pass>

La réponse devrait être semblable à celle-ci :

 Connection Successful
 Server Time : 2013-02-21T16:24:05.213672Z

Mise à jour SDK 6.5 vers d’autres versions

Si la mise à jour du SDK de VMware est en cours, nous recommandons de suivre les étapes suivantes :

• Installez les outils pour développeurs :

yum groupinstall "Developer Tools"

• Installez CPAN :

yum install perl-CPAN

• Installez quelques dépendances :

yum install openssl-devel perl-Class-MethodMaker
yum install epel-release

• Décompressez les archives d’installation de VMware® SDK Perl :

tar xvzf VMware-vSphere-Perl-SDK-6.5.0-4566394.x86_64.tar.gz

• Accédez au répertoire :

cd vmware-vsphere-cli-distrib

• Lancez l’installateur :

./vmware-install.pl

Pour CentOS 8 suivez aussi les étapes suivantes :

# Enable epel repo:
yum install epel-release
# Enable powertools:
yum install dnf-utils
yum config-manager --set-enabled PowerTools
# Note: For centos 8 install custom made RPMs from Artica repo:
`yum install http://firefly.artica.es/centos8/perl-Crypt-SSLeay-0.73_07-1.gf.el8.x86_64.rpm` before install SDK
# Install the vmware SDK -- Custom RPM 6.5:
`yum install http://firefly.artica.es/centos8/VMware-vSphere-Perl-SDK-6.5.0-4566394.x86_64.rpm`

Pendant l’installation :

• Acceptez la licence.
• Indiquez ne pas utiliser les modules pré-construits pour VMware® SDK.
• Acceptez l’installation automatique des modules par le biais du système automatisé par CPAN.
• Vérifiez que tous les pré-requis ont été installés correctement.
• Indiquez le répertoire où les modules de VMware SDK Perl devront être installés.

Note: Dans certains cas, le paquet perl UUID peut générer des erreurs en s’installant dans CentrOS 7. Réalisez les étapes suivantes pour ajouter le composant :

• Installez les dépendances nécessaires pour UUID-0.03

yum install libuuid-devel perl-JSON-PP

• Téléchargez le paquet du code de http://search.cpan.org/~cfaber/UUID-0.03/UUID.pm

wget http://search.cpan.org/CPAN/authors/id/C/CF/CFABER/UUID-0.03.tar.gz

• Décompressez le fichier et accéder au répertoire

tar xvzf UUID-0.03.tar.gz
cd UUID-0.03

• Générez les archives nécessaires pour la compilation du module Perl

perl Makefile.PL

• Compilez le module Perl

make

• Vous devrez recevoir une réponse semblable à

Manifying blib/man3/UUID.3pm

• Installez le nouveau module compilé

make install

Une fois les modules en attente installés, retournez exécuter le processus d’installation de VMware® SDK Perl :

./vmware-install.pl

Note : Le désinstallateur de VMware® n’efface pas complètement les bibliothèques de modules VMware précédentes.

Suivez ces étapes manuellement :

• Vider les anciennes bibliothèques

rm -rf /usr/share/perl5/vendor_perl/VMware
rm -rf /usr/share/perl5/VMware

• Ajouter les nouvelles bibliothèques VMware

cp -R /usr/lib/vmware-vcli/VMware/share/VMware /usr/share/perl5/vendor_perl/

Une fois effectué, un script peut être lancé avec le contenu suivant, pour valider l’installation de VMware SDK Perl

#!/usr/bin/perl

use strict;
use warnings;

use VMware::VIRuntime;

print "VMware SDK Version: " . $VMware::VIRuntime::VERSION . "\n";

Exécutez le script :

perl check_vmware.pl

La sortie doit être la suivante :

VMware SDK Version: 6.5.0

Si la sortie est différente, veuillez vérifier que vous avez bien suivi correctement toutes les étapes ou mettez-vous en relation avec l’assistance sur https://support.pandorafms.com/integria/ .

Les dépendances SDK pour CentOS 7 et CentOS 8 sont :

 gdbm-devel
 glibc-devel
 glibc-headers
 kernel-headers
 libdb-devel
 libuuid-devel
 make
 openssl
 perl-Business-ISBN
 perl-Business-ISBN-Data
 perl-Class-Inspector
 perl-Class-MethodMaker
 perl-Convert-BinHex
 perl-Crypt-SSLeay
 perl-Digest
 perl-Digest-MD5
 perl-Email-Date-Format
 perl-Encode-Locale
 perl-ExtUtils-Install
 perl-ExtUtils-MakeMaker
 perl-ExtUtils-Manifest
 perl-ExtUtils-ParseXS
 perl-File-Listing
 perl-HTML-Parser
 perl-HTML-Tagset
 perl-HTTP-Cookies
 perl-HTTP-Daemon
 perl-HTTP-Date
 perl-HTTP-Message
 perl-HTTP-Negotiate
 perl-IO-HTML
 perl-IO-SessionData
 perl-IO-Socket-IP
 perl-IO-Socket-SSL
 perl-JSON-PP
 perl-LWP-MediaTypes
 perl-LWP-Protocol-https
 perl-MIME-Lite
 perl-MIME-Types
 perl-MIME-tools
 perl-MailTools
 perl-Mozilla-CA
 perl-Net-HTTP
 perl-Net-LibIDN
 perl-Net-SMTP-SSL
 perl-Net-SSLeay
 perl-SOAP-Lite
 perl-Test-Harness
 perl-TimeDate
 perl-URI
 perl-WWW-RobotRules
 perl-XML-LibXML
 perl-XML-NamespaceSupport
 perl-XML-Parser
 perl-XML-SAX
 perl-XML-SAX-Base
 perl-devel
 perl-libwww-perl
 pyparsing
 systemtap-sdt-devel
 glibc
 glibc-common
 libblkid
 libmount
 libsmartcols
 libuuid
 util-linux

yum install `http://firefly.artica.es/centos8/perl-Crypt-SSLeay-0.73_07-1.gf.el8.x86_64.rpm`

Vous pouvez intaller les dépendances extras pour plugin avec la commande suivnte :

`yum install perl-Archive-Zip perl-JSON`

Vous pouvez installer les dépendances de chiffré de mot de passe avec la commande suivante :

`yum install openssl-devel perl-Crypt-CBC perl-Digest-SHA`

Vous pouvez télécharger les RMP personnalisés de perl-Crypt-OpenSSL-AES depuis le répertoire de Ártica :

• Pour CentOS 7.

`yum install https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Crypt-OpenSSL-AES-0.02-1.el7.x86_64.rpm`

• Pour CentOS 8.

`yum install https://sourceforge.net/projects/pandora/files/Tools%20and%20dependencies%20%28All%20versions%29/RPM%20CentOS%2C%20RHEL/perl-Crypt-OpenSSL-AES-0.02-1.el8.x86_64.rpm`

La version de PERL, qui est distribuée avec le vSphere SDK, ne fonctionne pas avec les bibliothèques de VMware pour PERL. Pour résoudre ce problème, suivez les étapes suivantes :

• Installez le VMware vSphere SDK.
• Installez Strawberry PERL version 5.12 de http://strawberryperl.com/releases.html.
• Copiez le répertoire :

 //C:\AProgramFiles%\VMware\VMware vSphere CLI\Perl\lib\VMware//

vers

 //C:\strawberry\perl\lib//.

• Désinstallez le VMware® vSphere SDK.

Vous pouvez configurer le plugin de VMware® manuellement ou en utilisant l’extension pour console disponible, joint avec les archives téléchargeables du plugin de VMware®.

Vous pouvez éditer manuellement le fichier de configuration. Sachez que les lignes qui commencent par '#' seront interprétées comme des commentaires.

Par défaut l'extension de VMware® découvre toutes les entités et ajoute les vérifications par défaut. Par le biais du fichier de configuration, vous pourrez configurer la supervision et choisir quelles variables vous souhaitez superviser.

Le fichier de configuration contient toute les informations nécessaires pour la supervision, groupée dans les sections suivantes :

• Configuration.
• Rename.
• Reject.
• Datacenter.
• Datastore.
• ESX.
• VM.

La configuration générale est définie par le token Configuration et contient les paramètres suivantes :

• server

FQDN ou IP du serveur VMware® à surveiller

• user

Utilisateur avec des droits de lecture sur vCenter®

• pass

Mot de passe de l’utilisateur dans vCenter®

• datacenter

Nom du datacenter (par défaut : ha-datacenter)

• temporal

Répertoire de travail temporel, par défaut : /tmp

• logfile

Archive de log, par défaut /tmp/vmware_plugin.log

• entities_list

Archive d’entités à surveiller, par défaut /tmp/vmware_entitites_list.txt

• transfer_mode

Mode de transfert de XML à Pandora qui peut être tentacle ou local, par défaut : local :

1. tentacle : Il envoi les fichiers XML au serveur Pandora FMS en utilisant le protocole Tentacle.
2. local : Il copie les fichiers vers un dossier local ; l'agent doit être exécuté dans la même machine où se trouve le dossier local.

• tentacle_client

Afin d'utiliser Tentacle en tant qu'outil de tranfert, il doit être configuré en tant que client : tentacle_client.

• tentacle_ip

Adresse du serveur de Pandora FMS, par défaut : 127.0.0.1

• use_encrypted_password

Utiliser des mots de passe chiffrés (1) ou pas (0)

• tentacle_port

Port pour communications Tentacle, par défaut : 41121

• tentacle_opts

Options extra pour Tentacle à distance

• local_folder

Dans transfert local, dossier de destination pour les XML de rapport /var/spool/pandora/data_in

• pandora_url

Adresse web de la console de Pandora FMS, par défaut

http://127.0.0.1/pandora_console

• api_pass

Mot de passe de la API de la console de Pandora FMS

• api_user

Utilisateur avec accès à l’API de Pandora FMS

• api_user_pass

Mot de passe de l’utilisateur avec accès à l’API

• retry_send

Réessayer (1) o non (0) l’envoi de XML en cas d’erreur (semblable à buffer_xml)

• event_mode

Récupérer l’information (1) des évènements de VMware o non (0)

• event_pointer_file

Archive des indices auxiliaires pour des évènements VMware, par défaut /tmp/vmware_events_pointer.txt

• virtual_network_monitoring

Il active (1) ou désactive (0) la supervision de commutateurs virtuels (standard)

Encrypt passwords

Utiliser des mots de passe cryptés dans le fichier de configuration

• verbosity

Niveau de debug (recommandé : 1)

• threads

Nombre maximum de hilos à utiliser (par défaut 1, recommandé : 4)

• interval

Intervalle en secondes des agents et modules qui se généreront (ajuster conformément à la fréquence d’exécution du plugin)

• recon_interval

Intervalle en secondes après que le fichier temporaire de caché s’auto-élimine pour re-scanner l’infrastructure VMware® de nouveau.

• group

Servers Groupe de destination des agents générés par le plugin, par exemple Servers ou Workstations.

• virtual_network_monitoring

Il active (1) ou désactive (0) la supervision de commutateurs virtuels (standard)

• use_ds_alias_as_name

Il active (1) ou désactive (0) l'utilisation d'un alias en tant que nom d'agent sur des agent de stockage de données-.

Un exemple dans cette section dans le fichier de configuration pourrait être le suivant :

 Configuration
 server 192.168.70.249
 user Administrator
 pass S1stemas
 datacenter artica
 temporal /tmp
 logfile /tmp/vmware_plugin.log
 entities_list /tmp/vmware_entities_list.txt
 transfer_mode tentacle
 tentacle_ip 192.168.70.81
 tentacle_port 41121
 tentacle_opts
 local_folder /var/spool/pandora/data_in
 pandora_url http://192.168.70.81/pandora_console
 api_pass 1234
 api_user admin
 api_user_pass pandora
 event_mode 0
 event_pointer_file /tmp/vmware_events_pointer.txt

En raison de la taille des infrastructures VMware® qui characterise les clients Enterprise, un scan général de toutes les entités disponibles dans chaque exécution pourrait déclencher des problèmes de performance.

Afin d'éviter cette situation, le plugin de supervision de VMware® dispose du fichier d'entités ( entities_list ) où la liste d'entités est stockée scannés dans la première exécution.

Tandis que le fichier existe, la supervision sera limitée aux entités indiquées dedans.

Si vous avez besoin d'un scan périodique de votre infrastructure VMware®, vous pouvez supprimer ce fichier te temps en temps (par exemple, chaque heure) en utilisant le cron du système.

Le renommage d'entités se fait en utilisant le token RENAME et permet de changer le nom des entités découvertes par le plugin. En utilisant cette fonctionnalité, les agents créés dans Pandora apparaîtront avec le nouveau nom attribué. La structure de cette section est la suivante :

<nom actuel> TO <nouevau nom>

Un exemple de configuration de cette section pourrait être le suivant :

 #Rename entities
 Rename
 Debian 11 TO Virtual Machine 1
 RedHat 12 TO Web server
 ESX Workstation TO Host Work Sales

Le plugin permet de fair un rejet des entités par type ou de manière individuelle, on vous explique les deux options ci-dessous.

Le rejet des types d'entités se fait en utilisant le token REJECT. Dans cette section vous pouvez écarter les entités selon leur type ; par exemple toutes les machines virtuelles ou toutes les hôtes ESX. Les valeurs possibles que cette section peut prende sont les suivants :

all_datastore

all_datacenter

all_esx

all_vm

all_ipaddresses

Une configuration de cette section qui écarte toutes les entités serait la suivante :

 #Dismissed entities
 Reject
 all_datastore
 all_datacenter
 all_esx
 all_vm

Afin d'écarter les entités de manière individuelle, il sera nécessaire de les effacer du fichier d'entités créé par le plugin. Le plugin crée ce fichier dans la localisation indiquée dans le paramètre entities_list (par défaut /tmp/vmware_entities_list.txt). Le plugin remplit le contenu de ce fichier avec la première exécution, ou tandis qu'elle n'existe pas, en créant une liste avec toutes les entités découvertes.

Un exemple de fichier pourrait être le suivant :

 Datacenter
 artica
 Datastore
 datastore_1
 datastore2
 ESX
 192.168.70.252
 VM
 Pandora FMS 4.0.3
 Debian2
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 NSM
 Pandora
 vcenter
 suse11.2

Le fichier de configuration est divisé entre quelques tokens : Datacenter, Datastore, ESX et VM, où les différentes entités sont listées. Une fois le fichier de configuration créé, le plugin lira de ce fichier les entités à superviser. Pour écarter une entité vous avez seulement à l'effacer depuis ce fichier. Si, par exemple, vous n'avez pas besoin de superviser les entités : Debian2, datastore2, NSM, suse11.2 et 192.168.70.252, le fichier de configuration devrait donc être pareille à ceci :

 Datacenter
 artica
 Datastore
 datastore_1
 ESX
 VM
 Pandora FMS 4.0.3
 Debian3
 Debian4
 Redhat
 debian5
 Debian6
 Debian8
 Debian7
 Debian11
 Debian10
 Debian9
 Pandora
 vcenter

Cette fonctionnalité permet de faire une distribution de la charge de supervision limitant le nombre d'entités supervisées dans chaque exécution du plugin. Nous vous explicons ci-dessous plusieures techniques de distribution de charge.

La section Reject, du plugin de supervision d'environnements VMware® contient en outre l'option suivante :

all_ipaddresses

Si cette instruction est présente, l'addresse IP dans le XML ne sera pas mise à jour. Ça signifie que si vous activez cette option, le plugin/tâche de Discovery de VMware ne mettra à jour le champ ip address des agents. Cette instruction est aussi valide pour les tâches de reconnaissance du Discovery sobre VMware®.

Les sections suivantes de l’archive configurent les modules créés par chaque type d’entité. Les sections utilisent les tokens Datacenter, Datastore, ESX, VM. Dans ces dernières, vous pourrez activer/désactiver les modules à surveiller. Dans l’exemple suivant, nous avons réalisé une configuration en sélectionnant les modules que nous souhaitons créer pour les ESX et les machines virtuelles :

...
 #ESX Modules
 ESX
 cpuUsagePercent disabled
 diskRead enabled
 diskWrite enabled

 #VM Modules
 VM
 diskReadLatency disabled
 diskWriteLatency disabled
 diskRate enabled
 ...

Chaque ligne de configuration correspond à un module. Dans l’exemple précédent, les modules seront créés avec les valeurs par défaut, mais il est possible de configurer le nom, la description et les limites pour les états d’Avertissement et Critique du module. Voici un exemple de cette configuration :

...
#VM Modules
VM
diskReadLatency disabled
diskWriteLatency disabled
diskRate name = Tasa Disco; desc = Tasa Lec/Esc disco; limits_warn = 5 10; limits_crit = 0 4
...

Les options disponibles pour la configuration des modules sont les suivantes :

• <module> disabled : le module NON se créera
• <module> enabled : le module OUI se créera (avec les valeurs par défaut).
• <module> name = <nom>; desc = <description>; limits_warn <lim_warn>; limits_crit <lim_crit» le module se créera avec le nom et la description fournis. De plus, les seuils maximaux et minimaux se définiront pour les états Avertissement et Critique.

Il est très important de prendre en compte la structure des lignes de l’archive de configuration et surtout de voir le caractère ; qui est collé au nom et à la description du module. Ces deux lignes NE SONT PAS ÉQUIVALENTES (voir les espaces avant le caractère ; ):

diskRate name = Tasa Disco; desc = Tasa Lec/Esc disco; limits_warn = 5 10; limits_crit = 0 4
diskRate name = Tasa Disco    ; desc = Tasa Lec/Esc disco    ; limits_warn = 5 10; limits_crit    = 0    4

Les modules sont référencés par leur court nom, une abréviation équivalente et plus simple à écrire dans la ligne de commandes. La table de correspondance des noms abrégés et développés se trouve dans la section suivante.

Analysons la configuration de l’exemple précédent. Nous avons configuré le module Disk Rate qui se créera avec les valeurs suivantes :

 * Nom : Tasa Disco
 * Description: Tasa Lec/Esc disco
 * Min Warning: 5
 * Max Warning: 10
 * Min Critical: 0
 * Max Critical: 4

Certains modules se gèrent de façon dynamique, par exemple ceux relatifs aux disques ou interfaces réseau. Pour ces métriques, le plugin crée un module pour chaque élément découvert. Ces modules ont généralement des noms spéciaux sur Pandora FMS, par exemple :

Disk Free [0]
Disk Free [1]
Disk Free [2]
...

Dans ces cas, comme le nom a une partie dynamique, l’usage de la macro % est possible, qui sera substituée par la partie variable du nom du module. Un exemple de configuration des modules serait le suivant :

diskFree name = Disk (%s) free space; desc = Free space for disk; limits_warn = 0 0; limits_crit = 0 0

Dans ce cas, le nom du module par défaut est :

Disk Free [0]

Puis s’appellera :

Disk (0) free space

A partir de la version 5.0, il est possible de configurer des chaînes de caractères pour les limites des états Avertissement et Critique des modules. La configuration serait comme la suivante :

powerState name = état en fonctionnement; desc = état en fonctionnement VM; limits_warn = .*suspended.*; limits_crit = .*poweredOff.*

Il est possible de configurer des expressions régulières pour jouir d’une flexibilité plus grande pour établir les limites.

Suivez les étapes décrites sur : Discovery pour configurer la surveillance de votre infrastructure VMware grâce à Discovery.

Pour vérifier le fonctionnement de votre configuration, vous pouvez exécuter :

perl /usr/share/pandora_server/util/plugin/vmware-plugin.pl /usr/share/pandora_server/util/plugin/vmware-plugin.conf

Note :

• Sur VMware SDK 6.5.0. Si vous recevez la sortie suivante pendant l’exécution du plugin :

Server version unavailable at 'https://your_vmwre_fqdn:443/sdk/vimService.wsdl' at /usr/local/lib64/perl5/VMware/VICommon.pm line 734.

La solution est apporté en ajustant les versions des bibliothèques LWP de Perl :

cpan install GAAS/libwww-perl-5.837.tar.gz

Nous recommandons vivement d’utiliser Discovery Applications VMware pour surveiller votre infrastructure.

Ainsi, vous pouvez choisir différentes façons d’automatiser l’exécution du plugin de surveillance VMware :

Utiliser l’agent de Pandora FMS

Copier vmware-plugin.{pl,conf} de sorte à ce qu’il soit accessible par l’agent de Pandora FMS :

 sudo cp \
 /usr/share/pandora_server/util/plugin/vmware-plugin.{pl,conf} \
 /etc/pandora/plugins/

Pour créer un fichier de configuration

vmware-plugin-events.conf

copiez vmware-plugin.conf et en modifiez manuellement event_mode à 1.

A présent, il faut ajouter un nouveau module de type plugin à l’archive de configuration de l’agent, avec la ligne suivante :

module_plugin perl \
 /etc/pandora/plugins/vmware-plugin.pl \
 /etc/pandora/plugins/vmware-plugin.conf

Si vous souhaitez, en plus, la copie des évènements, vous devez créer un autre module plugin avec une archive de configuration différente qui permette la copie d’évènement. La formulation serait la suivante :

module_plugin perl \
 /etc/pandora/plugins/vmware-plugin.pl \
/etc/pandora/plugins/vmware-plugin-events.conf

Dans des systèmes Windows, il faudra indiquer l’interprète utilisé. La commande serait :

module_plugin perl "C:\Program Files\pandora_agent\util\vmware-plugin.pl" "C:\Program Files\pandora_agent\util\vmware-plugin.conf"

Dans les sections suivantes, les paramètres de l’archive de configuration du plugin sont expliqués en détails dans les sections suivantes.

Vous pouvez programmer l’exécution du plugin depuis le propre cron du système. Sachez que la valeur d’intervalle des éléments générés (interval dans la configuration) et la fréquence d’exécution doivent être cohérents :

# Input to add to crontab, set a range of 600 to use this setting/10 * * * * root perl /usr/share/pandora_server/util/plugin/vmware-plugin.pl /usr/share/pandora_server/util/plugin/vmware-plugin.conf

L'exemple précédente montre la ligne à ajouter à crontab. Configurez un intervalle de 600 pour utiliser cette configuration.

Pour voir le résultat de l’exécution du plugin, il suffit d’accéder au sous-menu Agent Detail, dans le menu Views.

Dans cette vue, les agents créés par le plugin apparaîtront avec les autres agents de Pandora FMS.

Si nous appuyons sur le nom d’un agent, nous verrons la vue de l’agent de Pandora FMS, où les modules surveillés apparaîtront par le plugin VMware.

Par défaut, le plugin déploie une surveillance basique pour chacun des éléments VMware. La configuration par défaut pour les différentes entités est la suivante :

• Ping
• Check 443 port

• Capacity
• Free Space
• Disk Overallocation
• Free Space Bytes

• CPU Usage
• Memory Usage
• Data received
• Data transmitted
• Disk Read Latency
• Disk Write Latency
• Host Alive
• Disk Rate
• Net Usage

• CPU Usage
• Memory Usage
• Tools Running Status
• Host Alive
• Disk Free
• Disk Read Latency
• Disk Write Latency
• Data received
• Data transmitted
• Net Usage

La section suivante détaille tous les modules disponibles et l’information que rapporte chaque module.

Quelques modules pourraient ne pas être disponibles, tout dépend de la version de VMware et de la configuration de l’environnement. Dans les tables suivantes, les différents modules disponibles ainsi que leurs caractéristiques de disponibilité y sont décrits.

Ces modules fournissent l’information depuis le point de vue de l’architecture VMware. Si vous désirez surveiller d’autres paramètres relatifs à la machine virtuelle, il faudrait prendre d’autres options en considération, comme la Surveillance avec agents logiciels ou la Surveillance virtuelle.

Cette fonctionnalité réalise une copie des évènements présents dans le vCenter de VMware à la liste des évènements de Pandora FMS.

Ces évènements sont parvenus à faire partie du flux d’évènements normaux de Pandora FMS et restent associés de façon automatique à l’agent qui représente le vCenter auquel ils proviennent (si l’agent existe au moment de la création de l’évènement).

Dans le processus de dump des évènements, l’information et la sévérité que VMware indique lors de la création de l’évènement sont respectées, de telle sorte que les évènements avec un niveau de sévérité critique, avertissant, ou informatif conserveront ces niveaux dans Pandora FMS. L’image suivante montre un exemple d’information détaillée d’un évènement de dump de VMware à Pandora FMS.

Avec tous les évènements présents sur Pandora FMS, vous pourrez réaliser toutes les actions disponibles pour la gestion des évènements, comme par exemple la création d’alertes, la configuration de filtres, l’ouverture d’incidences, etc.

Accompagné du plugin VMware, deux extensions sont distribuées, VMware Manager® et VMware View®. VMware View permet de visualiser tous les composants de l’architecture VMware® de façon pratique. De plus, avec VMware Manager®, vous pourrez gérer des machines virtuelles en arrêtant, en démarrant, en réinitialisant ou en suspendant son activité depuis la console de Pandora FMS.

Pour commencer à utiliser le viseur des architectures VMware®, allez vers Monitoring > VMware view.

Si vous n'avez pas aucun appareil à superviser ou vous n'avez pas configuré l'API des vCenter® et ESXi VMware® vous obtiendrez quelque chose de pareille à l'image suivante :

Si le plugin se trouve en état opératif, vous recevrez le message suivant (cliquez sur Show) :

L’extension VMware vous montrera une carte semblable à celle ci-dessous avec toute l’architecture VMware®.

La carte contient les éléments de l’architecture VMware (machines virtuelles, ESX, Datastores et Datacenters) avec différents icônes qui les identifient, comme l’état des agents de Pandora FMS qui représentent chaque élément. De plus, la relation qui existe est montrée entre machines virtuelles, ESX et Datacenter. De cette façon, l’état de l’architecture VMware® peut se voir en un coup d’oeil.

Cette extension a des options qui aident à améliorer la visualisation de l’architecture en cachant des éléments, en augmentant la taille des lettres et en permettant de faire un zoom pour pouvoir voir les éléments de plus près.

En utilisant les options précédentes, nous ne montrerons que ceux de Datacenter et de ESX.

Pour des versions de Pandora FMS 5.0 ou plus, VMware View apporte deux vues supplémentaires en plus de la vue de carte topologique de l’architecture virtuelle. Les nouveaux tabs permettent d’interchanger entre les différentes vues de la VMware View.

La première vue est un dashboard général, sur lequel vous pourrez jeter un coup d’oeil sur l’état général de l’architecture virtuelle en nombres, c’est-à-dire, combien de machines virtuelles, host ESXi ou datastores ont des problèmes. De plus, vous pourrez voir des paramètres de performance généraux grâce aux graphiques qui montrent les 5 machines virtuelles qui consomment le plus de mémoire, de CPU, de disque et de réseau sur l’ensemble de l’architecture virtuelle.

La seconde vue permet de voir les paramètres de performance de chaque host ESX. Dans cette vue, vous pourrez choisir un host ESX qui sera chargé du tableau de bord sur lequel se présentera l’état de l’host et des machines virtuelles, comme des métriques de performance relatives à l’utilisation de CPU, de mémoire, de disque et de réseau de l’host ESXi. De plus, cette vue permet aussi de voir des graphiques montrant les machines virtuelles qui consomment le plus de ressources (CPU, mémoire, disque et réseau) de l’host sélectionné.

L’extension de VMWare est incluse avec Pandora FMS Console Enterprise. Elle dispose d’un panneau de configuration sur lequel il est possible d’y établir des dashboards et des cartes :

• Vous pourrez ajuster les seuils de vue (minimum et maximum) des graphiques des dashboards.
• Vous pourrez ajuster la configuration de la vue de la carte par défaut.
• Il contient un lien au système de gestion des configurations.

Accessible dans l’onglet des options du VMWare View :

Pour utiliser l’extension VMware® Manager, il faut aller sur la vue d’opération d’un agent qui correspond à une machine virtuelle dans l’architecture VMware. Dans cette vue, vous pourrez voir un icône avec le symbole de VMware qui correspond à l’extension.

L’extension VMware Manager permet de gérer des machines virtuelles depuis la console de Pandora FMS. L’extension montre l’état actuel de la machine virtuelle avec un code de couleurs :

• Vert = allumée (machine virtuelle en exécution).
• Orange = en veille (machine virtuelle dont l'exécution est en pause)
• Gris = arrêtée (la machine virtuelle n'est pas en exécution).

De plus, les états disponibles sont montrés dans un menu et permettent de changer l’état de la machine virtuelle en le sélectionnant, en cliquant sur Change Status.

En sélectionnant l’état Stop et cliquant Change status :

Cela provoquerait l’arrêt de la machine et la vue de l’extension VMware Manage changerait en montrant que la machine est désormais arrêtée, comme on peut le voir sur l’image suivante :

Dans cette section, vous pouvez configurer de nouveaux modules relatifs à Performance Counters pour les machines virtuelles et les ESX. Pour configurer un nouveau module de rendement, il faudra utiliser la structure suivante :

custom_performance type = mem; metric = swapinRate; module_type = generic_data; name = Swap In Rate; desc = Swap In Rate for host; limits_warn = 0 0; limits_crit = 0 0

Les paramètres à configurer sont :

• type : type de métrique à surveiller. Les types de métrique sont :
  • cpu : CPU
  • mem ': Memory
  • disk : Disk
  • net : Network
  • sys : System
• metric : métrique à surveiller (Plus loin dans le document, il vous sera indiqué comment voir les métriques disponibles).
• module_type : type de module de Pandora FMS (par exemple : generic_data).
• name : nom du module.
• desc: description du module.
• limits_warn: limites par l’état d’Avertissement.
• limits_crit: limites pour l’état Critique.

Vous pourrez consulter les métriques disponibles pour chaque type, dans l’aparté Performance de chaque entité. Cette vue se trouve dans le vCenter et montre les métriques de rendement qui peuvent être surveillées avec le plugin VMware. Par exemple, l’image suivante montre la vue Performance pour un host ESX.

Pour voir la liste liste complète de toutes les métriques selon leur type, vous devrez cliquer sur le bouton “Advanced” puis sur le bouton “Char option”. Vous verrez une liste avec tous les types de métriques et celles respectives à chaque types seront dans une fenêtre comme le montre l’image suivante.

Pour chaque type de métrique, une série de compteurs apparaîtra, représentant les variables que nous pourrons surveiller avec Pandora FMS. Pour surveiller une variable, il faut son “Internal Name”. De plus, nous devrons nous assurer que le niveau de statistiques, configuré dans le vCenter, permette de montrer la variable que nous recherchons, en le comparant avec le champs “Collection Level” de la métrique.

Si, par exemple, nous souhaitons voir l’utilisation de CPU d’un host ESX, nous chercherons les variables type “cpu” pour un ESX et parmi celles disponibles, nous choisirons “utilization”. La ligne que nous devrons ajouter à l’archive de configuration, dans ce cas-ci dans la section ESX, sera la suivante :

custom_performance type = cpu; metric = utilization; module_type = generic_data; name = CPU Utilization; desc = CPU Utilization for ESX; limits_warn = 0 0; limits_crit = 0 0

Chaque module plugin configuré dans l’agent surveille un datacenter, c’est pourquoi si on désire surveiller plusieurs datacenter avec un même agent software de Pandora FMS, il faudra prendre en compte les considérations suivantes :

• Il faut ajouter un module_plugin pour chaque datacenter à surveiller, par exemple :

 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
 module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf

• Dans chaque archive de configuration, il faudrait changer les paramètres : logfile, entities_list, event_pointer_file. Les archives de configuration resteraient comme les suivantes :

vmware-plugin-datacenter1.conf

 ...
 logfile /tmp/vmware_plugin_datacenter1.log
 entities_list /tmp/vmware_entities_list_datacenter1.txt
 event_pointer_file /tmp/vmware_events_pointer_datacenter1.txt
 ...

vmware-plugin-datacenter2.conf

 ...
 logfile /tmp/vmware_plugin_datacenter2.log
 entities_list /tmp/vmware_entities_list_datacenter2.txt
 event_pointer_file /tmp/vmware_events_pointer_datacenter2.txt
 ...

• Si, en plus, vous souhaitez réaliser la copie des évènements, vous devrez avoir deux modules plugin en plus, avec les archives respectives de configuration et en activant le flag event_mode. La configuration des module_plugin serait comme la suivante :

module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1.conf
module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter1-events.conf
module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2.conf
module_plugin /etc/pandora/plugins/vmware-plugin.pl /etc/pandora/plugins/vmware-plugin-datacenter2-events.conf

Les options de l’archive de configuration du plugin permettent de distribuer facilement la charge de surveillance entre plusieurs serveurs de Pandora FMS. Par exemple, supposons que nous ayons la structure suivante dans notre environnement de virtualisation :

 DC
 |
 |- Datastore_1
 |- DataStore_2
 |
 |- ESX_1
       |- mv1.1
       |- mv1.2
       |- mv1.3

 |- ESX_2
       |- mv2.1
       |- mv2.2
       |- mv2.3

Dans notre environnement, nous disposons de deux serveurs de Pandora FMS pour réaliser la surveillance. Une manière simple de diviser la charge serait de surveiller le Datacenter, les Datastores et les ESX dans le premier serveur et toutes les machines virtuelles dans le second. Les archives de configuration du plugin seraient les suivantes :

Serveur 1 :

 Reject
 all_vm

Serveur 2 :

 Reject
 all_datacenter
 all_datastore
 all_esx

Le serveur 1 surveille tout sauf les machines virtuelles et le Serveur 2 surveille les machines virtuelles.

Une autre façon de distribuer la charge serait de diviser la surveillance par ESX : le premier serveur de Pandora FMS surveillerait tout ce qui est relatif au premier serveur ESX et le second, tout ce qui appartiendrait au second serveur ESX. Grâce à cela, nous diviserons l’archive entities_list.txt en deux archives et nous configurerons deux exécutions du plugin dans différents agents. Les archives entities_list.txt seraient telles que :

Serveur 1 :

 Datacenter
 DC
 Datastore
 Datastore_1
 ESX
 ESX_1
 VM
 mv1.1
 mv1.2
 mv1.3

Le Serveur 1 ignore tout ce qui est lié au second groupe d’entités VMware, c’est pourquoi il se charge de surveiller que la moitié de l’environnement.

Serveur 2 :

 Datastore
 DataStore_2
 ESX
 ESX_2
 VM
 mv2.1
 mv2.2
 mv2.3

Le Serveur 2 ignore tout ce qui est lié au premier groupe d’entités VMware en plus du Datacenter, puisque ce dernier est surveillé par le Serveur 1.

La configuration des entités exclues est très flexible et permet de diviser la charge qui attribue quelques entitées à chaque agent de Pandora FMS.

Archive avec tous les modules désactivés

#These lines are comments

#Datacenter Modules
Datacenter
ping disabled
check443 disabled

#Datastore Modules
Datastore
capacity disabled
freeSpace disabled
overallocation disabled
freeSpaceBytes disabled

#ESX Modules
ESX
bootTime disabled
cpuInfo disabled
memorySize disabled
overallCpuUsage disabled
overallMemoryUsage disabled
powerState disabled
sslThumbprint disabled
uptime disabled
vnicInfo disabled
hostAlive disabled
connectionState disabled
diskRead disabled
diskWrite disabled
diskReadLatency disabled
diskWriteLatency disabled
netReceived disabled
netTransmitted disabled
netPkgRx disabled
netPkgTx disabled
cpuUsagePercent disabled
memoryUsagePercent disabled
netUsage disabled
diskRate disabled
maxDiskLatency disabled
haStatus disabled

#VM Modules
VM
bootTime disabled
connectionState disabled
consumedOverheadMemory disabled
cpuAllocation disabled
diskFree disabled
guestState disabled
host disabled
hostAlive disabled
hostMemoryUsage disabled
hostName disabled
ipAddress disabled
macAddress disabled
maxCpuUsage disabled
maxMemoryUsage disabled
memoryAllocation disabled
memoryOverhead disabled
overallCpuDemand disabled
overallCpuUsage disabled
powerState disabled
privateMemory disabled
sharedMemory disabled
toolsRunningStatus disabled
triggeredAlarmState disabled
virtualImagePath disabled
uptimeSeconds disabled
diskRead disabled
diskWrite disabled
diskReadLatency disabled
diskWriteLatency disabled
netReceived disabled
netTransmitted disabled
netPkgRx disabled
netPkgTx  disabled
cpuUsagePercent disabled
memoryUsagePercent disabled
netUsage disabled
diskRate disabled
maxDiskLatency disabled
heartbeat disabled
cpuReady disabled
snapshotCounter disabled

Red Hat® Enterprise Virtualization (RHEV) est unes des technologies les plus utilisés par les entreprises qui ont comme base le système d'exploitation Red Hat dans son Data Center. Pandora FMS Enterprise offre la possibilité de superviser les architectures virtuelles basées sur RHEV par le biais du plugin RHEV Monitoring Plugin, qui permet contrôler de manière simple tous les aspects liés à l'architecture virtuelle RHEV.

Avec le plugin il est possible de superviser l'architecture complète d'un système RHEV : Data Centers, Host Clusters, Storage Domains, Networks, Hosts et Virtual Machines, en offrant une vision globale de l'état de l'environnement virtuel.

Pour ça, Pandora FMS utilise l'API officielle fournit par le système de virtualisation RHEV.

La supervision d'environnements virtuels RHEV se base sur deux composants :

1. Un plugin d'Agent qui fait les tâches de auto-découverte et collecte de données. Le plugin d'Agent est chargé d'envoyer les informations vers Pandora FMS.
2. Un script de reconnaissance qui met à jour de différents valeurs pour les entités découvertes. Ce script est nécessaire pour le correcte fonctionnement des extensions du plugin.
3. Extension RHEV Viewer et RHEV Manager. Ils sont des extensions qui ajoutent une valeur supplémentaire permettant de visualiser l'infrastructure supervisée et opérer en allumant/éteindant les machines virtuelles, tout ça depuis la console web de Pandora FMS.

Le plugin RHEV Monitoring Plugin extrait de l'información grâce à l'API web qui fournit du service à l'environnement de virtualisation RHEV.

Si vous avez seulement besoin de l'information de supervision, vous avez seulement à configurer le plugin de l'agent qui fera cette tâche.

Le plugin d'agent découvre des appareils et compose les XML avec les modules pour chacun d'entre eux. La configuration du plugin permet de choisir quels éléments seront superviser et la configuration de ses modules. Les modules créés par le plugin sont configurables, et il est possible de changer le nom et la description et ajouter des valeurs maximales et minimales pour les états Warning et Critical du module.

Une fois créés les XML, le plugin d'agent envoi les fichiers, soit grâce à Tentacle ou en les copint vers un répértoire local, selon la méthode de transfert choisie.

Si en outre vous allez utiliser les extensions RHEV Viewer et RHEV Manager vous aurez besoin d'utiliser le script de reconnaissance.

Le script de reconnaissance est chargé de mettre à jour quelques variables de chacun des agent détectés dans Pandora FMS selon les valeurs configurés dans RHEV. Ces variables sont nécessaires pour visualiser les entités correctement dans l'extension RHEV Viewer et gérer correctement les machines virtuelles avec l'extension RHEV Manager.

Le plugin d'agent exige le logiciel suivant :

• curl.
• perl-XML-Simple.
• Agent Logiciel de Pandora FMS.
• tentacle_client (si vous voulez utiliser tentacle pour envoyer les fichiers, tentacle_client est installé avec l'agent logiciel de Pandora FMS).

Vous pouvez installer les dépendances dans les systèmes fondés sur Red Hat® avec la commande :

yum install perl-XML-Simple curl

Dans les systèmes fondés sur SUSE, vous pouvez installer les dépendances avec la commande :

zypper install perl-XML-Simple curl

Dans les systèmes fondés sur Debiand/Ubuntu, vous pouvez installer les dépendances avec la commande :

apt-get install libxml-simple-perl curl

L'installation de l'agent logiciel Pandora FMS est expliqué dans la section Installation de Pandora FMS, là-bas vous troverez tout ce dont vous avez besoin afin d'installer ledit agent dans la plate-forme.

Avant d'utiliser le plugin, il sera nécessaire de télécharger le certificat qui permet la connexion par moyen de HTTPS à l'API de RHEV. Pour ça, exécutez la commande suivante :

curl -o rhevm.cer http://[RHEVM-HOST]:8080/ca.crt

Où [rhevm-host] est le nom du serveur auqle l'API de RHEV fournit du service. Un exemple pourrait être :

curl -o rhevm.cer http://rhevm.server:8080/ca.crt

Aprés le certificat est téléchargé, vous pouvez vérifier que la connexion à l'API se fait de manière correcte par le biais de l'utilisation des connecteurs de ligne >

curl -X GET \
             -H "Accept: application/xml" \
             -u [USER:PASS] \
             --cacert [CERT] https://[RHEVM-HOST]:8443/api

Avec les valeurs suivantes :

• USER : user @domain pour se connecter à l'API.
• PASS : mot de passe de l'utilisateur avec lequel vous vous connecterez à l'API.
• CERT : chemin au certificat téléchargé dand l'étape précédente.
• RHEVM-HOST : addresse de l'hôte qui fournit du service à l'API.

Un exemple avec des données spécifiques de la commande serait comme suit :

curl -X GET \
            -H "Accept: application/xml" \
            -u [user@testdomain:12345] \
            --cacert /home/user/ca.crt https://rhevm.server:8443/api

Si l'exécution de la commande est positive, il retournera une sortie en format XML avec l'information général sur l'API de RHEV.

Dans l'environnement de virtualisation RHEV il se peut que quelques entités aient le même nom. Cela suppose un problème, puisque dans Pandora FMS ces entités se convertiront en des agents qui ne permettent pas la duplication des noms. En outre il généra aussi des problèmes lors de la correction avec des patchs le résultat retourné par l'API en format XML, vous montrant un erreur pareille a celui-ci :

Warning: <data_center> element has non-unique value in 'name' key attribute: Default at ./plugin-rhev.pl line 199

Afin de réssoudre le problème, ce dont vus avez besoin est de suivre une nomenclature de noms pour les entités dans l'environnement de virtualisation RHEV dans lequel les noms ne se répétent pas.

Afin d'installer le plugin d'agent vous n'avez qu'à copier le script rhev-plugin.pl et le fichier de configuration rhev-plugin.conf dans un répertoire de la machine où l'agent Pandora FMS qui exécutera le plugin est installée. Le plugin peut être exécuté dans un agent installé dans les mêmes machines que le serveur Pandora FMS ou dnas une autre machine.

Pour exécuter le plugin, ajoutez le fichier de configuration de l'agent (par défaut /etc/pandora/pandora_agent.conf) la ligne suivante :

module_plugin /root/rhev-plugin.pl /root/rhev-plugin.conf

En ajoutant cette ligne, le plugin de l'agent fera ses fonctions dans chaque exécution.

Afin de voir le résultat de l'exécution du plugin d'agent, allez vers Monitoring → Views → Agent Detail.

Le plugin crée un agent dans Pandora FMS pour chacune des entités détéctées dans la découverte de l'architecture RHEV.

Lorsque vous cliquez sur le nom d0'un agent, vous pourrez voir les modules de supervision créés par le plugin, outre d'autres données rélatives :

Pour chaque type d'entité, une série des modules déterminés sont créés, en supervisant les informations importantes de chacune.

Si l'agent sélectionné se correspond avec un hôte au lieu d'une machine virtuelle, les modules de supervision seraient différents.

Le plugin RHEV supervise aussi les evénnements qui se passent dans l'architecture virtuelle. Le plugin créera un module pour chaque evénnement supervisé dans l'entité affectée :

Les données pour les modules crées à partir des evénnemens sont des données de l'événnement : heure de l'événnement, description de l'événnement. Exemple de données :

Outre les agents et les modules relatifs à l'architecture RHEV en tant que telle, un module est généré dans l'agent qui exécute le plugin. ce module s'appele par défaut RHEV Plugin :

Le contenu du module sera le résultat de l'exécution du plugin ; il peut être OK si tout est correcte ou il montrera un chaîne d'erreur avec son explication si quelque chose se passe. Cette information peut se trouver dans le module du plugin ou dans un fichier journal.

Les modules d'état de différentes entités retournent les valeurs prédéfinies dans l'architecture RHEV. Cela signifie que les valeurs seront les chaînes de texte dont le contenu sera up, down, error, maintenance, non_operational, etc., selon l'état et l'entité supervisée.

Afin d'attribuer les valeurs warning et critical il sera nécessaire de définir une expression regulière dans la configuration du module. Par exemple pour définir un état critique dans un module déterminé par les valeurs error, down et non_operational, insérez dans le champ Str. de la valeur critical du module l'expression regulière suivante :

error|down|non_operational

Ici on detaille les modules disponibles pour chaque élément de l'architecture RHEV.

• Status: État du Data Center.

• Available Space : Espace disponible dans le Storage Domain.
• Committed Space : Espace compromis dans le Storage Domain.
• Used Space : Espace utilisé dans le Storage Domain.
• Percent Free Space : Pourcentage d'espace libre dans le Storage Domain.

• Status : État du réseau virtuel.
• STP Status : État de la fonctionnalité Spanning Tree Protocol.

• Overcommit Percent : Pourcentage de surallocation du cluster.
• Transparent HugePages : État de la fonctionnalité Transparent HugePages.
• High threshold : Limite supérieure dans les politiques de planification.
• Low threshold : Limite inférieure des politiques de planification.
• Threshold duration : Duration des limites dans les politiques de planification.

• Status : État de l'hôte.
• Buffers size : Taille des buffers.
• Cache size : Taille du cache.
• Cached swap : Quantité de mémoire Swap caching (en octets).
• Free memory : Quantité de mémoire libre (en octets).
• Percent free memory : Pourcentage de mémoire libre.
• Swap cached percent : Pourcentage de mémoire Swap caching.
• Swap free : Quantité de mémoire Swap libre (en octets).
• Swap free percent : Pourcentage de mémoire Swap libre.
• Total Memory : Quantité de mémoire de l'hôte (en octets).
• Total Swap : Quantité totale de mémoire Swap (en octets).
• Used memory : Quantité totale de mémoire utilisée (en octets).
• Used Swap : Quantité totale de mémoire Swap utilisée (en octets).
• Nic [x] TX : Ratio de transfert de l'interface du réseau [x] (en octets/seconde). Un est généré par chaque interface réseau détectée.
• Nic [x] RX : Ratio de réception de l'interface réseau [x] (en octets/seconde). Un est généré par chaque interface réseau détectée.
• Nic [x] erros TX : Nombre d'erreurs de transmission de l'interface réseau [x]. Un est généré par chaque interface réseau détectée.
• Nic [x] erros RX : Nombre d'erreurs de réception de l'interface réseau [x]. Un est généré par chaque interface réseau détectée.
• User CPU : Pourcentage d'UCT utilisé par l'utilisateur.
• System CPU : Pourcentage d'UCT utilisée par le système.
• CPU Idle : Pourcentage d'UCT sans utiliser.
• CPU Load : Charge moyenne d'UCT des dérniers 5 minutes.
• KSM CPU : Pourcentage d'UCT utilisé par KSM.
• Active VM : Nombre de machines virtuelles actives sur l'hôte.
• Migrating VM : Nombre de machines virtuelles dans la migration dans l'hôte.
• Total VM : Nombre totale de machines virtuelles dans l'hote.
• Fence Status : État du fencing de l'hôte.

• Status : État de la machine virtuelle.
• Disk [x] read : Taux de lecture du disque x (octets/seconde). Un est généré par chaque disque (stockage) détecté.
• Disk [x] write : Taux d'écriture du disque x (octets/seconde). Un est généré par chaque disque détecté.
• Disk [x] size : Taille du disque x (en octets). Un est généré par chaque disque détecté.
• Disk [x] status : État du disque x. Un est généré par chaque disque détecté.
• Nic [x] TX : Ratio de transfert pour l'interface réseau [x] (en octets/segundo). Un est généré par chaque disque détecté.
• Nic [x] RX : Ratio de réception pour l'interface réseau [x] (en octets/seconde). Un est généré par chaque disque détecté.
• Nic [x] erros TX : Nombre d'erreurs transmission pour l'interface réseau [x]. Un est généré par chaque disque détecté.
• Nic [x] erros RX : Nombre d'erreurs de réception pour l'interface réseau [x]. Un est généré par chaque disque détecté.
• Installed memory : Quantité de mémoire installée (en octets).
• Percent free memory : Pourcentage de mémoire libre.
• Used memory : Quantité de mémoire utilisée (en octets).
• Stateless : État de la fonctionnalité Stateless.
• HA Status : État de la focntionnalité du HA.
• Total CPU : Pourcentage totale de l'UCT utilisé par la machine virtuel.
• Hypervisor CPU : Pourcentage de l'UCT de l'Hypervisor utilisé par la même machine virtuelle.
• Guest CPU : Pourcentage de l'UCT de l'hôte qui utilise la machine virtuelle.

• Event [x] : Description de l'événnement x qui se passe dans le système. Un sera créé par chaque événnement détecté dans les agents affectés.

Dans cette section s'explique l'installation, configuration et fontionnement des extensions RHEV View et RHEV Manager.

Il existe la possibilité de créer des tâches personnalisés de reconnaissance grâce au Discovery server.

Pour installer les extensions juste copiez le contenu du dossier extensions, que vous trouverez lorsque vous décompressez le plugin, dans le dossier correspondante extensions de la partie Enterprise de la Console Pandora FMS. La commande à exécuter est la suivante :

cp -R extensions/* <pandora_console_dir>/enterprise/extensions/

À partir de ce moment les extensions de supervision RHEV seront disponibles.

Afin d'utiliser l'extension RHEV View juste cliquez sur l'option RHEV View dans le submenu Monitoring.

L'extension vous montrera une carte comme la suivante, avec tous les composants de l'architecture RHEV découverts par le plugin :

La carte représente les différents éléments de l'architecture RHEV (Data Centers, Storage Domains, Clusters, Networks, Hosts et Virtual machines). Chaque élément est représenté par un icône, différent pour chaque type de l'élément de l'architecture. Les rélations entre les différents éléments de l'architecture RHEV sont aussi représentés. Avec cette vue il est très facile de voir l'état des éléments et comment ils interagissent.

L'extension compte sur un menu qui permet de configurer la vue en cachant ou montrant des entités, en élargeant ou réduissant la taille du texte et en zoomant pour voir l'image avec plus de détails.

Par exemple, dans l'image suivante de la carte les éléments elementos Networks, Hosts et Virtual Machine ont été cachés de l'architecture parce que on a besoin de voir en détail les rélations des Clusters et Storage Domains avec les Data Center.

L'extension RHEV Manager est disponible dans la vue d'opération des agents Pandora FMS qui se correspondent avec les machines virtuelles dans l'architecture de virtualisation RHEV.

Pour accéder à l'extension, cliquez sur le bouton avec le logo de Red Hat que vous trouverez ensemble avec les autres tabs de l'agent.

L'extension perment de gérer des machines virtuelles (allumer, éteindre et suspendre) sans besoin d'ouvrir la console de gestion RHEV. Dans l'extension l'état actuel de la machine virtuelle est montré avec un code de couleurs :

• Verde = Allumé.
• Naranja = Suspendu.
• Gris = Arrêté.

Avec un combo avec les états disponibles aux états que la machine virtuelle peut prende lorsque vous cliquez Change Status.

Si vous choisissez l'état Stop pour arrêter la machine virtuelle, l'extension connectera avec l'API RHEV et envoiera l'ordre. Le résultat sera le changement d'état dans la machine virtuelle et les options du combo :

Le changemant de quelques état n'est pas automatique, comme par exemple de l'état Stop vers Start. Dans ce cas, l'extension montrera l'état de la machine virtuelle selon le changement dans l'architecture de virtualisation. Exemple :

La configuration du plugin de l'agent se fait par le biais d'un fichier de configuration dont le nom par défaut est rhev-plugin.conf.

Par défaut, le plugin de l'agent choisit toutes les entités et rée tous les modules correspondants avec des valeurs predéfinis pour le nom et la descripton. Tous ces aspects, ainsi que les variables générales du plugin, peuvent être configurés à travers le fichier de configuration.

Le fichier de configuration a deux sections très bien définies : les variables globales et la configuration de supervision.

La section de variables globales commence avec le jeton Configuration et contient les informations de configuration du plugin. Les paramètres autorisés dans cette section :

• module_name : Nom du module de l'agent avec l'état de l'exécution du plugin.
• server : Nom de l'hôte qui fournit du service de l'API de RHEV.
• user : Utilisateur sous format user @domain pour se connecter à l'API.
• pass : Mot de passe pour se connecter à l'API.
• cert : Chemin du certificat pour se connecter à l'API.
• temporal : Répertoire temporel.
• logfile : Fichier journal.
• transfer_mode : Mode de transfert. Vous pouvez prender les valeurs : local ou tentacle.
• tentacle_ip : Addresse IP du serveur Tentacle auquel envoyer les informations. Normarellement il se trouvera dans la même machine que celle du serveur Pandora FMS. Cette option s'utilise seulement si transfer_mode a la valeur tentacle.
• tentacle_port : Port du serveur Tentacle. Cette option seulement s'utilise si transfer_mode a la valeur tentacle.
• tentacle_opts : Options d'envoi de données pour Tentacle. Cette option seulement s'utilise si transfer_mode a la valeur tentacle.

La section de configuration de la supervision se divise en quelques sous-sections. La première sous-section a comme jeton Reject et liste les entités de l'environnement de virtualisation qui seront écartés de la supervision. Afin d'écarter une entité il sera nécessaire d'entrer son nom dans cette liste. Par exemple :

 #Dismissed entities
 Reject
 mv1
 mv_Windows10
 mv_WebServer1
 ...

Il és possible d'écarter toutes les entités du même type, par exemple toutes les hôtes, toutes les machines virtuelles, etc. Les jeton pour chaque entité sont : all_dc (Data Center), all_host (Hosts), all_network (Networks), all_storage (Storage Domain), all_cluster (Cluster), all_vm (machines virtuelles). Exemple d'utilisation de ces jetons :

 #Dismissed entities
 Reject
 all_dc
 all_host
 all_network
 all_storage
 all_cluster
 all_vm

La deuxième section a comme jeton Rename et sert à changer les noms des entités supervisées à travers le plugin. Cette fonctionnalité esttrès utile si vous voulez combiner la supervision d'agent logiciels avec les données extraits de l'API de Pandora FMS. La configuration de cette section se fait en écrivant au début le nom ancienne et après le nouveau nom séparé par un espace ; par exemple :

 #Rename entities
 Rename
 mv_WebServer1 WebServer1
 mv_Windows10 Windows10 Test
 ...

Les sous-sections suivantes corresponderont la configuration de supervision pour chaque entité. Chaque entité a son propre jeton, qui sont les suivants : DataCenter, StorageDomain, Network, Cluster, Host et VM. Pour chacune des entités, il est possible de définir les modules qui seront désactivés ou définir des valeurs personnalisés pour le nom, la description et les plages de maximums et minimums pour les états Warning et Critical. Un exemple serait le suivant :

#VM Modules
VM
status disabled
errors_total_tx name = Errores TX Net [%s]; desc = Erreurs totales TX réseau; limits = 60 70 71 100
memory_used name = Memoire en utilisation; desc = Mémoire utilisée par la machine virtuelle; limits = 256 1024 1025 2048
...

Chaque ligne de configuration des modules de supervision se correspond à deux options disponibles :

• <module> disabled: Le module NE ser pas créé.
• <module> nom = <nom>; desc = <description>; limits = <min_warning> <max_warning> <min_critical> <max_critical» Le module sera créé avec le nom et la description fournis et en outre les seuils pour les maximums et minimums des valeurs Warning et Critical.

Il est très important d'avoir sur compte l'estructure des lignes de fichier de configuration et sourtout de voir que le caractère ; est à côté du nom et la description u module. Ces deux lignes NE SONT PAS ÉQUIVALENTES (voyez les espaces avent le caractère ; ) :

errors_total_tx name = Erreurs TX Net [%s]; desc = Erreurs totales TX réseau; limits = 60 70 71 100 #Correcte
errors_total_tx name = Erreurs TX Net [%s]    ; desc = Erreurs totales TX réseau    ; limits = 60 70 71 100 #Incorrecte

Les modules sont référencies par son nom court, un nom équivalent plus facile à écrire dans la ligne de commande. La table de correspondance entre les noms courts et étendus se trouve dans la section suivante.

Exemple de configuration pour les machines virtuelles, section VM :

Pour la supervision de machines virtuelles une série de modules activés ou pas définis dans la section VM du fichier de configuration ont été définis. Particulièrement : le module status a été desactivé et pour les modules errors_total_tx et memory_used des valeurs personnalisables ont été définis. Les autres modules qui n'apparaîtrent pas dans la liste seront créés avec les valeurs par défaut. Avec cette configuration, le module memory_used prendra les valeurs suivantes :

• Nom : Mémoire en utilisation.
• Descripction : Mémoire utilisée par la machine virtuelle.
• Min Warning : 256.
• Max Warning : 1024.
• Min Critical : 1025.
• Max Critical : 2048.

Les modules se générent dynamiquement ; par exemple, deux relatifs aus disques ou interfaces dont l'un de chaque élément détécté est créé. Ils ont une syntaxe speciale pour le nom du module, qui est la suivante :

errors_total_tx name = Errores TX Net [%s]; desc = Errores totales TX de red; limits = 60 70 71 100

Dans ces cas, comme le nom a une partie dynamique, ce qui permet d'utiliser la macro %s qui sera remplacé par le plugin par la partie variable du nom du module.

Par exemple, le module errors_total_tx a un nom par défaut :

Nic [nic1] errors TX

Il changera son nom par :

Errores TX Net [nic1]

nic1 étant la partie dynamique du nom du module.

En outre les sections propres de chaque élément de l'architecture, le fichier de configuration a une section commune pour les événements. Cette section est définie avec le jeton EventCodes et là-bas les codes des événements à superviser seront listés ; par exemple :

 EventCodes
 30
 920
 980
 509
 956

Si vous ne definissez pas cette section, la supervision d'événements ne se fera pas.

Par le biais du fichier de configuration du plugin de l'agent, il est possible de diviser la charge de supervision de l'infrastructure de virtualisation RHEV.

Pour ça les entités à superviser entre les différents agents seront divisés entre les différents agents. Suposons qu'il a l'architecture suivante :

 DC1
  |
  |- Cluster 1.1
        |- c1.1mv1
        |- c1.1mv2
        |- c1.1mv3

  |- Cluster 1.2
        |- c1.2mv1
        |- c1.2mv2
        |- c1.2mv3

 DC2
  |
  |- Cluster 2.1
        |- c2.1mv1
        |- c2.1mv2
        |- c2.1mv3

  |- Cluster 2.2
        |- c2.2mv1
        |- c2.2mv2
        |- c2.2mv3

Una forme de diviser la charge serait alloqué à un Datacenter à chacun des agents logiciels ; pour ça on utiliserait la fonctionnalité pour écarter des entités à superviser (jeton Reject).

Le permier agent logiciel supervise le Datacenter DC1 et écarte les entités DC2.

 Reject
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

Le deuxième agent logiciel supervise le Datacenter DC2 et écarte les entités de DC1.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3

Nous pourrions aussi diviser la charge partant des clusters, par exemple. Pour chaque cluster des deux Datacenters sun agent des cuatre premiers sera alloqué.

Agent logiciel 1, superviser cluster 1.1 et écarte les autres entités.

 Reject
 DC1
 Cluster 1.2
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agent logiciel 2, superviser cluster 1.2 et il écarte les autres entités.

 Reject
 DC1
 Cluster 1.1
 c1.1mv1
 c1.1mv2
 c1.1mv3
 DC2
 Cluster 2.1
 Cluster 2.2
 c2.1mv1
 c2.1mv2
 c2.1mv3
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agent logiciel 3, superviser cluster 2.1 et écarte les autres entités.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.2
 c2.2mv1
 c2.2mv2
 c2.2mv3

Agent logiciel 4, superviser cluster 2.2 et il écarte les autres entités.

 Reject
 DC1
 Cluster 1.1
 Cluster 1.2
 c1.1mv1
 c1.1mv2
 c1.1mv3
 c1.2mv1
 c1.2mv2
 c1.2mv3
 DC2
 Cluster 2.1
 c2.1mv1
 c2.1mv2
 c2.1mv3

La configuration des entités écartées est complètement flexible et la charge peut se diviser en allouant quelques entités à chaque agent logiciel.

Fichier avec tous les modules desactivés

  #These lines are comments

 #Plugin configuration parameters
 Configuration
 server rhevm.server
 user user@testdomain
 pass 12345
 cert /home/user/rhevm.cer
 temporal /tmp
 logfile /tmp/plugin-rhev.log
 transfer_mode local
 tentacle_ip 127.0.0.1
 tentacle_port 41121
 tentacle_opts

 #Dismissed entities
 Reject

 #Data Center modules
 DataCenter
 status disabled

 #StorageDomain modules
 StorageDomain
 available disabled
 used disabled
 committed disabled
 free_percent disabled

 #Networks modules
 Network
 status disabled
 stp disabled

 #Clusters modules
 Cluster
 overcommit disabled
 hugepages disabled
 threshold_low disabled
 threshold_high disabled
 threshold_duration disabled

 #Host Modules
 Host
 status disabled
 vm_active disabled
 vm_migrating disabled
 vm_total disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled
 memory_cached disabled
 memory_total disabled
 swap_free_percent disabled
 swap_cached_percent disabled
 swap_free disabled
 cpu_current_idle disabled
 cpu_current_user disabled
 memory_used disabled
 ksm_cpu_current disabled
 memory_free_percent disabled
 swap_total disabled
 memory_buffers disabled
 cpu_current_system disabled
 cpu_load_avg_5m disabled
 swap_cached disabled
 swap_used disabled
 memory_free disabled
 fence_status disabled

 #VM Modules
 VM
 status disabled
 stateless disabled
 ha disabled
 cpu_current_guest disabled
 cpu_current_hypervisor disabled
 memory_free_percent disabled
 memory_installed disabled
 memory_used disabled
 cpu_current_total disabled
 data_current_read disabled
 data_current_write disabled
 size disabled
 disk_status disabled
 data_current_rx disabled
 data_current_tx disabled
 errors_total_rx disabled
 errors_total_tx disabled

Data Center

Storage Domain

Network

Cluster

Host

Virtual Machine

La solution d’hyperconvergence Nutanix nous offre la possibilité de gérer toutes les ressources de réseau, de disque, de traitement et de mémoire depuis un même point.

Le plugin de surveillance de Pandora FMS pour Nutanix® nous permet de contrôler continuellement l’état de notre solution Nutanix®.

Le plugin Nutanix® est un programme écrit dans Perl, qui se connectera à l’API REST de Nutanix PRISM®, en récupérant les métriques nécessaires pour surveiller les éléments suivants :

• Clusters Nutanix®.
• Dispositifs de stockage
• Conteneurs.
• Machines Virtuelles.
• Hosts.
• Etats des processus de réplication.

Pour pouvoir récupérer l’information de l’API REST, il nous faudra :

• L’adresse IP/ FQDN du portail.
• Un “utilisateur” avec des autorisations de lecture sur l’API.
• Le mot de passe de l’utilisateur.

En ce qui concerne la communication des résultats de la surveillance à votre Pandora FMS, il faudra :

• Le mode de transfert de l’information, soit local ou via Tentacle.
  • En local, l’adresse du répertoire où les fichiers XML avec les résultats doivent être remis, tels que les autorisations d’écriture dans ledit répertoire.
  • Via Tentacle, il faudra pouvoir connecter contre l’adresse IP ou FQDN du serveur Pandora FMS, le port utilisé par l’installation Tentacle, la localisation du client de Tentacle, comme n’importe qu’elle option extraordinaire qu’il ait défini.

Téléchargez les archives requises par le plugin de la bibliothèque de modules. Transférez les archives à l’équipement à distance d’où vous souhaitez réaliser la surveillance de votre infrastructure Nutanix et extrayez les archives du plugin :

tar xvzf pandora_nutanix.tar.gz

Les champs suivants sont déclarés :

Nutanix API configuration

nx_fqdn

adresse du serveur principal Prism

nx_port

port dans lequel l’API REST est publié (par défaut 9440).

nx_user

utilisateur avec des avantages de lecture sur l’API REST.

nx_pass

mot de passe de l’utilisateur

use_https

Usar https (1) o no (0)

nx_rest_version

Version de l’API Rest (par défaut 'v1')

Nutanix agent configuration

agent_interval

Intervalle des agents générés par le plugin (par défaut 300).

agent_group

groupe auquel appartiendront les agents générés (si ‘autocreate_group’ est commenté dans la configuration de votre PandoraServer), par défaut Nutanix.

module_interval

intervalle des modules des agents générés (facteur de multiplication, par défaut 1).

module_tagsÉtiquettes associées aux nouveaux modules des agents générés.

module_group

groupe auquel appartiendront les nouveaux modules.

Configuration de la communication vers le serveur de Pandora FMS

mode

Mode de transfert de données, “ local ” ou “ tentacle ”.

tentacle_ip

Adresse IP du serveur Pandora FMS, qui ne s’applique qu’en mode tentacle.

tentacle_port

Port sur lequel le service Tentacle écoute.

tentacle_opts

Toute option extra que vous ayez configurée sur votre service Tentacle.

tentacle_client

Chemin d’accès complet à votre client Tentacle.

temp

Répertoire de travail temporaire.

local_folder

Chemin d’accès de transfert des données pour le mode “local”

Filtres

cluster_monitoring

Activer(1) ou non (0) la surveillance de clusters.

storage_monitoring

Activer (1) ou non (0) la surveillance de dispositifs de stockage.

container_monitoring

Activer (1) ou non (0) la surveillance des conteneurs de stockage.

vm_monitoring

Activer (1) ou non (0) la surveillance de machines virtuelles.

host_monitoring

Activer (1) ou non (0) la surveillance de serveurs de machines virtuelles (noeuds Nutanix).

pd_monitoring

Activer (1) ou non (0) la surveillance de domaines de protection.

Personnalisations

cluster_agent_header

En-tête pour le nom de l’agent des dispositifs de type cluster.

storage_agent_header

En-tête pour le nom de l’agent des dispositifs de type dispositif de stockage. ;host_agent_header

host_agent_header

En-tête pour le nom de l’agent des dispositifs de type serveur de machines virtuelles (noeuds Nutanix).

container_agent_header

Cn-tête pour le nom de l’agent des dispositifs de type conteneurs de stockage.

vm_agent_header

En-tête pour le nom de l’agent des dispositifs de type machine virtuelle.

pd_agent_header

En-tête pour le nom de l’agent de dispositifs de type domaine de protection.

Règles de génération des modules

vm_stat

Règle pour l’ajout de modules pour la surveillance de machines virtuelles, par défaut hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*. Ceci indique les modules extraordinaires qui se généreront quand le nom de la métrique coincidera avec les expressions régulières indiquées dans ce champs. Ajoutez la valeur .* pour surveiller toutes les métriques disponibles.

host_stat

Règle pour l’ajout de modules pour la surveillances de machines virtuelles (noeuds Nutanix), par défaut hypervisor_cpu_usage_ppm|hypervisor_memory_usage_ppm|.*avg.*. Ceci indique les modules extraordinaires qui se généreront quand le nom de la métrique coincidera avec les expressions régulières indiquées dans ce champs. Ajoutez la valeur .* pour surveiller toutes les métriques disponibles.

pd_stat

Règle pour l’ajout de modules pour la surveillance de domaines de protection, par défaut replication_transmitted_bandwidth_kBps|replication_total_transmitted_bytes. Ceci indique les modules extraordinaires qui se généreront quand le nom de la métrique coincidera avec les expressions régulières indiquées dans ce champs. Ajoutez la valeur .* pour surveiller toutes les métriques disponibles.

Renommé des entités

RENAME aaa TO bbb

Règle pour renommer des entités. Vous pouvez définir autant de directives que d’élément à renommer.

Exclusion des entités

REJECT aaa

Règle pour l’exclusion de surveillance des entités. Vous pouvez définir autant de directives que d’éléments à exclure.

Il est recommandé d’exécuter le plugin à distance, depuis un équipement avec un accès aussi bien à Pandora Server qu’à votre infrastructure Nutanix® à surveiller.

Exécution manuelle :

./pandora_nutanix-linux-x64 pandora_nutanix.conf

Vous pouvez automatiser l’exécution du plugin dans le cron du système en ajoutant la ligne suivante à /etc/crontab.

• /5 * * * * root /path/to/plugin/pandora_nutanix-linux-x64 /path/to/plugin/pandora_nutanix.conf

Captures avec les résultats obtenus par le plugin :

Exemple de carte de l’architecture Nutanix® :

Exemple de vue de l’agent de l’architecture Nutanix® :

Exemple de vue des modules pour agents de type Host Nutanix® :

Xen est un moniteur de machine virtuelle de code ouvert, développé par l’université de Cambridge.

L’objectif de ce concept est de pouvoir exécuter des instances des systèmes opératifs avec toutes les caractéristiques, de façon complètement fonctionnelle dans un équipement simple.

Xen fournit un isolement sûr, un contrôle des ressources et des garanties de qualité de service et de migration des machines virtuelles à chaud. Les systèmes opératifs peuvent être modifiés explicitement pour exécuter Xen (bien qu’en maintenant la compatibilité avec des applications d’utilisateur). Ceci permet à Xen de réaliser la visualisation de haute performance sans un support spécial de hardware.

Intel a réalisé diverses contributions à Xen en ajoutant un support pour ses extensions d’architecture VT-X Vanderpool. Cette technologie permet que des systèmes opératifs, sans les modifier, agissent comme des hosts dans les machines virtuelles de Xen, tant que le serveur physique supporte les extensions VT de Intel ou Pacifica de AMD.

Le plugin Pandora FMS pour la surveillance des environnements Xen est écrit sur Python. Il utilise XenAPI pour récupérer toute l’information nécessaire. Il permet de surveiller les types d’éléments suivants :

• Systèmes virtualisés dans Xen.
• Ressources de stockage.
• Propre serveur Xen (host).

Il est indispensable que le système qui exécute le plugin dispose des pré-requis suivants :

• Python installé
• Bibliothèques Python installées :
  • XenAPI
  • xmltodict
• Accès à l’API de votre XenServer (web, il active le trafic depuis l’équipement qui exécute le plugin au port 443 ou 80 du XenServer).
• Il est recommandé que les machines virtuelles aient Xen Server Tools d’installée puisque, dans le cas contraire, l’information disponible est assez limitée.

Téléchargez votre copie du plugin de Pandora FMS pour XenServer depuis la bibliothèque de modules. Vous pouvez le déployer dans l’équipement que vous préférez (Windows ou Linux), en extrayant le contenu de l’archive dans un répertoire stable d’où vous pouvez l’exécuter, et qui utilise déjà correctement l’agent Pandora FMS ou le cron système.

Configuration disponible pour le plugin Pandora FMS pour Xen :

Bloc de configuratio (CONF)

xen_server_ip

Adresse IP/FQDN du serveur Xen

user

Utilisateur avec autorisations de consultation sur l’API de Xen.

password

Mot de passe de l’utilisateur

temporal

Adresse de travail temporaire

Bloc de configuration (pandora)

tentacle_client

Emplacement binaire du client de Tentacle

tentacle_ip

Adresse IP sur lequel le service Tentacle est écouté.

tentacle_port

Port sur lequel le service Tentacle est écouté.

logfile

Chemin d’accès complet au fichier de log

interval

Intervalle des agents générés

group

Groupe assigné aux agents générés.

Bloc de configuration (TUNNING)

time_adjustment

Paramètre qui permet l’ajustement des différences de temps possibles entre l’équipement qui exécute le plugin et le serveur Xen. (Par défaut = 10, mesuré en secondes).

scan_vm_ip

Paramètre qui permet de définir si le plugin essaiera d’obtenir les IPs des VMs du serveur Xen. Seules les IPs de ces VMs avec celles XenTools installées peuvent être utilisées. On peut les activer (scan_vm_ip = true) ou les désactiver (scan_vm_ip = false). Si on ne le précise pas, ce sera considéré comme activé.

Bloc de configuration (RENAME)

xen_element_name = pandora_agent_name

Dans ce bloc, il est possible de définir autant d’entrées que souhaitées avec ce format. Cela permet de changer les noms des éléments du Xen Server en d’autres distincts, afin d’être utilisés commes des noms d’agents dans Pandora FMS. Les VMS, les SRs et le XenServer lui même, peuvent être renommés. Par exemple :

[RENAME]
example-xen-server=Example Xen Server
Example Xen Server 2=example-xen-server-2
example-vm=Example VM
Example VM 2=example-vm-2
example-sr=Example SR
Example SR 2=example-sr-2

Bien que les noms aient des espaces blancs, il ne faut pas mettre de guillemets.

Vous pouvez programmer l’exécution du plugin depuis n’importe quel agent de Pandora FMS, en ajoutant à la configuration de ce dernier :

module_plugin python "<ruta>\xen-plugin.py" "<ruta>\xen-plugin.conf"

Pour le programmer grâce au cron du système, vous pouvez ajouter la ligne suivante à /etc/crontab:

• /5 * * * * root python “<ruta>\xen-plugin.py” “<ruta>\xen-plugin.conf” > /dev/null 2>&1

Si vous exécutez le plugin manuellement, la sortie doit être semblable à la suivante :

python "<ruta>\xen-plugin.py" "<ruta>\xen-plugin.conf"
<module>
<name><![CDATA[XenServer Plugin]]></name>
<type><![CDATA[async_string]]></type>
<description><![CDATA[Result of XenServer Plugin execution]]></description>
<data><![CDATA[OK]]></data>
</module>

Captures avec les résultats obtenus par le plugin :

Exemple de carte de l’architecture Xen :

Exemple de vue d’un agent de l’archietcture Xen :

Exemple de vue des modules pour des agents de type Host Xen :

OpenNebula est une plate-forme informatique dans le nuage, orientée vers des centres de données distribuées et hétérogènes, fournissant une infrastructure virtuelle pour construire des nuages privés, publics et des implémentations hybrides d’infrastructure comme de service (IaaS).

OpenNebula est un logiciel de source ouverte, protégé dans la Licence Apache 2.

Le plugin Pandora FMS, pour la surveillance d’environnements OpenNebula, est écrit sur Perl. Il s’exécute localement dans le serveur OpenNebula et récupérera toute l’information nécessaire en utilisant les propres commandes de gestion d’OpenNebula. Il permet la surveillance des types d’éléments suivants :

• Clusters
• Hosts
• Machines virtuelles
• Ressources de stockage

Il est indispensable que le système qui exécute le plugin dispose des pré-requis suivants :

• Perl disponible sur l’équipement
• Utilisateur avec des droits pour exécuter les commandes suivantes :
  • onehost
  • onecluster
  • onedatastore

    Le bon fonctionnement du plugin a fait ses preuves sur des systèmes OpenNebula 5.X.X

Téléchargez votre copie du plugin de Pandora FMS pour OpenNebula de la bibliothèque des modules. Vous devez extraire le contenu de l’archive dans un répertoire stable, d’où vous pourrez l’exécuter, qui utilise déjà correctement l’agent de Pandora FMS ou le cron du système.

unzip pandora_OpenNebula.zip

Configuration disponible pour le plugin Pandora FMS pour OpenNebula :

mode

Mode de transfert de données, “local” ou “tentacle”

tentacle_ip

Adresse IP du serveur Pandora FMS, qui ne s’applique qu’en mode tentacle.

tentacle_port

Port dans lequel le service Tentacle est écouté

tentacle_opts

Toute option supplémentaire qui soit configurée dans votre service Tentacle.

tentacle_client

Chemin d’accès complet au client Tentacle

temp

Adresse de travail temporaire

local_folder

Chemin d’accès de l’emplacement des données pour le mode de transfert “local”.

agent_interval

Intervalle de l’agent, par défaut 300

agent_group

Groupe de l’agent, par défaut OpenNebula

MODULE_GROUP

Groupe des modules, par défaut OpenNebula

MODULE_INTERVAL

Intervalle des modules (multiplicateur), par défaut 1.

MODULE_TAGSÉtiquettes pour les modules.

cluster_agent_header

En-tête pour le nom de l’agent des dispositifs de type cluster

host_agent_header

En-tête pour le nom de l’agent des dispositifs de type serveur de machines virtuelles.

storage_agent_header

En-tête pour le nom de l’agent des dispositifs de type dispositif de stockage.

vm_agent_header

En-tête pour le nom de l’agent des dispositifs de type machine virtuelle.

cluster_monitoring

Activer (1) ou non (0) la surveillance clusters.

host_monitoring

Activer (1) ou non (0) la surveillance de serveurs de machines virtuelles.

storage_monitoring

Activer (1) ou non (0) la surveillance de dispositifs de stockage.

vm_monitoring

Activer (1) ou non (0) la surveillance de machines virtuelles.

RENAME aaa TO bbb

Règle pour renommer des entités : vous pouvez définir autant de directives que d’éléments qui nécessitent d’être renommés.

REJECT aaa

Règle pour l’exclusion de surveillance des entités : vous pouvez définir autant de directives que d’éléments à exclure.

Pour le programmer grâce au cron du système, vous pouvez ajouter la ligne suivante à /etc/crontab:

/5 * * * * root "<ruta>/pandora_opennebula" "<ruta>/pandora_opennebula.conf"> /dev/null 2>&1

Si vous l’exécutez manuellement, la sortie doit ressembler à la suivante :

[root@valhalla ~]# ./pandora_opennebula pandora_opennebula.conf
[root@valhalla ~]# echo $?
0

Liste des modules générés par le plugin OpenNebula :

Pour les Hosts:

1. Available CPU
2. Available Disk
3. Available memory
4. Error Error reported by OpenNebula
5. State
6. Total zombies
7. VMs running

Pour des dispositifs de stockage :

1. Disk Free %

Pour des machines virtuelles :

1. Assigned CPU
2. Assigned Memory
3. Network RX
4. Network TX
5. State
6. Time running

Exemple de carte d’architecture OpenNebula :

Ce plugin permet de surveiller des équipements de virtualisation IBM AIX grâce à la console d’administration de hardware HMC. Ce plugin collectera des informations de toutes les partitions logiques créées dans un environnement AIX administré par un système HMC, en créant un agent pour chaque serveur administré, chaque partition logique et chaque serveur IO virtuel.

Pour récupérer l’information via SSH, le plugin peut utiliser trois modes de travail :

1. Basé sur expect en utilisant le script ssh_launcher.sh
2. Basé sur la bibliothèque Net::SSH::Perl
3. Basé sur la bibliothèque Net::SSH::Expect

Pour compléter l’information capturée, des requêtes sur l’API REST seront réalisées par défaut sur:

 https://fqdn:12443/rest/api/{root_element})

Les paramètres nécessaires pour la surveillance, que doit fournir le domaine qui nécessite les services de surveillance, sont :

• Nom d’utilisateur pour s’authentifier dans le système HMC (lecture seule)
• L’utilisateur doit avoir l’autorisation pour pouvoir se connecter à l’API REST et pour se connecter dans la shell du HMC et exécuter les commandes suivantes (minimum requis) :
  • lssyscfg
  • lshwres
• Mot de passe dudit utilisateur
• Emplacement (FQDN/IP) du HMC (p.e. myhmc.mydomain)
• URL de base de l’API REST du HMC p.e. :

 https://myhmc.mydomain:12443

Les paramètres qui surveille le plugin sont (regroupés par type d’élément) :

• Current logical partitions
• Max logical partitions
• Max memory available
• Max memory installed
• Proc pool DefaultPool current proc units
• Proc pool DefaultPool max proc units
• Proc pool DevelopmentPool current proc units
• Proc pool DevelopmentPool max proc units
• Proc pool ProductionPool current proc units
• Proc pool ProductionPool max proc units
• Proc pool TestPool current proc units
• Proc pool TestPool max proc units
• Proc pool VIOPool current proc units
• Proc pool VIOPool max proc units
• Processor pools configured
• Processor units available
• Processor units installed
• State
• UUID
• Virtual proc units max

LPAR :

• Auto start : Configuration de partitions logiques auto démarrage.
• LPAR type : Type de partition logique.
• LPAR UUID : Utilisé pour vérifier les HMC API.
• Max memory : Memoire maximale.
• Max memory : Memoire disponible.
• Processor units available : Unités de traitement disponibles.
• Processor units current : Unités de traitement installées
• RMC IP address : Addresse IP RMC.
• RMC state : État du RMC dans LPAR
• State : État de la partition logique.
• Virtual proc units : Unités de traitement virtuel alloués à ce LPAR.

Virtual IO :

• Auto start : Configuration de partitions logiques auto-démarrage.
• LPAR type : Type de partition logique.
• LPAR UUID : Utilisé pour vérifier les HMC API.
• Max memory : Mémoire maximale.
• Max memory current : Mémoire disponible.
• Processor units available: Unités de traitement disponibles
• Processor units current : Unités de traitement instaladas
• RMC IP address : Adresse IP RMC.
• RMC state RMC : État du RMC en LPAR.
• State : État de la partition logique.
• Virtual proc units : Unités de traitement virtuel alloués à ce LPAR.

Configuration disponible pour le plugin Pandora FMS pour IBM HMC :

mode

Mode de transfert de données, “local” ou “tentacle”

tentacle_ip

Adresse IP du serveur Pandora FMS, qui ne s’applique qu’en mode tentacle.

tentacle_port

Port sur lequel le service Tentacle est écouté.

tentacle_opts

Toute option supplémentaire qui ait été configurée sur le service Tentacle.

tentacle_client

Chemin d’accès complet au client Tentacle.

temp

Répertoire de travail temporaire.

local_folder

Chemin d’accès de dépôt des données en mode transfert “local”.

hmc_host

IP ou FQDN de l’HMC.

hmc_user

Utilisateur avec autorisation de lecture.

hmc_pass

Mot de passe.

as_agent_plugin

La sortie du plugin sera renvoyée en format XML pour des exécutions programmées avec l’agent de Pandora FMS (as_agent_plugin = 1). Ou sortie standard (as_agent_plugin = 0) pour des exécutions programmées avec le cron système ou réalisées comme plugin de serveur.

agent_name

Optionnel : indiquer un nom pour l’agent père, par défaut “hostname”.

agent_interval

Intervalle de l’agent, par défaut 300.

agent_group

Groupe de l’agent, par défaut IBM.

module_group

Groupe des modules, par défaut IBM

module_interval

Intervalle des modules (multiplicateur), par défaut 1

module_tagsÉtiquettes pour les modules

Pour renommer des entités, un renommage pour chaque bloc est utilisé :

 rename
 MyLPAR_NAME TO my new name
 MyLPAR_NAME2 TO my second new name
 rename_end

Le plugin de Pandora FMS pour la surveillance des systèmes IBM AIX grâce à HMC se déploie de la façon suivante :

En configurant le paramètre as_agent_plugin à 1 (exécution en tant que plugin d’agent) :

module_plugin /usr/bin/perl pandora_hmc.pl pandora_hmc.conf

En configurant le paramètre as_agent_plugin a 0 (exécution en tant que plugin de serveur) :

# /etc/crontab
*/5 * * * * root /usr/bin/perl /root/hmc/pandora_hmc.pl /root/vmware/pandora_hmc .conf

La virtualisation de machines fournie par Hewlett-Packard permet d’exécuter simultanément plusieurs machines virtuelles dans n’importe quel serveur Itanium exécutant HP-UX. C’est un produit optimisé pour des serveurs.

Ce plugin permet de surveiller des équipements de virtualisation HPVM. Il se lance comme un plugin d’agent, en générant en parallèle, un agent en plus pour chaque équipement virtualisé et hébergé dans le système surveillé.

Pour collecter l’information, des commandes locales sont utilisées.

1. Déployer un agent de Pandora FMS dans l’équipement que vous souhaitez surveiller
2. Disposer d’un utilisateur avec des autorisations pour exécuter le plugin
3. Cet utilisateur doit disposer des autorisations pour exécuter la commande hpvmstatus pour pouvoir interpréter la sortie :
   1. hpvmstatus
   2. hpvmstatus -X
   3. hpvmstatus -r -X

Téléchargez votre copie du plugin de Pandora FMS pour OpenNebula de la bibliothèque de modules. Vous pouvez programmer l’exécution en utilisant les collectes et l’agent de Pandora FMS, déployer ou bien extraire le contenu de l’archive dans un répertoire stable à partir duquel vous pourrez l’exécuter grâce au cron de votre système.

unzip pandora_HPVM.zip

Configuration disponible pour le plugin Pandora FMS pour HPVM :

mode

Mode de transfert de données, “local” ou “Tentacle”

tentacle_ip

Adresse IP du serveur Pandora FMS, qui ne s’applique qu’en mode tentacle.

tentacle_port

Port sur lequel le service Tentacle est écouté.

tentacle_opts

Toute option supplémentaire qui ait été configurée dans le service Tentacle.

tentacle_client

Chemin d’accès complet au client Tentacle.

temp

Répertoire de travail temporaire.

local_folder

Cchemin d’accès de dépôt des données en mode “local”.

agent_name

facultatif : indiquer un nom pour l’agent père, par défaut hostname.

agent_interval

intervalle de l’agent, par défaut 300.

agent_group

groupe auquel les agents appartiendront, par défaut HPVM.

module_group

Groupes des modules.

module_interval

intervalle des modules (multiplicateur), par défaut 1.

module_tagsÉtiquettes pour les modules

En exécutant le plugin depuis l’agent de Pandora FMS, la ligne suivante apparaîtra dans le fichier de configuration de l’agent :

module_plugin /usr/bin/perl pandora_hpvm.pl pandora_hpvm.conf

Pour un test manuel, configurez le plugin en suivant les étapes décrites. Vous pouvez le lancer comme ci-après :

perl pandora_hpvm.pl pandora_hpvm.conf

Liste des modules générés par le plugin par type d’élément.

Agents serveur :

• Available VMs : Machines virtuelles disponibles.
• HPVM Plugin : État d'exécution du plugin HPVM.
• HPVM Service : Présence de hpvmctrld (X instances).
• HPVM Service CPU usage CPU : Utilisation d'UCT du hpvmctrld (X instances).
• HPVM Service RAM : Utilisation de RAM du hpvmctrld (X instances).
• hpvmapp : Présence de hpvmapp (X instances).
• hpvmapp CPU : Utilisation d'UCT du hpvmapp (X instances).
• hpvmapp RAM : Utilisation RAM du hpvmapp (X instances)

Machines virtuelles

• boot_type
• console_type
• CPU usage
• device_number
• direct_io_number
• distributed
• effective_serverid
• guest_type
• Host RAM available
• Host RAM free
• local_id
• memory total
• model_name
• networks_number
• run_pid
• run_serverid
• serial_number
• uuid
• vcpu_number
• vm_condition
• vm_config_label
• vm_config_version
• vm_state
• vm_version
• vm_version_label

Retour à l'index de documentation du Pandora FMS