muninlite/README.md
2020-02-06 07:29:11 +01:00

4.8 KiB

README for MuninLite

MuninLite is a single Bourne Shell script that implements the Munin protocoll as well as some Linux specific plugins. The motivation for developing MuninLite was to provide a simple Munin Node, using inetd on systems without a full featured Perl and/or bash or a busybox system.

MuninLite is Copyright (C) 2007 Rune Nordbøe Skillingstad rune@skillingstad.no and released under GPLv2 (see LICENSE file)

Features

MuninLite implements the following plugins:

  • df
  • cpu
  • if_
  • if_err_
  • load
  • memory
  • processes
  • swap
  • netstat
  • uptime
  • interrupts
  • irqstats

Included files

  • Changelog: Changelog
  • CREDITS: Credits to contributors
  • LICENSE: GPLv2 License
  • Makefile: Rules to make munin-node
  • README: This file
  • TODO: Things to do in future releases
  • VERSION: Current version
  • munin-node.in: The MuninLite script skeleton
  • examples/xinetd.d/munin: Sample xinetd configuration
  • examples/inetd.conf: Sample inetd.conf configuration
  • examples/inetd.busybox: Sample inetd.conf configuration for busybox
  • examples/hosts.deny: Sample hosts.deny configuration
  • examples/hosts.allow: Sample hosts.allow configuration
  • plugins/cpu: CPU usage plugin
  • plugins/df: Filesystem usage plugin
  • plugins/if_: Network interface traffic plugin
  • plugins/if_err_: Network interface errors plugin
  • plugins/interrupts: Interrupts & context switches plugin
  • plugins/irqstats: Individual interrupts plugin
  • plugins/load: Load average plugin
  • plugins/memory: Memory usage plugin
  • plugins/netstat: Netstat plugin
  • plugins/processes: Number of Processes plugin
  • plugins/swap: Swap in/out plugin
  • plugins/uptime: Uptime plugin

Build requirements

  • Make: not sure what requirements
  • Perl: even very old versions should work

Requirements

  • Bourne Shell: ash or dash should be sufficient
  • grep: simple grep in busybox is sufficient
  • sed: simple sed in busybox is sufficient -- but a bit strange...
  • cut: cut in busybox is sufficient
  • wc: wc in busybox is sufficient
  • xargs: xargs in busybox is sufficient
  • inetd: inetd in busybox is sufficient

Installation

Download source and unpack it. Edit Makefile to suit your choice of plugins

Make munin-node by running "make"

$ make
Making munin-node for muninlite version 0.9.14
Adding plugin df
Adding plugin cpu
Adding plugin if_
Adding plugin if_err_
Adding plugin load
Adding plugin memory
Adding plugin processes
Adding plugin swap
Adding plugin netstat
Adding plugin uptime
Adding plugin interrupts
Adding plugin irqstats

Copy munin-node to a suitable location (/usr/local/bin/) and make it executable (there will be a "make install" at a later release)

cp munin-node /usr/local/bin
chmod +x /usr/local/bin/munin-node

Add munin port to /etc/services:

echo "munin           4949/tcp        lrrd            # Munin" >>/etc/services

Configure inetd or xinetd to fork this script for request on the munin port (4949).

Sample configuration for xinetd is located in examples/xinetd.d/munin:

cp examples/xinetd.d/munin /etc/xinetd.d
killall -HUP xinetd

Sample configuration for inetd is located in examples/inetd.conf:

cat examples/inetd.conf >> /etc/inetd.conf
killall -HUP inetd

Restrict access to munin port using hosts.allow and hosts.deny or add a rule to your favorite firewall config. Examples of hosts.allow/deny settings is provided in the examples directory.

Iptables might be set with something like this:

iptables -A INPUT -p tcp --dport munin --source 10.42.42.25 -j ACCEPT

Test

To test script, just run it (/usr/bin/local/munin-node):

$ /usr/local/bin/munin-node
# munin node at localhost.localdomain
help
# Unknown command. Try list, nodes, config, fetch, version or quit
list
df cpu if_eth0 if_eth1 if_err_eth0 if_err_eth1 load memory
version
munins node on mose.medisin.ntnu.no version: 0.0.5 (munin-lite)
quit

For inetd-test, try to telnet to munin port from allowed host.

# telnet localhost 4949
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
# munin node at localhost.localdomain
help
# Unknown command. Try list, nodes, config, fetch, version or quit
list
df cpu if_eth0 if_eth1 if_err_eth0 if_err_eth1 load memory
version
munins node on mose.medisin.ntnu.no version: 0.0.5 (munin-lite)
quit
Connection closed by foreign host.

Plugin configuration

To configure which plugins should be enabled, locate the PLUGINS variable in munin-node and remove unwanted plugins.

There is no specific configuration for plugins.

Munin configuration

Configure your /etc/munin/munin.conf as you would for a regular munin-node.

[some.host.tld]
    address 10.42.42.25
    use_node_name yes