summaryrefslogtreecommitdiffstats
path: root/docs/aoa/folders.rst
blob: 5245c9d1fb21f73ea7eb4d39e726b58bc0055133 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
.. _folders:

Folders
=======

The folders plugin allows user, through the configuration file, to
monitor size of a predefined folders list.

.. image:: ../_static/folders.png

If the size can not be computed (non existing folder, read right error), a '?' is displayed.

Each item is defined by:

- ``path``: absolute path to monitor (mandatory)
- ``careful``: optional careful threshold (in MB)
- ``warning``: optional warning threshold (in MB)
- ``critical``: optional critical threshold (in MB)

Up to ``10`` items can be defined.

For example, if you want to monitor the ``/tmp`` folder, the following
definition should do the job:

.. code-block:: ini

    [folders]
    folder_1_path=/tmp
    folder_1_careful=2500
    folder_1_warning=3000
    folder_1_critical=3500

In client/server mode, the list is defined on the ``server`` side.

.. warning::
    Do **NOT** define folders containing lot of files and subfolders.