Skip to content

Latest commit

 

History

History
59 lines (44 loc) · 2.5 KB

README.md

File metadata and controls

59 lines (44 loc) · 2.5 KB
Raw

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