mirror of
https://github.com/nicolargo/glances.git
synced 2024-12-22 08:41:32 +03:00
361 lines
12 KiB
Plaintext
361 lines
12 KiB
Plaintext
===========================================
|
|
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 (CLI).
|
|
|
|
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:
|
|
|
|
|
|
|
|
Copie d'écran sur un terminal avec une taille importante:
|
|
|
|
|
|
|
|
## 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)
|
|
* pysensors (librairie optionnelle pour les capteurs)
|
|
|
|
### Depuis le gestionnaire de paquet de votre système
|
|
|
|
Des paquets existent pour plusieurs distributions: Debian (SID) 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
|
|
|
|
Si vous rencontrez l'erreur suivante:
|
|
|
|
Error: Failed executing: pip install glances==1.X --install-option=--prefix=/usr/local/XXX/glances/1.X (.rb:)
|
|
This link will help resolve the above errors:
|
|
https://github.com/mxcl/homebrew/wiki/bug-fixing-checklist
|
|
|
|
Essayez de finaliser l'installation avec les commandes:
|
|
|
|
$ pip install glances==1.X --install-option=--prefix=/usr/local/XXX/glances/1.X
|
|
$ brew link Glances
|
|
|
|
### Egalement sur les système Windows
|
|
|
|
Les systèmes Windows sont uniquement supportés en mode serveur. Donc si vous lancez Glances sur une machine Windows, il sera automatiquement lancé en mode serveur.
|
|
|
|
Pour installer Glances sous Windows:
|
|
|
|
* Installer [Python pour Windows](http://www.python.org/getit/)
|
|
* Installer la librairie [PsUtil](https://code.google.com/p/psutil/downloads/list)
|
|
* Télécharger la dernière version de [Glances](https://raw.github.com/nicolargo/glances/master/glances/glances.py)
|
|
|
|
Je cherche des contributeurs pouvant packager Glances pour Windows. Notamment à l'aide de [PyInstaller](http://www.pyinstaller.org/).
|
|
|
|
### 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.py en lieu et place
|
|
de glances.
|
|
|
|
### En mode client/server mode
|
|
|
|
Si vous souhaitez surveiller à distance une machine depuis une autre machine.
|
|
|
|
Il suffit de commencer par lancer Glances en mode serveur sur la machine distante:
|
|
|
|
server$ glances -s
|
|
|
|
Puis de lancer la commande suivante sur votre autre machine:
|
|
|
|
client$ glances -c @server
|
|
|
|
ou @server est l'adresse IP ou le nom d'hôte de la machine distante.
|
|
|
|
Glances utilise un serveur de type [XML/RPC](http://docs.python.org/2/library/simplexmlrpcserver.html) et peut donc être interrogé par des applications tierces.
|
|
|
|
## 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:
|
|
|
|
* 'h' afficher l'aide en ligne
|
|
* 'a' 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
|
|
|
|
* 'b' passer le débit des interfaces réseaux de bit par sec à octet par sec
|
|
* 'c' forcer le tri par consommation CPU
|
|
* 'd' desactiver ou activer l'affichage des entrées/sorties disques
|
|
* 'e' activer ou desactiver l'affichage des capteurs
|
|
* 'f' desactiver ou activer l'affichage de l'occupation des FS
|
|
* 'l' desactiver ou activer l'affichage des logs
|
|
* 'm' forcer le tri par consommation MEMOIRE
|
|
* 'n' desactiver ou activer l'affichage des interfaces réseau
|
|
* 'p' forcer le tri par nom de processus
|
|
* 'w' supprimer les alertes finies de type WARNING
|
|
* 'x' supprimer les alertes finies de type WARNING et CRITICAL
|
|
* '1' passer des stats CPU globale à CPU détaillé
|
|
* '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
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
Vue si la taille du terminal est suffisante:
|
|
|
|
|
|
|
|
L'état de la CPU est affiché par un pourcentage de l'utilisation globale.
|
|
|
|
|
|
|
|
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)
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
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.
|
|
|
|
### Capteur (en option)
|
|
|
|
|
|
|
|
Glances peut afficher les informations sur les capteurs (lm-sensors).
|
|
|
|
Ce module est optionnel et doit être activé avec l'option:
|
|
|
|
glances -e
|
|
|
|
IL nécessite l'installation de la librairie Python pysensors.
|
|
|
|
### Entrées/Sorties disque
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
Vue sur grand écran:
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
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
|
|
|
|
|
|
|
|
Glances y affiche la légende (rappel des codes des couleurs) ainsi que la
|
|
date et l'heure courante.
|
|
|
|
## Traduction
|
|
|
|
Glances existe en Anglais, Francais, Espagnol, Portugais.
|