root / plugins / minecraft / jsonapi / README.md @ fb433dc4
Historique | Voir | Annoter | Télécharger (2,3 ko)
| 1 |
# munin-bukkit-plugins |
|---|---|
| 2 |
|
| 3 |
This repository contains some useful [Munin](http://munin-monitoring.org/) plugins to monitor and observe a [Bukkit](http://bukkit.org) server: |
| 4 |
|
| 5 |
* **mcjsonplayers** - players currently online |
| 6 |
* **mcjsonramusage** - RAM usage |
| 7 |
* **mcjsontps** - TPS (ticks per second) |
| 8 |
* **mcsqls2killshostile** - hostile mob kills |
| 9 |
* **mcsqls2killsneutral** - neutral mob kills |
| 10 |
* **mcsqls2killspassive** - passive mob kills |
| 11 |
* **mcsqls2players** - new players per day |
| 12 |
* **mcsqlubshame** - kicks/bans/mutes/etc. per day |
| 13 |
|
| 14 |
mcjson* requires [JSONAPI](https://github.com/alecgorge/jsonapi/) |
| 15 |
mcsqls2* requires [Statistician](http://dev.bukkit.org/server-mods/statisticianv2/) |
| 16 |
mcsqlub* requires [Ultrabans](http://dev.bukkit.org/server-mods/ultrabans/) |
| 17 |
|
| 18 |
Read more in my [blog post](http://blog.frd.mn/munin-bukkit-plugins/). |
| 19 |
|
| 20 |
## Requirements |
| 21 |
|
| 22 |
* Web server with `PHP` support and Munin (2) |
| 23 |
* Bukkit server with JSONAPI for the JSONAPI plugins (`mcjson*`) |
| 24 |
* Bukkit server with Ultrabans for the Ultrabans plugins (`mcsqlub*`) |
| 25 |
* Bukkit server with Statistician for the MySQL plugins (`mcsqls2*`) |
| 26 |
* MySQL server for the SQL plugins |
| 27 |
|
| 28 |
## Configuration |
| 29 |
|
| 30 |
1. Clone this repository: `git clone git@github.com:frdmn/munin-bukkit-plugins.git` |
| 31 |
1. Adjust the JSONAPI variables in the mcjson* files |
| 32 |
1. Adjust the MySQL variables in the mcsql* files |
| 33 |
1. Make sure the `PHP` binary in the Shebang line is executable |
| 34 |
|
| 35 |
## Installation |
| 36 |
|
| 37 |
1. Perform your configuration (see above) |
| 38 |
1. Move the plugins into the Munin plugin directory: `mv mc* /usr/share/munin/plugins/` |
| 39 |
1. Change the ownership: `chown munin:munin /usr/share/munin/plugins/mc*` |
| 40 |
1. Make sure they are exectuable: `chmod 755 /usr/share/munin/plugins/mc*` |
| 41 |
1. Enable the plugins: `ln -s /usr/share/munin/plugins/mc* /etc/munin/plugins/` |
| 42 |
1. Restart your munin-node: `service munin-node restart` |
| 43 |
1. Run your cron: `su - munin --shell=/bin/sh -c /usr/bin/munin-cron` |
| 44 |
|
| 45 |
## Alerts and limits? |
| 46 |
|
| 47 |
To setup alerts and limits add the following lines in your specific node in the `munin.conf` file: |
| 48 |
|
| 49 |
[kotor.yeahwh.at] |
| 50 |
address 5.9.115.5 |
| 51 |
[...] |
| 52 |
mctps_main.warning 19.9: # Warning alert on < 19.9 |
| 53 |
mctps_main.critical 19: # Critical alert on < 19.0 |
| 54 |
mcplayer_main.warning 20 # Warning alert when there are 20 players online |
| 55 |
mcplayer_main.critical 30 # Critical alert when there are more than 30 players online |