2021-02-13 16:05:42 +00:00
|
|
|
|
|
|
|
|
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
|
|
|
|
|
-------------
|
|
|
|
|
|
2021-02-13 19:15:17 +00:00
|
|
|
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 .
|
