mirror of
https://github.com/munin-monitoring/contrib.git
synced 2018-11-08 00:59:34 +01:00
43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# munin-bukkit-plugins
|
|
|
|
This repository contains some useful [Munin](http://munin-monitoring.org/) plugins to monitor and observe a [Bukkit](http://bukkit.org) server:
|
|
|
|
* **mcjsonplayers** - players currently online
|
|
* **mcjsonramusage** - RAM usage
|
|
* **mcjsontps** - TPS (ticks per second)
|
|
* **mcsqls2killshostile** - hostile mob kills
|
|
* **mcsqls2killsneutral** - neutral mob kills
|
|
* **mcsqls2killspassive** - passive mob kills
|
|
* **mcsqls2players** - new players per day
|
|
* **mcsqlubshame** - kicks/bans/mutes/etc. per day
|
|
|
|
mcjson* requires [JSONAPI](https://github.com/alecgorge/jsonapi/)
|
|
mcsqls2* requires [Statistician](http://dev.bukkit.org/server-mods/statisticianv2/)
|
|
mcsqlub* requires [Ultrabans](http://dev.bukkit.org/server-mods/ultrabans/)
|
|
|
|
Read more in my [blog post](http://blog.frd.mn/posts/munin-bukkit-plugins/).
|
|
|
|
## Requirements
|
|
|
|
* Web server with `PHP` support and Munin (2)
|
|
* Bukkit server with JSONAPI for the JSONAPI plugins (`mcjson*`)
|
|
* Bukkit server with Ultrabans for the Ultrabans plugins (`mcsqlub*`)
|
|
* Bukkit server with Statistician for the MySQL plugins (`mcsqls2*`)
|
|
* MySQL server for the SQL plugins
|
|
|
|
## Configuration
|
|
|
|
1. Clone this repository: `git clone git@github.com:frdmn/munin-bukkit-plugins.git`
|
|
1. Adjust the JSONAPI variables in the mcjson* files
|
|
1. Adjust the MySQL variables in the mcsql* files
|
|
1. Make sure the `PHP` binary in the Shebang line is executable
|
|
|
|
## Installation
|
|
|
|
1. Perform your configuration (see above)
|
|
1. Move the plugins into the Munin plugin directory: `mv mc* /usr/share/munin/plugins/`
|
|
1. Change the ownership: `chown munin:munin /usr/share/munin/plugins/mc*`
|
|
1. Make sure they are exectuable: `chmod 755 /usr/share/munin/plugins/mc*`
|
|
1. Enable the plugins: `ln -s /usr/share/munin/plugins/mc* /etc/munin/plugins/`
|
|
1. Restart your munin-node: `service munin-node restart`
|
|
1. Run your cron: `su - munin --shell=/bin/sh -c /usr/bin/munin-cron` |