Some useful Munin plugins if you run a Bukkit (Minecraft) server with JSONAPI.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
bukkit-jsonapi-players
bukkit-jsonapi-ramusage
bukkit-jsonapi-tps
bukkit-statistician-killshostile
bukkit-statistician-killsneutral
bukkit-statistician-killspassive
bukkit-statistician-players
bukkit-ultrabans-shame

README.md

munin-bukkit-plugins

This repository contains some useful Munin plugins to monitor and observe a Bukkit server:

  • bukkit-jsonapi-players - players currently online
  • bukkit-jsonapi-ramusage - RAM usage
  • bukkit-jsonapi-tps - TPS (ticks per second)
  • bukkit-statistician-killshostile - hostile mob kills
  • bukkit-statistician-killsneutral - neutral mob kills
  • bukkit-statistician-killspassive - passive mob kills
  • bukkit-statistician-players - new players per day
  • bukkit-ultrabans-shame - kicks/bans/mutes/etc. per day

bukkit-jsonapi-* requires JSONAPI
bukkit-statistician-* requires Statistician
bukkit-ultrabans-* requires Ultrabans

Read more in my blog post.

Requirements

  • Web server with PHP support and Munin (2)
  • Bukkit server with JSONAPI for the JSONAPI plugins (bukkit-jsonapi-*)
  • Bukkit server with Ultrabans for the Ultrabans plugins (bukkit-ultrabans-*)
  • Bukkit server with Statistician for the MySQL plugins (bukkit-statistician-*)
  • MySQL server for the SQL plugins

Configuration

  1. Clone this repository: git clone git@github.com:frdmn/munin-bukkit-plugins.git
  2. Adjust the JSONAPI variables in the bukkit-jsonapi-* files
  3. Adjust the MySQL variables in the mcsql* files
  4. Make sure the PHP binary in the Shebang line is executable

Installation

  1. Perform your configuration (see above)
  2. Move the plugins into the Munin plugin directory: mv mc* /usr/share/munin/plugins/
  3. Change the ownership: chown munin:munin /usr/share/munin/plugins/mc*
  4. Make sure they are exectuable: chmod 755 /usr/share/munin/plugins/mc*
  5. Enable the plugins: ln -s /usr/share/munin/plugins/mc* /etc/munin/plugins/
  6. Restart your munin-node: service munin-node restart
  7. Run your cron: su - munin --shell=/bin/sh -c /usr/bin/munin-cron

Alerts and limits?

To setup alerts and limits add the following lines in your specific node in the munin.conf file:

[obi-wan.yeahwh.at]
   address 5.9.115.5
   [...]
   mctps_main.warning 19.9:      # Warning alert on < 19.9
   mctps_main.critical 19:		# Critical alert on < 19.0
   mcplayer_main.warning 20		# Warning alert when there are 20 players online
   mcplayer_main.critical 30		# Critical alert when there are more than 30 players online

License

WTFPL