mirror of
https://github.com/nicolargo/glances.git
synced 2024-12-24 09:44:48 +03:00
113 lines
2.6 KiB
ReStructuredText
113 lines
2.6 KiB
ReStructuredText
.. _config:
|
|
|
|
Configuration
|
|
=============
|
|
|
|
No configuration file is mandatory to use Glances.
|
|
|
|
Furthermore a configuration file is needed to access more settings.
|
|
|
|
Location
|
|
--------
|
|
|
|
You can put the ``glances.conf`` file in the following locations:
|
|
|
|
=========== ============================================================
|
|
``Linux`` ~/.config/glances, /etc/glances
|
|
``*BSD`` ~/.config/glances, /usr/local/etc/glances
|
|
``OS X`` ~/Library/Application Support/glances, /usr/local/etc/glances
|
|
``Windows`` %APPDATA%\glances
|
|
=========== ============================================================
|
|
|
|
On Windows XP, the ``%APPDATA%`` path is:
|
|
|
|
::
|
|
|
|
C:\Documents and Settings\<User>\Application Data
|
|
|
|
Since Windows Vista and newer versions:
|
|
|
|
::
|
|
|
|
C:\Users\<User>\AppData\Roaming
|
|
|
|
User-specific options override system-wide options and options given on
|
|
the command line override either.
|
|
|
|
Syntax
|
|
------
|
|
|
|
Glances reads configuration files in the *ini* syntax.
|
|
|
|
A first section (called global) is available:
|
|
|
|
.. code-block:: ini
|
|
|
|
[global]
|
|
# Does Glances should check if a newer version is available on Pypi ?
|
|
check_update=true
|
|
|
|
Each plugin, export module and application monitoring process (AMP) can have a
|
|
section. Below an example for the CPU plugin:
|
|
|
|
.. code-block:: ini
|
|
|
|
[cpu]
|
|
user_careful=50
|
|
user_warning=70
|
|
user_critical=90
|
|
iowait_careful=50
|
|
iowait_warning=70
|
|
iowait_critical=90
|
|
system_careful=50
|
|
system_warning=70
|
|
system_critical=90
|
|
steal_careful=50
|
|
steal_warning=70
|
|
steal_critical=90
|
|
|
|
an InfluxDB export module:
|
|
|
|
.. code-block:: ini
|
|
|
|
[influxdb]
|
|
# Configuration for the --export-influxdb option
|
|
# https://influxdb.com/
|
|
host=localhost
|
|
port=8086
|
|
user=root
|
|
password=root
|
|
db=glances
|
|
prefix=localhost
|
|
#tags=foo:bar,spam:eggs
|
|
|
|
or a NGinx AMP:
|
|
|
|
.. code-block:: ini
|
|
|
|
[amp_nginx]
|
|
# Nginx status page should be enable (https://easyengine.io/tutorials/nginx/status-page/)
|
|
enable=true
|
|
regex=\/usr\/sbin\/nginx
|
|
refresh=60
|
|
one_line=false
|
|
status_url=http://localhost/nginx_status
|
|
|
|
Logging
|
|
-------
|
|
|
|
Glances logs all of its internal messages to a log file.
|
|
|
|
``DEBUG`` messages can been logged using the ``-d`` option on the command
|
|
line.
|
|
|
|
By default, the ``glances.log`` file is under the temporary directory:
|
|
|
|
===================== ==================================================
|
|
``Linux, *BSD, OS X`` /tmp
|
|
``Windows`` %APPDATA%\\Local\\temp
|
|
===================== ==================================================
|
|
|
|
If ``glances.log`` is not writable, a new file will be created and
|
|
returned to the user console.
|