docker-stats-histo/README.md
2021-11-21 12:16:03 +01:00

72 lines
1.7 KiB
Markdown

WIP
===
- [ ] Ajouter parsing des noms
- [ ] tester python avec le cron root et venv
- [ ] Log dans fichier
- [ ] exporter anciennes stats dans JSON
- [ ] mettre en place le nouveau cron
- [ ] ajouter un 2e cron pour la generation du html
- [ ] Date de génération dans la page html
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
----------------------
Open the cron tab in edition mode:
crontab -e
Then add a new line (to run the check each ten minutes)
*/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`.
It can also be a path to a log file.
- No sudo is needed, crontab is called with current user.
Display stats
-------------
This step permits 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 .