freebsd-munin-plugins/README.md

# freebsd-munin-plugins
A set of FreeBSD specific plugins for Munin

## Requirements
All scripts are written in standard shell language, and `/bin/sh` would be sufficient.
They are tailored and will run on FreeBSD. 
You need to install `lang/gawk` in order to run `intr_` plugin.

## Setup
1. Make sure `sysutils/munin-node` is installed
2. Enable munin-node to run at startup: `sysrc munin_node_enable YES`
2. Clone this repo and copy all scripts to `/usr/local/share/munin/plugins`
3. run `munin-node-configure --suggest` and see if the plugins are detected.
4. run `munin-node-configure --shell | sh -x` to make appropriate symlinks
5. restart munin-node if running: `service munin-node restart`

## Plugins

- **intr_** graphs IRQ and CPU timers, taken from `vmstat -i` output
- **netisr_** graphs per-thread/per-protocol [`netisr(9)`](https://www.freebsd.org/cgi/man.cgi?format=html&query=netisr%289%29) statistics, taken from `netstat -Q`
- **netmem_** graphs [`mbuf(9)`](https://www.freebsd.org/cgi/man.cgi?format=html&query=mbuf%289%29) statistics, taken from `netstat -m`
- **pf_** graphs [`pf(4)`](https://www.freebsd.org/cgi/man.cgi?query=pf&sektion=4&apropos=0) firewall statistics, taken from `pfctl -vsi`
- **udp_** graphs UDP protocol traffic and error statistcs, taken from `netstat -s`
Initial commit 2015-08-12 14:57:50 +04:30			`# freebsd-munin-plugins`
			`A set of FreeBSD specific plugins for Munin`
Update README.md 2015-08-12 15:22:52 +04:30
			`## Requirements`
			All scripts are written in standard shell language, and `/bin/sh` would be sufficient.
			`They are tailored and will run on FreeBSD.`
			You need to install `lang/gawk` in order to run `intr_` plugin.

			`## Setup`
			1. Make sure `sysutils/munin-node` is installed
			2. Enable munin-node to run at startup: `sysrc munin_node_enable YES`
			2. Clone this repo and copy all scripts to `/usr/local/share/munin/plugins`
			3. run `munin-node-configure --suggest` and see if the plugins are detected.
			4. run `munin-node-configure --shell \| sh -x` to make appropriate symlinks
			5. restart munin-node if running: `service munin-node restart`
- describe plugins 2015-08-12 15:38:33 +04:30
			`## Plugins`

			- intr_ graphs IRQ and CPU timers, taken from `vmstat -i` output
			- netisr_ graphs per-thread/per-protocol [`netisr(9)`](https://www.freebsd.org/cgi/man.cgi?format=html&query=netisr%289%29) statistics, taken from `netstat -Q`
			- netmem_ graphs [`mbuf(9)`](https://www.freebsd.org/cgi/man.cgi?format=html&query=mbuf%289%29) statistics, taken from `netstat -m`
			- pf_ graphs [`pf(4)`](https://www.freebsd.org/cgi/man.cgi?query=pf&sektion=4&apropos=0) firewall statistics, taken from `pfctl -vsi`
			- udp_ graphs UDP protocol traffic and error statistcs, taken from `netstat -s`