/docker-munin-server

Docker container for munin using nginx/fastcgi and configurable notifications

Primary LanguageDockerfileGNU General Public License v3.0GPL-3.0

Docker image for munin server

Configuration

All the configuration is done through the environment.

HTTP Credentials

These are the credentials used to authenticate the HTTP dashboard; both take a space-delimited list

  • MUNIN_USERS
  • MUNIN_PASSWORDS

SMTP info for alerts

Email credentials used to send emails (like alerts)

  • SMTP_HOST - Host to send emails through
  • SMTP_PORT - Port to use on SMTP_HOST - default: 25
  • SMTP_USERNAME - Enables Authentication
  • SMTP_PASSWORD - Password for Authentication
  • SMTP_USE_TLS - Enables SSL/TLS on SMTP_PORT to SMTP_HOST
  • SMTP_ALWAYS_SEND - Sends all munin alerts

Alert target

Email addressed used for the alerts, requires at munimum SMTP_HOST to be set.

  • ALERT_RECIPIENT
  • ALERT_SENDER

List of the nodes to check

The port is always optional, default is 4949

  • NODES format: name1:ip1[:port1] name2:ip2[:port2] …
  • SNMP_NODES format: name1:ip1[:port1] …
  • SSH_NODES format: name1:ip1[:port1] …

Port

Container is listening on the port 8080

Volumes

For a bit of persistency

  • /var/log/munin -> logs
  • /var/lib/munin -> db
  • /var/cache/munin -> file deserved by HTTP

How to use the image

docker run -d \
  -p 8080:80 \
  -v /var/log/munin:/var/log/munin \
  -v /var/lib/munin:/var/lib/munin \
  -v /var/cache/munin:/var/cache/munin \
  -e MUNIN_USERS='username1 username2' \
  -e MUNIN_PASSWORDS='passwordi1 password2' \
  -e SMTP_HOST=smtp.example.com \
  -e SMTP_PORT=587 \
  -e SMTP_USERNAME=smtp-username \
  -e SMTP_PASSWORD=smtp-password \
  -e SMTP_USE_TLS=false \
  -e SMTP_ALWAYS_SEND=true \
  -e ALERT_RECIPIENT=monitoring@example.com \
  -e ALERT_SENDER=alerts@example.com \
  -e NODES="server1:10.0.0.1 server2:10.0.0.2" \
  -e SNMP_NODES="router1:10.0.0.254:9999" \
  lpsrocks/munin-server

You can now reach your munin-server on port 8080 of your host. It will display an error until munin is run for the first time.

Every 5 minutes munin-server will interrogate its nodes and build the graphs and store the data. That's only after the first data fetching operation that the first graphs will appear.