glances/docs/aoa/memory.rst

71 lines
2.5 KiB
ReStructuredText
Raw Normal View History

2016-03-02 15:29:19 +03:00
.. _memory:
Memory
======
Glances uses two columns: one for the ``RAM`` and one for the ``SWAP``.
.. image:: ../_static/mem.png
If enough space is available, Glances displays extended information for
the ``RAM``:
.. image:: ../_static/mem-wide.png
2019-10-13 12:18:00 +03:00
Stats description:
- **percent**: the percentage usage calculated as (total-available)/total*100.
- **total**: total physical memory available.
- **used**: memory used, calculated differently depending on the platform and
designed for informational purposes only.
It's compute as following:
used memory = total - free (with free = available + buffers + cached)
2019-10-13 12:18:00 +03:00
- **free**: memory not being used at all (zeroed) that is readily available;
note that this doesnt reflect the actual memory available (use available
instead).
- **active**: (UNIX): memory currently in use or very recently used, and so it
is in RAM.
- **inactive**: (UNIX): memory that is marked as not used.
- **buffers**: (Linux, BSD): cache for things like file system metadata.
- **cached**: (Linux, BSD): cache for various things.
Additional stats available in through the API:
- **available**: the actual amount of available memory that can be given
instantly to processes that request more memory in bytes; this is calculated
by summing different memory values depending on the platform (e.g. free +
buffers + cached on Linux) and it is supposed to be used to monitor actual
memory usage in a cross platform fashion.
- **wired**: (BSD, macOS): memory that is marked to always stay in RAM. It is
never moved to disk.
- **shared**: (BSD): memory that may be simultaneously accessed by multiple
processes.
2017-05-08 10:46:40 +03:00
A character is also displayed just after the MEM header and shows the
trend value:
======== ==============================================================
Trend Status
======== ==============================================================
``-`` Mean 15 lasts values equal mean 15 previous values
```` Mean 15 lasts values is lower mean 15 previous values
```` Mean 15 lasts values is higher mean 15 previous valuess
2017-05-08 10:46:40 +03:00
======== ==============================================================
2016-03-02 15:29:19 +03:00
Alerts are only set for used memory and used swap.
Legend:
======== ============
RAM/Swap Status
======== ============
``<50%`` ``OK``
``>50%`` ``CAREFUL``
``>70%`` ``WARNING``
``>90%`` ``CRITICAL``
======== ============
.. note::
Limit values can be overwritten in the configuration file under
the ``[memory]`` and/or ``[memswap]`` sections.