Role Detail

geerlingguy.munin

Munin monitoring server for RedHat/CentOS or Debian/Ubuntu.
Downloads
776
Type Ansible
Minimum Ansible Version 1.9
Installation $ ansible-galaxy install geerlingguy.munin
Tags
monitoring
system
Last Commit 2017-04-02 15:41:03 PM UTC
Last Imported 2017-04-28 08:51:08 AM UTC
Version History
Version Release Date
1.2.0 2016-09-14 02:12:02 AM
1.1.2 2016-03-11 16:27:04 PM
1.1.1 2016-03-02 21:54:09 PM
1.1.0 2015-10-05 11:30:11 AM
1.0.2 2015-03-02 16:48:04 PM
1.0.1 2014-11-17 15:51:03 PM
1.0.0 2014-05-12 03:32:03 AM
Supported Platforms
Platform Version
Debian etch
Debian jessie
Debian lenny
Debian sid
Debian squeeze
Debian stretch
Debian wheezy
EL 5
EL 6
EL 7
Ubuntu lucid
Ubuntu maverick
Ubuntu natty
Ubuntu oneiric
Ubuntu precise
Ubuntu quantal
Ubuntu raring
Ubuntu saucy
Ubuntu trusty
Ubuntu utopic
Ubuntu vivid
Ubuntu wily
Ubuntu xenial
Ubuntu yakkety
Last 10 Imports
Completed Status
2017-04-28 08:51:08 AM UTC SUCCESS
2017-04-02 05:32:05 AM UTC SUCCESS
2017-01-22 03:22:03 AM UTC SUCCESS
2016-11-23 15:54:03 PM UTC SUCCESS
2016-11-02 20:21:08 PM UTC SUCCESS
2016-09-25 20:35:08 PM UTC SUCCESS
2016-09-14 02:36:02 AM UTC SUCCESS
2016-09-14 02:20:02 AM UTC SUCCESS
2016-09-14 02:18:02 AM UTC SUCCESS
2016-09-14 02:14:02 AM UTC SUCCESS

Ansible Role: Munin

Build Status

Installs munin, a monitoring system, on RedHat/CentOS or Debian/Ubuntu Linux servers.

Requirements

If you are running a RedHat-based distribution, you need to install the EPEL repository, which can be simply installed via the geerlingguy.repo-epel role.

If you would like to view munin's graphs and output via HTTP, you will need an HTTP server like Apache or Nginx running.

Role Variables

Available variables are listed below, along with default values (see defaults/main.yml):

munin_dbdir: /var/lib/munin
munin_htmldir: /var/www/html/munin
munin_logdir: /var/log/munin
munin_rundir: /var/run/munin
munin_includedir: /etc/munin/conf.d

Some default locations for Munin-generated files, configurations, logs, etc.

munin_html_strategy: cron
munin_graph_strategy: cron
munin_max_processes: 12

See the official Munin documentation for munin.conf for more information on these and other optional directives.

munin_cron_job: present

Determines whether the munin cron job (which runs every 5 minutes) should be active. By setting this to absent, you can leave munin installed and configured on your server but effectively disable it. This allows quick enabling or disabling for munin monitoring.

munin_admin_user: munin
munin_admin_password: munin

These values will be used to generate a user via htpasswd under which the munin pages will be password protected with basic HTTP authentication. (Note: This method only works when Munin is running under default Apache configurations; if you use Nginx or a customized Apache server, you will need to configure authentication on your own).

munin_hosts:
  - {
    name: "localhost",
    address: "127.0.0.1",
    extra: ["use_node_name yes"]
  }

A listing of hosts to which munin will connect and monitor. Each item in the list will be added to your munin configuration like the following (assuming you're using the above example):

[localhost]
  address: 127.0.0.1
  use_node_name yes

See documentation for Munin Node Definitions for more details as to what values to use here.

You can enable mail alerts by adding :

munin_alerts:
  - {
    name: "JohnDoe",
    email: "johndoe@example.com",
    subject: "Munin-notification for ${var:group} :: ${var:host}",
    level: "warning critical"
  }

Dependencies

None.

Example Playbook

- hosts: servers
  roles:
    - geerlingguy.munin

License

MIT / BSD

Author Information

This role was created in 2014 by Jeff Geerling, author of Ansible for DevOps.

None