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.
This repo is archived. You can view files and clone it, but cannot push or open issues/pull-requests.
 
 
Max Mehl c06fd5eca0
remove unused vhost
2 months ago
.drone.yml moved from ansible to docker-compose 10 months ago
.gitignore Initial commit 2 years ago
Dockerfile Make the logging appear in the docker log command 2 years ago
LICENSE Initial commit 2 years ago
README.md change link to repo 2 years ago
check.sh Comment on retry parameters for the curl command [ci skip] 2 years ago
cron.txt Initial commit 2 years ago
docker-compose.yml remove unused vhost 2 months ago
msmtprc fix mailserver 5 months 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