munin-server/README.md

Munin (master)

UNMAINTAINED This repository is not maintained anymore, please use https://github.com/ethersys/ethersys-docker-munin and report issues on it.

Quickstart

Munin stats aggregator and reporting, based on lrivallain (https://github.com/lrivallain) and Arcus (http://arcus.io) work. Update base image (ubuntu 20.04) and munin (2.0.56) and add easily configurable mail and Slack notifications.

Build

git clone https://github.com/occitech/docker.git
docker build -t munin ./munin
docker run -p 80 munin

Or pull

docker pull occitech/munin
docker run -p 80 occitech/munin:latest

How it works

Ports

• 80

Volumes

• /var/lib/munin : Databases files
• /var/log/munin : Logs
• /var/cache/munin : Where are generated graphs

Environment Variables

• NODES: Space separated list of <name>:<host> munin node pairs. (i.e. foo.local:127.0.0.1 bar.remote:1.2.3.4)
• CRONDELAY: Change the cron settings to update charts every X minutes (default: 5)
• TZ: Customize the timezone according to your place: (i.e. Europe/London) (default: Europe/Paris)
• THISNODENAME: Customize the displayed node name for local host (default: munin)
• THISNODEIP: Customize the node IP for local host (default: 127.0.0.1)
• DISABLELOCALNODE: Disable local munin node (default: no)
• MAILCONTACT: Recipient of the mail alert (i.e. alert@example.test, needed for mail alert)
• MAILSERVER: Address of your mail server (i.e. mail.example.test, needed for mail alert)
• MAILPORT: Port of your SMTP mail server (i.e. 25, needed for mail alert)
• MAILUSER: User to Auth on your mail server (i.e. user@example.test, needed for mail alert)
• MAILPASSWORD: Password of your mail server (needed for mail alert)
• MAILFROM: Where the mail seems to come from (i.e. munin@example.test, needed for mail alert)
• MAILNAME: Friendly sender name displayed for recipiend
• MAILDOMAIN: Domain of your mail server (i.e. example.test, needed for mail alert)
• SLACKCHANNEL: Name of your Slack channel (i.e. hosting, needed for Slack alert)
• SLACKWEBHOOKURL: URL of your Slack webhook (i.e. https://hooks.slack.com/services/XXXXX/YYYYYYY/ZZZZZZZ, needed for Slack alert)
• SLACKUSER: Username of munin bot on your Slack
• SLACKICON: Icon of munin bot on your Slack
• VIRTUAL_HOST: FQDN of your munin website

Persistent example

docker run \
 -d \
 --name=munin \
 -p 127.0.0.1:8080:80 \
 -e THISNODENAME="munin.example.com" \
 -e TZ="Europe/London" \
 -e CRONDELAY=2 \
 -e NODES="anothernode.example.com:1.2.3.4 anothernode2.example.com:5.6.7.8" \
 -v /data/munin/db:/var/lib/munin \
 -v /data/munin/logs:/var/log/munin \
 -v /data/munin/cache:/var/cache/munin \
 munin