summaryrefslogtreecommitdiffstats
path: root/README-fr
blob: 1507bb21f49781b1c9bfdcca4894abb852412e16 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
Glances -- Votre système en un coups d'oeil
===========================================

## Description

Glances est un logiciel libre (licence LGPL) permettant de surveiller votre 
système d'exploitation GNU/Linux ou BSD à partir d'une interface texte.

Glances utilise la librairie libstatgrab pour récupérer les informations de 
votre système. Il est développé en Python.

![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot.png)

## Installation

### Depuis le gestionnaire de paquet de votre système

Des paquets existent pour plusieurs distributions: Arch, Fedora/Redhat...
Le processus de packaging est actuellement en cours sur d'autres distribs, je
vous conseille donc de rechercher Glances sur votre gestionnaire de package 
avant de faire une installation depuis les sources.

### Depuis les sources

Le projet Glances est hébergé sur GitHUB: https://github.com/nicolargo/glances

Pour l'installer, il suffit de suivre les instructions suivantes depuis un 
terminal.

Récupération de la dernière version (1.3.7):

	$ wget https://github.com/downloads/nicolargo/glances/glances-1.3.7.tar.gz

Procédez ensuite à l'installation:

	$ tar zxvf glances-1.3.7.tar.gz
	$ cd glances-1.3.7
	$ ./configure
	$ make
	$ sudo make install

Glances a besoin des dépendances suivantes:

* Python 2.6+ (non testé avec Python 3+)
* libstatgrab 0.16+
* python-statgrab 0.5+ (ne marchera PAS avec python-statgrab 0.4)

Notes specifiques pour une installation sous Debian 6.
Debian Squeeze met à disposition la version 0.4 de python-statgrab.
Il faut donc installer la version 0.5 à la main:

	$ sudo apt-get install libstatgrab-dev pkg-config python-dev make
	$ wget http://ftp.uk.i-scream.org/sites/ftp.i-scream.org/pub/i-scream/pystatgrab/pystatgrab-0.5.tar.gz
	$ tar zxvf pystatgrab-0.5.tar.gz
	$ cd pystatgrab-0.5/
	$ ./setup.py build
	$ sudo ./setup.py install

Notes specifiques pour une installation sous Ubuntu 10.04 et 10.10.
Ces versions d'Ubuntu mettent à disposition la version 0.4 de python-statgrab.
Il faut donc installer la version 0.5 à la main:

	$ sudo apt-get update
	$ sudo apt-get install pkg-config build-essential autoconf automake python libstatgrab-dev python-all-dev
	$ sudo apt-get remove python-statgrab
	$ wget http://ftp.uk.i-scream.org/sites/ftp.i-scream.org/pub/i-scream/pystatgrab/pystatgrab-0.5.tar.gz
	$ tar zxvf pystatgrab-0.5.tar.gz
	$ cd pystatgrab-0.5/
	$ ./setup.py build
	$ sudo ./setup.py install

## Lancement de Glances

Il suffit de saisir la commande suivante dans une console ou un terminal:

	$ glances.py

Note: sur certaines distributions, il faut saisir glances en lieu et place 
de glances.py.

## Guide d'utilisation

Par défaut, l'affichage des statistiques est rafraichi toute les secondes.
Il est possible de changer cette valeur en utilisant l'option -t.
Par exemple pour fixer un taux de rafraichissement à 5 secondes:

	$ glances.py -t 5

Les statistiques jugées importantes sont affichées en couleur:

* VERT: la statistique est  "OK"
* BLEU: la statistique est "CAREFUL" (à surveiller)
* VIOLET: la statistique est "WARNING" (en alerte)
* ROUGE: la statistique est "CRITICAL" (critique)

Quand Glances est lancé, il est possible d'utiliser les touches suivantes:

* 'a' pour trier la liste des processus de manière automatique:

    Si la CPU totale > 70% alors le tri se fait pas consommation CPU

    si la mémoire total > 70% alors le tri se fait pas consommation MEMOIRE

* 'c' pour forcer le tri par consommation CPU
* 'd' pour desactiver ou activer l'affichage des entrées/sorties disques
* 'f' pour desactiver ou activer l'affichage de l'occupation des FS
* 'l' pour desactiver ou activer l'affichage des logs
* 'm' pour forcer le tri par consommation MEMOIRE
* 'n' pour desactiver ou activer l'affichage des interfaces réseau
* 'q' sortir de Glances (il est également possible d'utiliser CTRL-C)

Passons ensuite à la description de la fenêtre de Glances:

### En-tête

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/header.png)

L'en-tête montre la version de Glances, le nom de la machine (FQND) ainsi 
qu'une information sur le système d'exploitation (nom, version).

### CPU

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/cpu.png)

L'état de la CPU est affiché par un pourcentage de l'utilisation globale.

Si user|kernel|nice CPU est < 50%, alors le status est "OK".

Si user|kernel|nice CPU est > 50%, alors le status est "CAREFUL".

Si user|kernel|nice CPU est > 70%, alors le status est "WARNING".

Si user|kernel|nice CPU est > 90%, alors le status est "CRITICAL".

### Charge (Load)

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/load.png)

Il est assez difficile de donner une définition claire de la charge d'une 
machine (load average). Sur le blog Nosheep, Zach en donne la définition
suivante: " C'est la somme moyenne du nombre de processus en attente dans
la queue d'execution plus le nombre de processus actuellement en train
d'être executés sur une période de temps de 1, 5 et 15 minutes."

Glances permet d'afficher les alertes en tenant compte du nombre de coeurs de
votre processeur. Par exemple, le seuil WARNING sera de 2 pour un processeur 
Bi-Core alors qu'il sera de 4 sur un Quad-Core.

Si la charge moyenne est < O.7*Core, alors le status est "OK".

Si la charge moyenne est > O.7*Core, alors le status est "CAREFUL".

Si la charge moyenne est > 1*Core, alors le status est "WARNING".

Si la charge moyenne est > 5*Core, alors le status est "CRITICAL".

### Mémoire

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/mem.png)

Glances affiche 3 types d'informations pour la mémoire: RAM, SWAP et réelle.

La mémoire réelle occupée est calculée ainsi = used - cache.

La mémoire réelle libre est calculée ainsi = free + cache.

Les alertes utilisent les seuils suivants:

Si la mémoire est < 50%, alors le status "OK".

Si la mémoire est > 50%, alors le status "CAREFUL".

Si la mémoire est > 70%, alors le status "WARNING".

Si la mémoire est > 90%, alors le status "CRITICAL".

### Débits des interfaces réseau

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/network.png)

Glances affiche les débits des interfaces réseau en adaptant dynamiquement 
l'unité à utiliser (bits par seconde).

Les alertes ne sont affichées que pour les interfaces dont les informations 
sur la vitesse maximale sont disponibles (cela dépend des distributions):

Si le débit < 50%, alors le status est "OK".

Si le débit > 50%, alors le status est "CAREFUL".

Si le débit > 70%, alors le status est "WARNING".

Si le débit > 90%, alors le status est "CRITICAL".

Par exemple, sur une interface Ethernet Fast Ethernet (100 Mbps), le status 
passera à WARNING si le débit dépasse les 70 Mbps.

### Entrées/Sorties disque

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/diskio.png)

Glances permet d'afficher les débits en lecture et écriture sur les disques 
en adaptant dynamiquement l'unité à utiliser (octets par seconde).

Il n'y a pas d'alerte remontée pour ce type d'information.

### Espace sur les systèmes de fichiers

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/fs.png)

Glances affiche par système de fichiers l'espace disque total et utilisé.
L'unité est automatiquement adaptée (octets par seconde).

Les alertes sont remontées sur l'espace disque utilisé:

Si l'espace disque utilisé est < 50%, alors le status est "OK".

Si l'espace disque utilisé est > 50%, alors le status est "CAREFUL".

Si l'espace disque utilisé est > 70%, alors le status est "WARNING".

Si l'espace disque utilisé est > 90%, alors le status est "CRITICAL".

### Les processus

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/processlist.png)

Glances affiche un résumé sur l'état des processus ainsi qu'une liste 
détaillée.

Le nombre des processus affichés est adapté à la taille de la fenêtre.

### Logs

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/logs.png)

Une liste des dernières alertes relevées par Glances est affichée si:

* au moins une alerte de type WARNING ou CRITICAL est arrivée
* la console/fenêtre dispose de la place nécessaire

Glances affiche une ligne par alerte:

* date de début
* date de fin
* description de l'alerte
* valeur (min/moyenne/max) lors de l'alerte

### Pied de page

![screenshot](https://github.com/nicolargo/glances/raw/master/doc/footer.png)

Glances y affiche la légende (rappel des codes des couleurs) ainsi que la
date et l'heure courante.

## Traduction

Pour générer et installer la traduction française executer le script suivant
sous l'utilisateur root ou sudo :
i18n_francais_generate.sh

Pour générer et installer la traduction espagnol executer le script suivant
sous l'utilisateur root ou sudo
i18n_espanol_generate.sh

## A faire...

J'ai besoin de contributeurs pour faire évoluer Glances.

Notamment:

* Packaging pour Debian, Ubuntu, BSD et toutes autres distributions
* Controle de la présence des librairie dans le fichier configure.ac
* Optimisation du code