Monitoring tool for docker containers exposed through nginx-proxy
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vincent d6405dd061 Comment on retry parameters for the curl command [ci skip] 1 year ago
.drone.yml Initial commit 1 year ago
.gitignore Initial commit 1 year ago
Dockerfile Make the logging appear in the docker log command 1 year ago
LICENSE Initial commit 1 year ago
README.md change link to repo 1 year ago
check.sh Comment on retry parameters for the curl command [ci skip] 1 year ago
cron.txt Initial commit 1 year ago
msmtprc Initial commit 1 year ago
playbook.yml Initial commit 1 year ago

README.md

Monitoring

The goal of this service is to monitor all services behind the reverse proxy and docker containers in general.

What gets monitored?

A containener is monitored if it meets one of the following criteria:

It has the VIRTUAL_HOST environment variable defined. For example, with the following playbook configuration:

env:
    VIRTUAL_HOST: mailman-confirm.fsfe.org

It has the fsfe-monitoring label. For example, with the following playbook configuration:

labels:
    "fsfe-monitoring": "true"

Checks performed

If the container has the VIRTUAL_HOST environement variable, the following checks are performed:

  • The container is down (status ‘Exited’)
  • The GET to https://VIRTUAL_HOST has a return code == 5xxx

If the container has the fsfe-monitoring:true label, this check is performed:

  • The container is down (status ‘Exited’)

An email is sent if one of those checks is positive.

How it works?

The container is connected to the Docker daemon with the unix socket shared as a read-only volume. Then it uses docker ps to get a list of containers and perform the checks described above.

The container uses msmtp to send send emails with the configuration in msmtprc.

License

This software is copyright 2018 by the Free Software Foundation Europe e.V. and licensed under the GPLv3 license. For details see the “LICENSE” file in the top level directory of https://git.fsfe.org/fsfe-system-hackers/monitoring