mirror of
https://github.com/nicolargo/glances.git
synced 2024-11-25 08:33:22 +03:00
761036985a
This patch introduces a new export method for sending metrics to __Riemann__ server using _TCP_ protocol. The module can be enabled like all the other exports in __Glances__, specifying the `--export-riemann` option. Sending metrics to Riemann requires [bernhard](https://github.com/banjiewen/bernhard) that is the most popular _Riemann client_ written in python. In the configuration file you can only specify the `host` and `port` that riemann is listening for new connections on. Later new options are planned to be added like __SSL__ support and __UDP__. Documentation and manpages are refreshed according to the modifications in the config options and introducing the usage of Riemann export. Signed-off-by: Gergő Nagy <grigori.grant@gmail.com>
418 lines
7.1 KiB
ReStructuredText
418 lines
7.1 KiB
ReStructuredText
.. _cmds:
|
|
|
|
Command Reference
|
|
=================
|
|
|
|
Command-Line Options
|
|
--------------------
|
|
|
|
.. option:: -h, --help
|
|
|
|
show this help message and exit
|
|
|
|
.. option:: -V, --version
|
|
|
|
show program's version number and exit
|
|
|
|
.. option:: -d, --debug
|
|
|
|
enable debug mode
|
|
|
|
.. option:: -C CONF_FILE, --config CONF_FILE
|
|
|
|
path to the configuration file
|
|
|
|
.. option:: -3, --disable-quicklook
|
|
|
|
disable quick look module
|
|
|
|
.. option:: -4, --full-quicklook
|
|
|
|
disable all but quick look and load
|
|
|
|
.. option:: --disable-cpu
|
|
|
|
disable CPU module
|
|
|
|
.. option:: --disable-mem
|
|
|
|
disable memory module
|
|
|
|
.. option:: --disable-swap
|
|
|
|
disable swap module
|
|
|
|
.. option:: --disable-load
|
|
|
|
disable load module
|
|
|
|
.. option:: --disable-network
|
|
|
|
disable network module
|
|
|
|
.. option:: --disable-ip
|
|
|
|
disable IP module
|
|
|
|
.. option:: --disable-diskio
|
|
|
|
disable disk I/O module
|
|
|
|
.. option:: --disable-fs
|
|
|
|
disable filesystem module
|
|
|
|
.. option:: --disable-folder
|
|
|
|
disable folder module
|
|
|
|
.. option:: --disable-sensors
|
|
|
|
disable sensors module
|
|
|
|
.. option:: --disable-hddtemp
|
|
|
|
disable HD temperature module
|
|
|
|
.. option:: --disable-raid
|
|
|
|
disable RAID module
|
|
|
|
.. option:: --disable-docker
|
|
|
|
disable Docker module
|
|
|
|
.. option:: -5, --disable-top
|
|
|
|
disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)
|
|
|
|
.. option:: -2, --disable-left-sidebar
|
|
|
|
disable network, disk I/O, FS and sensors modules (py3sensors lib
|
|
needed)
|
|
|
|
.. option:: --disable-process
|
|
|
|
disable process module
|
|
|
|
.. option:: --disable-log
|
|
|
|
disable log module
|
|
|
|
.. option:: --disable-bold
|
|
|
|
disable bold mode in the terminal
|
|
|
|
.. option:: --disable-bg
|
|
|
|
disable background colors in the terminal
|
|
|
|
.. option:: --enable-process-extended
|
|
|
|
enable extended stats on top process
|
|
|
|
.. option:: --enable-history
|
|
|
|
enable the history mode (matplotlib lib needed)
|
|
|
|
.. option:: --path-history PATH_HISTORY
|
|
|
|
set the export path for graph history
|
|
|
|
.. option:: --export-csv EXPORT_CSV
|
|
|
|
export stats to a CSV file
|
|
|
|
.. option:: --export-influxdb
|
|
|
|
export stats to an InfluxDB server (influxdb lib needed)
|
|
|
|
.. option:: --export-opentsdb
|
|
|
|
export stats to an OpenTSDB server (potsdb lib needed)
|
|
|
|
.. option:: --export-statsd
|
|
|
|
export stats to a StatsD server (statsd lib needed)
|
|
|
|
.. option:: --export-rabbitmq
|
|
|
|
export stats to RabbitMQ broker (pika lib needed)
|
|
|
|
.. option:: --export-riemann
|
|
|
|
export stats to Riemann server (bernhard lib needed)
|
|
|
|
.. option:: --export-elasticsearch
|
|
|
|
export stats to an Elasticsearch server (elasticsearch lib needed)
|
|
|
|
.. option:: -c CLIENT, --client CLIENT
|
|
|
|
connect to a Glances server by IPv4/IPv6 address or hostname
|
|
|
|
.. option:: -s, --server
|
|
|
|
run Glances in server mode
|
|
|
|
.. option:: --browser
|
|
|
|
start the client browser (list of servers)
|
|
|
|
.. option:: --disable-autodiscover
|
|
|
|
disable autodiscover feature
|
|
|
|
.. option:: -p PORT, --port PORT
|
|
|
|
define the client/server TCP port [default: 61209]
|
|
|
|
.. option:: -B BIND_ADDRESS, --bind BIND_ADDRESS
|
|
|
|
bind server to the given IPv4/IPv6 address or hostname
|
|
|
|
.. option:: --username
|
|
|
|
define a client/server username
|
|
|
|
.. option:: --password
|
|
|
|
define a client/server password
|
|
|
|
.. option:: --snmp-community SNMP_COMMUNITY
|
|
|
|
SNMP community
|
|
|
|
.. option:: --snmp-port SNMP_PORT
|
|
|
|
SNMP port
|
|
|
|
.. option:: --snmp-version SNMP_VERSION
|
|
|
|
SNMP version (1, 2c or 3)
|
|
|
|
.. option:: --snmp-user SNMP_USER
|
|
|
|
SNMP username (only for SNMPv3)
|
|
|
|
.. option:: --snmp-auth SNMP_AUTH
|
|
|
|
SNMP authentication key (only for SNMPv3)
|
|
|
|
.. option:: --snmp-force
|
|
|
|
force SNMP mode
|
|
|
|
.. option:: -t TIME, --time TIME
|
|
|
|
set refresh time in seconds [default: 3 sec]
|
|
|
|
.. option:: -w, --webserver
|
|
|
|
run Glances in web server mode (bottle lib needed)
|
|
|
|
.. option:: -q, --quiet
|
|
|
|
do not display the curses interface
|
|
|
|
.. option:: -f PROCESS_FILTER, --process-filter PROCESS_FILTER
|
|
|
|
set the process filter pattern (regular expression)
|
|
|
|
.. option:: --process-short-name
|
|
|
|
force short name for processes name
|
|
|
|
.. option:: -0, --disable-irix
|
|
|
|
task's CPU usage will be divided by the total number of CPUs
|
|
|
|
.. option:: --hide-kernel-threads
|
|
|
|
hide kernel threads in process list
|
|
|
|
.. option:: --tree
|
|
|
|
display processes as a tree
|
|
|
|
.. option:: -b, --byte
|
|
|
|
display network rate in byte per second
|
|
|
|
.. option:: --diskio-show-ramfs
|
|
|
|
show RAM FS in the DiskIO plugin
|
|
|
|
.. option:: --diskio-iops
|
|
|
|
show I/O per second in the DiskIO plugin
|
|
|
|
.. option:: --fahrenheit
|
|
|
|
display temperature in Fahrenheit (default is Celsius)
|
|
|
|
.. option:: -1, --percpu
|
|
|
|
start Glances in per CPU mode
|
|
|
|
.. option:: --fs-free-space
|
|
|
|
display FS free space instead of used
|
|
|
|
.. option:: --theme-white
|
|
|
|
optimize display colors for white background
|
|
|
|
Interactive Commands
|
|
--------------------
|
|
|
|
The following commands (key pressed) are supported while in Glances:
|
|
|
|
``ENTER``
|
|
Set the process filter
|
|
|
|
**Note**: on OS X, please use ``CTRL-H`` to delete
|
|
filter.
|
|
|
|
Filter is a regular expression pattern:
|
|
|
|
- ``gnome``: matches all processes starting with the ``gnome``
|
|
string
|
|
|
|
- ``.*gnome.*``: matches all processes containing the ``gnome``
|
|
string
|
|
|
|
``a``
|
|
Sort process list automatically
|
|
|
|
- If CPU ``>70%``, sort processes by CPU usage
|
|
|
|
- If MEM ``>70%``, sort processes by MEM usage
|
|
|
|
- If CPU iowait ``>60%``, sort processes by I/O read and write
|
|
|
|
``b``
|
|
Switch between bit/s or Byte/s for network I/O
|
|
|
|
``B``
|
|
View disk I/O counters per second
|
|
|
|
``c``
|
|
Sort processes by CPU usage
|
|
|
|
``d``
|
|
Show/hide disk I/O stats
|
|
|
|
``D``
|
|
Enable/disable Docker stats
|
|
|
|
``e``
|
|
Enable/disable top extended stats
|
|
|
|
``E``
|
|
Erase current process filter
|
|
|
|
``f``
|
|
Show/hide file system and folder monitoring stats
|
|
|
|
``F``
|
|
Switch between file system used and free space
|
|
|
|
``g``
|
|
Generate graphs for current history
|
|
|
|
``h``
|
|
Show/hide the help screen
|
|
|
|
``i``
|
|
Sort processes by I/O rate
|
|
|
|
``I``
|
|
Show/hide IP module
|
|
|
|
``l``
|
|
Show/hide log messages
|
|
|
|
``m``
|
|
Sort processes by MEM usage
|
|
|
|
``M``
|
|
Reset processes summary min/max
|
|
|
|
``n``
|
|
Show/hide network stats
|
|
|
|
``p``
|
|
Sort processes by name
|
|
|
|
``q|ESC``
|
|
Quit the current Glances session
|
|
|
|
``r``
|
|
Reset history
|
|
|
|
``R``
|
|
Show/hide RAID plugin
|
|
|
|
``s``
|
|
Show/hide sensors stats
|
|
|
|
``t``
|
|
Sort process by CPU times (TIME+)
|
|
|
|
``T``
|
|
View network I/O as combination
|
|
|
|
``u``
|
|
Sort processes by USER
|
|
|
|
``U``
|
|
View cumulative network I/O
|
|
|
|
``w``
|
|
Delete finished warning log messages
|
|
|
|
``x``
|
|
Delete finished warning and critical log messages
|
|
|
|
``z``
|
|
Show/hide processes stats
|
|
|
|
``0``
|
|
Enable/disable Irix/Solaris mode
|
|
|
|
Task's CPU usage will be divided by the total number of CPUs
|
|
|
|
``1``
|
|
Switch between global CPU and per-CPU stats
|
|
|
|
``2``
|
|
Enable/disable left sidebar
|
|
|
|
``3``
|
|
Enable/disable the quick look module
|
|
|
|
``4``
|
|
Enable/disable all but quick look and load module
|
|
|
|
``5``
|
|
Enable/disable top menu (QuickLook, CPU, MEM, SWAP and LOAD)
|
|
|
|
``/``
|
|
Switch between process command line or command name
|
|
|
|
In the Glances client browser (accessible through the ``--browser``
|
|
command line argument):
|
|
|
|
``ENTER``
|
|
Run the selected server
|
|
|
|
``UP``
|
|
Up in the servers list
|
|
|
|
``DOWN``
|
|
Down in the servers list
|
|
|
|
``q|ESC``
|
|
Quit Glances
|