containerized-monitoring/README.md

1.6 KiB

What is this?

Simple container proving munin and monit with msmtp-mta for email notifications

Security Considerations

  • This container does NOT setup SSL
  • This container does NOT setup any kind of proper auth for munin
  • Use a reverse proxy as appropriate for SSL and auth needs
    • Take note of the -p directives in run.sh to ensure each service endpoint is properly proxied
    • It is probably wise to remove the -p directives when using a reverse proxy for access

Container config

  • Create secrets.sh as appropriate, see secrets.sh.example for reference
  • (optoinal) Add -v /var/containerized-monitoring/misc:/opt/misc to run.sh if you want persistent storage for msmtp-mta config
  • (optional) Add -v /var/containerized-monitoring/dashboard:/opt/dashboard to run.sh if you want persistent storage for the simple html dashboard files

Container notes

  • I've included nano (<1Mb package) to facilitate debugging and tuning from directly within the container

Monit

The included a default setup will perform base monitoring of the container (host). You'll want to source m/monit or similar for monitoring more than the local container/machine

Munin

Host config (optional)

pacman -S lm_sensors
sensors-detect # walk through this completely
systemctl enable --now lm_sensors

Notes

  • This will throw errors for 5 minutes (max) at first run due to lack of data, it'll self-correct when the munin cron job runs the first time
  • The web front end for munin will be broken for 5 minutes (max) first run due to the way html rendering works in munin, it'll self-correct when the munin cron job runs the first time