summaryrefslogtreecommitdiffstats
path: root/docs/aoa/fs.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/aoa/fs.rst')
-rw-r--r--docs/aoa/fs.rst55
1 files changed, 55 insertions, 0 deletions
diff --git a/docs/aoa/fs.rst b/docs/aoa/fs.rst
new file mode 100644
index 00000000..1f8bc566
--- /dev/null
+++ b/docs/aoa/fs.rst
@@ -0,0 +1,55 @@
+.. _fs:
+
+File System
+===========
+
+.. image:: ../_static/fs.png
+
+Glances displays the used and total file system disk space. The unit is
+adapted dynamically.
+
+Alerts are set for used disk space.
+
+Legend:
+
+=========== ============
+Disk usage Status
+=========== ============
+``<50%`` ``OK``
+``>50%`` ``CAREFUL``
+``>70%`` ``WARNING``
+``>90%`` ``CRITICAL``
+=========== ============
+
+.. note::
+ Limit values can be overwritten in the configuration file under
+ the ``[filesystem]`` section.
+
+By default, the plugin only displays physical devices (hard disks, USB
+keys). To allow other file system types, you have to enable them in the
+configuration file. For example, if you want to allow the ``zfs`` file
+system:
+
+.. code-block:: ini
+
+ [fs]
+ allow=zfs
+
+Also, you can hide mount points as well (in the following ``/boot``):
+
+.. code-block:: ini
+
+ [fs]
+ hide=/boot.*
+
+RAID
+----
+
+*Availability: Linux*
+
+Thanks to the `pymdstat`_ library, if a ``RAID`` controller is detected
+on you system, its status will be displayed as well:
+
+.. image:: ../_static/raid.png
+
+.. _pymdstat: https://github.com/nicolargo/pymdstat