mirror of
https://github.com/nicolargo/glances.git
synced 2024-12-29 20:21:35 +03:00
Excexclude rootfs and autofs
This commit is contained in:
parent
7cde28d62b
commit
b88cfc396a
1
README
1
README
@ -9,6 +9,7 @@ Glances -- Eye on your system
|
|||||||
Glances is a CLI curses based monitoring tool for GNU/Linux and BSD OS.
|
Glances is a CLI curses based monitoring tool for GNU/Linux and BSD OS.
|
||||||
|
|
||||||
Glances uses the PsUtil library to get information from your system.
|
Glances uses the PsUtil library to get information from your system.
|
||||||
|
|
||||||
It is developed in Python.
|
It is developed in Python.
|
||||||
|
|
||||||
![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot.png)
|
![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot.png)
|
||||||
|
252
README.md
Normal file
252
README.md
Normal file
@ -0,0 +1,252 @@
|
|||||||
|
[![Flattr this git repo](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=nicolargo&url=https://github.com/nicolargo/glances&title=Glances&language=&tags=github&category=software)
|
||||||
|
|
||||||
|
=============================
|
||||||
|
Glances -- Eye on your system
|
||||||
|
=============================
|
||||||
|
|
||||||
|
## Description
|
||||||
|
|
||||||
|
Glances is a CLI curses based monitoring tool for GNU/Linux and BSD OS.
|
||||||
|
|
||||||
|
Glances uses the PsUtil library to get information from your system.
|
||||||
|
It is developed in Python.
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/screenshot.png)
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### From package manager (very easy way)
|
||||||
|
|
||||||
|
Packages exist for Arch, Fedora, Redhat, Ubuntu (with PPA), FreeBSD...
|
||||||
|
|
||||||
|
### From PyPi (easy way)
|
||||||
|
|
||||||
|
PyPi is an official Python package manager.
|
||||||
|
|
||||||
|
You first need to install pypi on your system. For exemple on Debian/Ubuntu:
|
||||||
|
|
||||||
|
$ sudo apt-get install python-pip
|
||||||
|
|
||||||
|
Then install the latest Glances version:
|
||||||
|
|
||||||
|
$ sudo pip install glances
|
||||||
|
|
||||||
|
### From source
|
||||||
|
|
||||||
|
Get the latest version:
|
||||||
|
|
||||||
|
$ wget https://github.com/downloads/nicolargo/glances/glances-1.4.tar.gz
|
||||||
|
|
||||||
|
Glances use a standard GNU style installer:
|
||||||
|
|
||||||
|
$ tar zxvf glances-1.4.tar.gz
|
||||||
|
$ cd glances-1.4
|
||||||
|
$ ./configure
|
||||||
|
$ make
|
||||||
|
$ sudo make install
|
||||||
|
|
||||||
|
Pre-requisites:
|
||||||
|
|
||||||
|
* Python 2.6+ (not tested with Python 3+)
|
||||||
|
* psutil 0.4.1+ (did NOT work with psutil < 0.2 )
|
||||||
|
|
||||||
|
Notes: For Debian and Ubuntu < 12.04
|
||||||
|
The officials repos only include the psutil version 0.2.1.
|
||||||
|
You had to install the version 0.4.1 using the following commands:
|
||||||
|
|
||||||
|
$ sudo apt-get install python-dev python-pip
|
||||||
|
$ sudo pip install psutil
|
||||||
|
|
||||||
|
## Running
|
||||||
|
|
||||||
|
Easy:
|
||||||
|
|
||||||
|
$ glances.py
|
||||||
|
|
||||||
|
## User guide
|
||||||
|
|
||||||
|
By default, stats are refreshed every second, to change this setting, you can
|
||||||
|
use the -t option. For exemple to set the refrech rate to 5 seconds:
|
||||||
|
|
||||||
|
$ glances.py -t 5
|
||||||
|
|
||||||
|
Importants stats are colored:
|
||||||
|
|
||||||
|
* GREEN: stat counter is "OK"
|
||||||
|
* BLUE: stat counter is "CAREFUL"
|
||||||
|
* MAGENTA: stat counter is "WARNING"
|
||||||
|
* RED: stat counter is "CRITICAL"
|
||||||
|
|
||||||
|
When Glances is running, you can press:
|
||||||
|
|
||||||
|
* 'h' to display an help message whith the keys you can press
|
||||||
|
* 'a' to set the automatic mode. The processes are sorted automatically
|
||||||
|
|
||||||
|
If CPU > 70%, sort by process "CPU consumption"
|
||||||
|
|
||||||
|
If MEM > 70%, sort by process "memory size"
|
||||||
|
|
||||||
|
* 'c' to sort the processes list by CPU consumption
|
||||||
|
* 'd' Disable or enable the disk IO stats
|
||||||
|
* 'f' Disable or enable the file system stats
|
||||||
|
* 'l' Disable or enable the logs
|
||||||
|
* 'm' to sort the processes list by process size
|
||||||
|
* 'n' Disable or enable the network interfaces stats
|
||||||
|
* 'q' Exit
|
||||||
|
|
||||||
|
### Header
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/header.png)
|
||||||
|
|
||||||
|
The header shows the Glances version, the host name and the operating
|
||||||
|
system name, version and architecture.
|
||||||
|
|
||||||
|
### CPU
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/cpu.png)
|
||||||
|
|
||||||
|
The CPU states are shown as a percentage and for the configured refresh
|
||||||
|
time.
|
||||||
|
|
||||||
|
If user|kernel|nice CPU is < 50%, then status is set to "OK".
|
||||||
|
|
||||||
|
If user|kernel|nice CPU is > 50%, then status is set to "CAREFUL".
|
||||||
|
|
||||||
|
If user|kernel|nice CPU is > 70%, then status is set to "WARNING".
|
||||||
|
|
||||||
|
If user|kernel|nice CPU is > 90%, then status is set to "CRITICAL".
|
||||||
|
|
||||||
|
### Load
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/load.png)
|
||||||
|
|
||||||
|
On the Nosheep blog, Zach defines the average load: "In short it is the
|
||||||
|
average sum of the number of processes waiting in the run-queue plus the
|
||||||
|
number currently executing over 1, 5, and 15 minute time periods."
|
||||||
|
|
||||||
|
Glances gets the number of CPU cores to adapt the alerts. With Glances,
|
||||||
|
alerts on average load are only set on 5 and 15 mins.
|
||||||
|
|
||||||
|
If average load is < O.7*Core, then status is set to "OK".
|
||||||
|
|
||||||
|
If average load is > O.7*Core, then status is set to "CAREFUL".
|
||||||
|
|
||||||
|
If average load is > 1*Core, then status is set to "WARNING".
|
||||||
|
|
||||||
|
If average load is > 5*Core, then status is set to "CRITICAL".
|
||||||
|
|
||||||
|
### Memory
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/mem.png)
|
||||||
|
|
||||||
|
Glances uses tree columns: memory (RAM), swap and "real".
|
||||||
|
|
||||||
|
Real used memory is: used - cache.
|
||||||
|
|
||||||
|
Real free memory is: free + cache.
|
||||||
|
|
||||||
|
With Glances, alerts are only set for on used swap and real memory.
|
||||||
|
|
||||||
|
If memory is < 50%, then status is set to "OK".
|
||||||
|
|
||||||
|
If memory is > 50%, then status is set to "CAREFUL".
|
||||||
|
|
||||||
|
If memory is > 70%, then status is set to "WARNING".
|
||||||
|
|
||||||
|
If memory is > 90%, then status is set to "CRITICAL".
|
||||||
|
|
||||||
|
### Network bit rate
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/network.png)
|
||||||
|
|
||||||
|
Glances display the network interface bit rate. The unit is adapted
|
||||||
|
dynamicaly (bits per second, Kbits per second, Mbits per second...).
|
||||||
|
|
||||||
|
Alerts are set only if the network interface maximum speed is available.
|
||||||
|
|
||||||
|
If bitrate is < 50%, then status is set to "OK".
|
||||||
|
|
||||||
|
If bitrate is > 50%, then status is set to "CAREFUL".
|
||||||
|
|
||||||
|
If bitrate is > 70%, then status is set to "WARNING".
|
||||||
|
|
||||||
|
If bitrate is > 90%, then status is set to "CRITICAL".
|
||||||
|
|
||||||
|
For exemple, on a 100 Mbps Ethernet interface, the warning status is set
|
||||||
|
if the bit rate is higher than 70 Mbps.
|
||||||
|
|
||||||
|
### Disk I/O
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/diskio.png)
|
||||||
|
|
||||||
|
Glances display the disk I/O throughput. The unit is adapted dynamicaly
|
||||||
|
(bytes per second, Kbytes per second, Mbytes per second...).
|
||||||
|
|
||||||
|
There is no alert on this information.
|
||||||
|
|
||||||
|
### Filesystem
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/fs.png)
|
||||||
|
|
||||||
|
Glances display the total and used filesytem disk space. The unit is
|
||||||
|
adapted dynamicaly (bytes per second, Kbytes per second, Mbytes per
|
||||||
|
second...).
|
||||||
|
|
||||||
|
Alerts are set for used disk space:
|
||||||
|
|
||||||
|
If disk used is < 50%, then status is set to "OK".
|
||||||
|
|
||||||
|
If disk used is > 50%, then status is set to "CAREFUL".
|
||||||
|
|
||||||
|
If disk used is > 70%, then status is set to "WARNING".
|
||||||
|
|
||||||
|
If disk used is > 90%, then status is set to "CRITICAL".
|
||||||
|
|
||||||
|
### Processes
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/processlist.png)
|
||||||
|
|
||||||
|
Glances displays a summary and a list of processes.
|
||||||
|
|
||||||
|
By default (or if you hit the 'a' key) the process list is automaticaly
|
||||||
|
sorted by CPU of memory consumption.
|
||||||
|
|
||||||
|
The number of processes in the list is adapted to the screen size.
|
||||||
|
|
||||||
|
### Logs
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/logs.png)
|
||||||
|
|
||||||
|
A logs list is displayed in the bottom of the screen if (an only if):
|
||||||
|
|
||||||
|
* at least one WARNING or CRITICAL alert was occured.
|
||||||
|
* space is available in the bottom of the console/terminal
|
||||||
|
|
||||||
|
There is one line per alert with the following information:
|
||||||
|
|
||||||
|
* start date
|
||||||
|
* end date
|
||||||
|
* alert name
|
||||||
|
* (min/avg/max) values
|
||||||
|
|
||||||
|
### Footer
|
||||||
|
|
||||||
|
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/footer.png)
|
||||||
|
|
||||||
|
Glances displays a caption and the current time/date.
|
||||||
|
|
||||||
|
## Localisation
|
||||||
|
|
||||||
|
To generate french locale execute as root or sudo :
|
||||||
|
i18n_francais_generate.sh
|
||||||
|
|
||||||
|
To generate spanish locale execute as root or sudo :
|
||||||
|
i18n_espanol_generate.sh
|
||||||
|
|
||||||
|
## Todo
|
||||||
|
|
||||||
|
You are welcome to contribute to this software.
|
||||||
|
|
||||||
|
* Packaging for Debian, Ubuntu, BSD...
|
||||||
|
* Check the needed Python library in the configure.ac
|
||||||
|
* Add file system stats when the python-statgrab is corrected
|
@ -22,7 +22,7 @@
|
|||||||
from __future__ import generators
|
from __future__ import generators
|
||||||
|
|
||||||
__appname__ = 'glances'
|
__appname__ = 'glances'
|
||||||
__version__ = "1.4b10"
|
__version__ = "1.4b11"
|
||||||
__author__ = "Nicolas Hennion <nicolas@nicolargo.com>"
|
__author__ = "Nicolas Hennion <nicolas@nicolargo.com>"
|
||||||
__licence__ = "LGPL"
|
__licence__ = "LGPL"
|
||||||
|
|
||||||
@ -279,7 +279,7 @@ class glancesGrabFs():
|
|||||||
|
|
||||||
# Ignore the following fs
|
# Ignore the following fs
|
||||||
ignore_fsname = ('', 'none', 'gvfs-fuse-daemon', 'fusectl', 'cgroup')
|
ignore_fsname = ('', 'none', 'gvfs-fuse-daemon', 'fusectl', 'cgroup')
|
||||||
ignore_fstype = ('binfmt_misc', 'devpts', 'iso9660', 'none', 'proc', 'sysfs', 'usbfs')
|
ignore_fstype = ('binfmt_misc', 'devpts', 'iso9660', 'none', 'proc', 'sysfs', 'usbfs', 'rootfs', 'autofs')
|
||||||
|
|
||||||
# Reset the list
|
# Reset the list
|
||||||
self.fs_list = []
|
self.fs_list = []
|
||||||
|
Loading…
Reference in New Issue
Block a user