Skip to content

munin

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

munin

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