monit-docker 0.0.15

monit-docker

monit-docker project

monit-docker is a free and open-source, we developp it to monitor container status or resources and execute some commands inside containers or manage containers with dockerd, for example:

• reload php-fpm if memory usage is too high
• restart container if status is not running

Quickstart

Using monit-docker in Docker with crond

docker-compose up -d

See docker-compose.yml and MONIT_DOCKER_CRONS environment variable to configure commands.

Commands:

Simple commands

Restart containers with name starts with foo if memory percent > 60% or cpu percent > 90%:

monit-docker monit --name "foo*" --cmd-if 'mem_percent > 60 ? restart' --cmd-if 'cpu_percent > 90 ? restart'

Restart containers with name starts with bar and foo if cpu percent greather than 60% and less than 70%:

monit-docker monit --name "bar*" --name "foo*" --cmd-if '60 > cpu_percent < 70 ? restart'

Restart containers with name starts with bar and status equal to pause or running:

monit-docker monit --name "bar*" --cmd-if 'status in (pause,running) ? restart'

Run command in container with image name contains /php-fpm/ and if memory usage > 100 MiB:

monit-docker --image '*/php-fpm/*' monit --cmd-if 'mem_usage > 100 MiB ? (kill -USR2 1)'

Advanced commands with configuration file or environment variable MONIT_DOCKER_CONFIG

Run commands with aliases declared in configuration file (e.g.: monit-docker.yml.example):

Restart container id 4c01db0b339c if condition alias @status_not_running is true:

monit-docker monit --id 4c01db0b339c --cmd-if '@status_not_running ? restart'

Execute commands alias @start_pause containers with name starts with foo if condition alias @status_not_running is true:

monit-docker monit --name "foo*" --cmd-if '@status_not_running ? @start_pause'

Remove force container group php if status is equal to running:

monit-docker monit --ctn-group php --cmd-if 'status == running ? @remove_force'