Role Detail

geerlingguy.munin-node

Munin node monitoring endpoint for RedHat/CentOS or Debian/Ubuntu.
Downloads
3039
Type Ansible
Minimum Ansible Version 1.9
Installation $ ansible-galaxy install geerlingguy.munin-node
Tags
monitoring
system
Last Commit 2017-04-02 15:41:03 PM UTC
Last Imported 2017-09-02 15:49:03 PM UTC
Version History
Version Release Date
1.2.0 2016-03-05 17:15:05 PM
1.1.4 2014-11-11 16:37:04 PM
1.1.3 2014-05-12 20:36:08 PM
1.1.2 2014-05-12 02:33:02 AM
1.1.1 2014-05-11 04:55:04 AM
1.1.0 2014-05-11 03:39:03 AM
1.0.2 2014-04-22 17:27:05 PM
1.0.1 2014-04-16 14:06:02 PM
1.0.0 2014-03-17 02:56:02 AM
Supported Platforms
Platform Version
Debian etch
Debian jessie
Debian lenny
Debian sid
Debian squeeze
Debian stretch
Debian wheezy
EL 6
EL 7
Ubuntu artful
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
Ubuntu zesty
Last 10 Imports
Completed Status
2017-09-02 15:49:03 PM UTC SUCCESS
2017-09-02 15:18:03 PM UTC SUCCESS
2017-04-02 05:34:05 AM UTC SUCCESS
2017-03-31 10:56:10 AM UTC SUCCESS
2017-03-22 17:30:05 PM UTC SUCCESS
2017-02-14 14:38:02 PM UTC SUCCESS
2017-02-13 14:49:02 PM UTC SUCCESS
2017-02-10 17:25:05 PM UTC SUCCESS
2017-01-22 03:20:03 AM UTC SUCCESS
2016-11-23 17:39:05 PM UTC SUCCESS

Ansible Role: Munin Node

Build Status

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

Requirements

If using RedHat/CentOS, make sure you have the EPEL repository installed prior to using this role (you can install it using the geerlingguy.repo-epel role).

Role Variables

Available variables are listed below, along with default values:

munin_node_bind_host: "*"
munin_node_bind_port: "4949"

The host and port to which munin-node will bind. Common host options are 127.0.0.1 (localhost), or * (bind to all IP addresses). 4949 is the default Munin port.

munin_node_host_name: ''

Set this explicitly if the munin master doesn't report the correct hostname when telnetting in to munin-node. In most cases, the default should work fine.

munin_node_allowed_ips:
  - '^127\.0\.0\.1$'

A list of IP addresses formatted as a python-style regular expression. Must use single quotes to allow the proper regex escaping to pass through to the configuration file. Hosts with these IP addresses will be allowed to connect to the server and get detailed system stats via munin-node.

Munin Plugin Configuration

You can enable plugins using the munin_node_plugins list, like so:

munin_node_plugins:
  - name: uptime

If the name of the resulting plugin does not match the name of the munin plugin from which it is generated (as is the case, say, with the if_ plugin), you need to add a plugin field to the list item, like so:

munin_node_plugins:
  - name: if_eth0
    plugin: if_

Plugin settings

If you need to add plugin configuration for plugins you've added via munin_node_plugins, you can do so with a simple hashmap that has the plugin name (which will be the [plugin] section in the resulting configuration file), and a list of variable names and values. For example:

munin_node_config: {
  "ps_test": {
    "env.regex": "bash",
    "env.name": "bash"
  }
}

This configuration will generate a configuration file at /etc/munin/plugin-conf.d/ansible.conf with the following contents:

[ps_test]
env.regex bash
env.name bash

Dependencies

None.

Example Playbook

- hosts: servers
  roles:
    - { role: geerlingguy.munin-node }

License

MIT / BSD

Author Information

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

Munin plugin configuration was added by Rafał Trójniak ansible-galaxy@trojniak.net.

None