Debian Codegraph @

connectors/vmware/doc/fr/exploitation/index.rst

raw
1 ============
2 Exploitation
3 ============
4
5 Principes Généraux
6 ------------------
7
8 Centreon-esxd est un programme Perl chargé de récupérer des indicateurs VMWare. Ce programme utilise le SDK Perl fourni par VMWare afin de se connecter et récupérer les informations d'un (ou plusieurs) VirtualCenter. Pour cela il effectue une connexion TCP avec le(s) VirtualCenter.
9
10 Par défaut, « centreon-vmware » lance au moins deux processus (nommé respectivement « handle-client », « handle-vsphere-xxxx ») :
11
12 *« handle-client »*:
13 *Processus en attente des demandes clientes.*
14
15 Voici le fonctionnement :
16
17 - Un client se connecte.
18 - Le client demande un indicateur de supervision sur un VirtualCenter.
19 - Le processus « handle-client » fourni cette demande au processus « handle-vsphere-xxxx ».
20 - Une réponse est fournie par « handle-vsphere-xxxx » à « handle-client ».
21 - Le processus « handle-client » fourni la réponse au client.
22
23 *« handle-vsphere-xxxx »*:
24 *Processus ayant le rôle de se connecter et garder ouverte une session avec son VirtualCenter (De plus, dans un souci de performances, un cache de description des données de performances est créé).*
25
26 Enfin, ce processus récupère les indicateurs VMWare en créant un sous-processus par demande.
27
28 Centreon-vmware nécessite l'utilisation d'un (ou plusieurs) VirtualCenter (ou ESX).
29
30 Voici un exemple d'architecture éclaté :
31
32 .. image:: ../images/archi.png
33
34 Mode de fonctionnement
35 ----------------------
36
37 Le programme « centreon-vmware » fonctionne uniquement en mode « daemon ». (dans le sens où il ne peut fournir les indicateurs sans l'utilisation d'un client).
38
39 Configuration du connecteur
40 ---------------------------
41
42 Le daemon « centreon-vmware » possède un fichier de configuration « centreon_vmware.pm » de la forme suivante :
43 ::
44
45 %centreon_vmware_config = (
46 vsphere_server => {
47 'default' => {'url' => 'https://vcenter/sdk',
48 'username' => '[email protected]',
49 'password' => 'xxxx'},
50 }
51 );
52
53 L'attribut « vsphere_server » permet de configurer les accès aux différents VirtualCenter.
54 Dans le cas ou il y a plusieurs VirtualCenters, la configuration devient (noter la "," de séparation) :
55 ::
56
57 %centreon_vmware_config = (
58 vsphere_server => {
59 'default' => {'url' => 'https://vcenter/sdk',
60 'username' => '[email protected]',
61 'password' => 'xxxx'},
62 'other' => {'url' => 'https://other_vcenter/sdk',
63 'username' => '[email protected]',
64 'password' => 'xxxx'},
65 }
66 );
67
68 'other' et 'default' sont des containeurs.
69
70 Client Usage
71 ------------
72
73 Vérifie l'état des VMTools des machines virtuelles avec 'prd' dans leur nom:
74 ::
75
76 $ perl centreon_plugins.pl --plugin=apps::vmware::connector::plugin --custommode=connector --connector-hostname=127.0.0.1 --container=default --verbose --mode=tools-vm --display-description --vm-hostname='prd' --filter
77 WARNING: 1 VM with VMTools not installed |
78 vmtools not installed:
79 prd-Reporting - 10.0.0.1 [description xxxx]
80
81 Vérifie les IOPs des machines virtuelles (avec 'centreon-central-1|Formation' dans leur nom. Cela est une expression régulière) sur leurs datastores:
82 ::
83
84 $ perl centreon_plugins.pl --plugin=apps::vmware::connector::plugin --custommode=connector --connector-hostname=127.0.0.1 --container=default --verbose --mode=datastore-vm --vm-hostname='centreon-central-1|Formation' --filter
85 OK: All Datastore IOPS counters are ok | 'riops_Formation-Reporting - 10.30.2.89_R&D-BI'=0.00iops;;;0; 'wiops_Formation-Reporting - 10.30.2.89_R&D-BI'=1.43iops;;;0; 'riops_centreon-central-1_INTEGRATION'=0.00iops;;;0; 'wiops_centreon-central-1_INTEGRATION'=0.60iops;;;0;
86 'Formation-Reporting - 10.30.2.89' read iops on 'R&D-BI' is 0.00
87 'Formation-Reporting - 10.30.2.89' write iops on 'R&D-BI' is 1.43
88 'centreon-central-1' read iops on 'INTEGRATION' is 0.00
89 'centreon-central-1' write iops on 'INTEGRATION' is 0.60
90
91 Vérifie l'état de santé des serveurs ESX:
92 ::
93
94 $ perl centreon_plugins.pl --plugin=apps::vmware::connector::plugin --custommode=connector --connector-hostname=127.0.0.1 --container=default --verbose --mode=health-host --esx-hostname='.*' --filter --disconnect-status='ok'
95 OK: All ESX health checks are ok | 'problems_srvi-clus-esx-n2.merethis.net'=0;;;0;299 'problems_srvi-clus-esx-n1.merethis.net'=0;;;0;299 'problems_srvi-clus-esx-n4.merethis.net'=0;;;0;186 'problems_srvi-clus-esx-n3.merethis.net'=0;;;0;186
96 Checking srvi-clus-esx-n2.merethis.net
97 299 health checks are green
98 Checking srvi-clus-esx-n1.merethis.net
99 299 health checks are green
100 Checking srvi-clus-esx-n4.merethis.net
101 186 health checks are green
102 Checking srvi-clus-esx-n3.merethis.net
103 186 health checks are green
104
105 Troubleshooting
106 ---------------
107
108 Il est possible de retrouver des erreurs de ce type dans les « logs » de « centreon-esxd » :
109 ::
110
111 ...SOAP request error - possibly a protocol issue: read failed: error:1408F119:SSL routines:SSL3_GET_RECORD:decryption failed or bad record mac...
112
113 Le SDK Perl VMWare génère cette erreur de temps en temps mais ne bloque pas le fonctionnement du connecteur. Le bug provient d'OpenSSL. Il devrait être fix dans la version 1.0.1h (CVE-2010-5298).
114
115 Le connecteur peut retourner l'erreur suivante:
116 ::
117
118 # perl centreon_plugins.pl --plugin=apps::vmware::connector::plugin ...
119 Cannot get value for counters...
120
121 Vérifier la synchronisation du temps du VirtualCenter et de ses serveurs ESX. La plupart du temps, le serveur hébergeant le connecteur ou le VirtualCenter/ESX ne sont pas bien synchronisés.