Ultra-light docker monitor
=========================

This light tool permits:
 - to export docker container memory usage in a JSON file `stats.json`
 - display curves of the memory usages using the JSON file

The export and the display are two different parts. This allow to run the display in another machine.



Setup the stats export
----------------------

To add it to the cron tab:

	crontab -e

The add new line (to run the check once per hour)

	*/10 * * * * /path.io/docker-stats-histo/save_docker_stats.sh >>/dev/null  2>&1


**Note:**
 - Normaly cron send task outputs (echo) via mail. As the MTA (Mail Transfert Agent), may not be set up,
the crontab line redirect the outputs into `/dev/null`. Can also be a path to a log file.
 - No sudo is needed, crontab is called with current user.


Display stats
-------------

This steps permit to generate a render from a stats file (generated by the script
called by the crontab, see stats export section).

### Install

Need python3 with venv module

    sudo apt install python3 python3-venv

### Run

Go in [display](display) folder

    cd display

Then to generate a png, just run (install is automatically done if needed)
    ./render_stats.sh stats.json

It is also possible to see a web version fo the render :
    ./render_stats.sh stats.json -w

**Note:** if the stats file is in a remote server, one can use `scp` to get it:
    scp alban@eunuque.caracals.org:/path/to/docker-stats-histo/stats.json .