Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Scalingo/docker-munin-server
Dockerization of a munin server behind nginx
https://github.com/Scalingo/docker-munin-server
Last synced: 3 months ago
JSON representation
Dockerization of a munin server behind nginx
- Host: GitHub
- URL: https://github.com/Scalingo/docker-munin-server
- Owner: Scalingo
- Archived: true
- Created: 2015-04-30T20:20:47.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2020-06-18T00:09:22.000Z (over 4 years ago)
- Last Synced: 2024-07-29T13:35:01.792Z (5 months ago)
- Language: Shell
- Size: 15.6 KB
- Stars: 46
- Watchers: 9
- Forks: 41
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
Awesome Lists containing this project
README
# 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`
* `SMTP_PORT`
* `SMTP_USERNAME`
* `SMTP_PASSWORD`
* `SMTP_USE_TLS`
* `SMTP_ALWAYS_SEND`
* `SMTP_MESSAGE`### Alert target
Email addressed used for the alerts, require SMTP credentials.
* `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/run/munin -> lock and pid files
* /var/cache/munin -> file deserved by HTTP## How to use the image
```
docker build -t munin-server .
docker run -d \
-p 8080:8080 \
-v /var/log/munin:/var/log/munin \
-v /var/lib/munin:/var/lib/munin \
-v /var/run/munin:/var/run/munin \
-v /var/cache/munin:/var/cache/munin \
-e MUNIN_USERS='http-user another-user' \
-e MUNIN_PASSWORDS='secret-password other-users-password' \
-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 SMTP_MESSAGE='[${var:group};${var:host}] -> ${var:graph_title} -> warnings: ${loop<,>:wfields ${var:label}=${var:value}} / criticals: ${loop<,>:cfields ${var:label}=${var:value}}' \
-e [email protected] \
-e [email protected] \
-e NODES="server1:10.0.0.1 server2:10.0.0.2" \
-e SNMP_NODES="router1:10.0.0.254:9999" \
munin-server
```You can now reach your munin-server on port 8080 of your host. It will display at the first run:
```
Munin has not run yet. Please try again in a few moments.
```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.