mirror of
https://github.com/nicolargo/glances.git
synced 2024-12-22 08:41:32 +03:00
310 lines
10 KiB
Plaintext
310 lines
10 KiB
Plaintext
[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/thing/484466/nicolargoglances-on-GitHub)
|
|
|
|
===========================================
|
|
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 PsUtil pour récupérer les informations de
|
|
votre système. Il est développé en Python.
|
|
|
|
Copie d'écran sur une console:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot.png)
|
|
|
|
Copie d'écran sur un terminal avec une taille importante:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot-wide.png)
|
|
|
|
## Installation
|
|
|
|
Glances a besoin des dépendances suivantes:
|
|
|
|
* Python 2.6+ (non testé avec Python 3+)
|
|
* build-essential (pour installation depuis Pypi et setup.py)
|
|
* python-dev (pour installation depuis Pypi)
|
|
* python-setuptools (pour l'installation via setup.py)
|
|
* python-psutil 0.4.1+ (remplace la librairie libstatgrab)
|
|
* python-jinja2 2.0+ (optionnel seulement pour le module export HTML)
|
|
|
|
### 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 PyPi
|
|
|
|
PyPi est un gestionnaire officiel des paquets Python.
|
|
Il est disponible sous la plupart des distibutions GNU/Linux.
|
|
|
|
On commence par installer PyPi sur son système (par exemple Debian/Ubuntu):
|
|
|
|
$ sudo apt-get update
|
|
$ sudo apt-get install python-pip build-essential python-dev
|
|
|
|
Puis on installe la dernière version de Glances:
|
|
|
|
$ sudo pip install Glances
|
|
|
|
Note: si vous êtes derrière un Proxy alors il faut utiliser
|
|
|
|
$ sudo pip install --proxy=user:password@url:port Glances
|
|
|
|
### Depuis le PPA (Ubuntu/Mint)
|
|
|
|
Arnaud Hartmann maintient un PPA avec la version stable de Glances.
|
|
|
|
Pour installer Glances à partir de ce PPA, il suffit de saisir:
|
|
|
|
$ sudo add-apt-repository ppa:arnaud-hartmann/glances-stable
|
|
$ sudo apt-get update
|
|
$ sudo apt-get install glances
|
|
|
|
Le PPA propose les paquets pour les versions Ubuntu 9.10 jusqu'à 12.04.
|
|
|
|
### Depuis [Homebrew](http://mxcl.github.com/homebrew/) et pat PyPi (pour OS X)
|
|
|
|
$ brew install brew-pip
|
|
$ export PYTHONPATH=$(brew --prefix)/lib/python2.7/site-packages
|
|
$ brew pip Glances
|
|
|
|
### 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:
|
|
|
|
$ rm -rf /tm/nicolargo-glances-*
|
|
$ wget -O /tmp/glances-last.tgz https://github.com/nicolargo/glances/tarball/master
|
|
|
|
Procédez ensuite à l'installation (exemple pour un system Debian):
|
|
|
|
$ sudo apt-get update
|
|
$ sudo apt-get install python-setuptools build-essential python-dev
|
|
$ cd /tmp
|
|
$ tar zxvf glances-last.tgz
|
|
$ cd nicolargo-glances-*
|
|
$ sudo python setup.py install
|
|
|
|
## Lancement de Glances
|
|
|
|
Il suffit de saisir la commande suivante dans une console ou un terminal:
|
|
|
|
$ glances
|
|
|
|
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 -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
|
|
|
|
Vue par défaut:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/cpu.png)
|
|
|
|
Vue si la taille du terminal est suffisante:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/cpu-wide.png)
|
|
|
|
L'état de la CPU est affiché par un pourcentage de l'utilisation globale.
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/percpu.png)
|
|
|
|
Si la taille de la fenêtre est suffisante, Glances affiche les informations
|
|
de CPU par coeur.
|
|
|
|
Les codes couleurs suivant sont utilisés:
|
|
|
|
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
|
|
|
|
Vue par défaut:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/processlist.png)
|
|
|
|
Vue sur grand écran:
|
|
|
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/processlist-wide.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
|