[WEB/MISC] Minecraft munin v0.2

Minecraft munin - The Minecraft munin link:
Version: v0.2

Requires:
Linux
MCstats2
Munin


Install:
Debian/Ubuntu

In this tutorial I assume that you have MCstats2 install and working properly and that you have root access

If you have an web server and php5 install on your system you can skip this step
This step will install apache2 whit php5 and python whit json

Code:

sudo apt-get install libapache2-mod-php5 python-anyjson

Then install munin

Code:

sudo apt-get install munin

Then download the plugings

Code:

wget http://home.erviker.hackz0r.net/minecraft/zip/minecraft_.zip

Then extract the files

Code:

unzip minecraft_.zip

Symlink MCstats2 stats so the munin plugin can access it ( this will allow make the html file available form the web server )

Code:

sudo ln -s /path/to/minecraft/server/plugins/MCStats2/stats/ /var/www/

edit the files

Code:

 $url="http://127.0.0.1/stats/mcstats.json";  

to where your mcstats.json is hosted

Add the files into folder, in /path/to/munin/plugins/ ( Debian/Ubuntu /usr/share/munin/plugins/ )

Code:

cp minecraft_blocks /usr/share/munin/plugins/
cp minecraft_players /usr/share/munin/plugins/
cp minecraft_blocks_per_type /usr/share/munin/plugins/
cp minecraft_blocks_per_user_destroyed /usr/share/munin/plugins/
cp minecraft_blocks_per_user_placed /usr/share/munin/plugins/
cp minecraft_playtime /usr/share/munin/plugins/

Then symlink the script to /path/to/munin/plugins/that/is/activated/ ( Debian/Ubuntu /etc/munin/plugins/ )

Code:

ln -s /usr/share/munin/plugins/minecraft_blocks /etc/munin/plugins/minecraft_blocks
ln -s /usr/share/munin/plugins/minecraft_players /etc/munin/plugins/minecraft_players
ln -s /usr/share/munin/plugins/minecraft_blocks_per_type /etc/munin/plugins/minecraft_blocks_per_type
ln -s /usr/share/munin/plugins/minecraft_blocks_per_user_destroyed /etc/munin/plugins/minecraft_blocks_per_user_destroyed
ln -s /usr/share/munin/plugins/minecraft_blocks_per_user_placed /etc/munin/plugins/minecraft_blocks_per_user_placed
ln -s /usr/share/munin/plugins/minecraft_playtime /etc/munin/plugins/minecraft_playtime
 

Restart munin

Code:

/etc/init.d/munin-node restart

Finaly allow users to view munin stats
edit /etc/apache2/conf.d/munin
change

Code:

Allow from localhost 127.0.0.0/8 ::1

to

Code:

Allow from all

and restart apache

Code:

/etc/init.d/apache2 restart

the graph will now appear at http://yourserver/munin

Features:

• Making graphs over how many blocks are distroyd and placed
• Making graphs over how many players are online

Download


Change log:
Version 0.2

• more graphs!

Version 0.1

• Making Documentation for forum
• Making the plugin working

TO-DO:

• making the script more dynamic and user friendly
• FIX: reading json larger then 200KB( help??? any one ) itwhas just an error whit the data sett i used for testing
• Setting up/choosing and bug tracker
• Multi server
• MORE GRAPH! MORE GRAPHS!

If you have fixes or request pleas contact me

Munin graphs for minecraft, what a great idea

I <3 munin

me to munin is that shit

Guess I'll work on setting this up today, great idea.. although i thought it wasd MRTG at first.

Can u make this work for windows?

Hi - I can't seem to get this working I know I'm doing something wrong..
I have munin installed and working.. it is accessible via /var/www/munin
My MCstats are also accessible via internet in folder /var/www/stats
So... how do I make munin find those stats? I symlinked the stats folder so that its in /var/www/munin/stats but that isn't adding any charts to munin - i only have the standard charts.

using ubuntu 10.04

EDIT: OK.. nvm.. the minecraft chart is there now... Just had to do ctl-f5 about 4 times - no data though, so I'm assuming I'm not linking the mcstats correctly?

hmmmm.. actually - none of my munin charts have any data..

EDIT2: Ok.. last edit... it appears the numbers are coming now.. i didn't realize munin started counting from date of installation (thought maybe it polled some historical data elsewhere heh...).. Thanks! - so.. appears to be working

you can run the MCstats2 script on windows but munin i dont belive munin can run on windows..

what i recommend is use xampp or something like that to host the mcstats.json
you can run the munin plugin on an other server and edit the $url in the files

Code:

$url="http://my-windows-server/stats/mcstats.json";

I like the third demo a lot! Can't wait for it actually, if you can, please release a dev version of it.

I just released that one!

2 more on the way! later to day!

NOW NEW RELEASE!

oh god i love these type of graphs
btw the editing; it's easier to download on windows or gui based and just opening them instead of using vi / nano and cp'ing them and on CentOS 5 it's the same plugin directory as on ubuntu.

To install munin on centOS 5 (for those who aren't used to yum and rpm's):
http://www.howtoforge.com/server-monitoring-with-munin-and-monit-on-centos-5.2

graphs is the simply epic

Space in your symbolic link:
ln -s /usr/share/munin/plugins/minecraft_blocks _blocks_per_type /etc/munin/plugins/minecraft_blocks_blocks_per_type

Specifics:
blocks _blocks

sorry its
ln -s /usr/share/munin/plugins/minecraft_blocks_per_type /etc/munin/plugins/minecraft_blocks_per_type
its fixt in the main post

http://alfenia.com

Enjoy

Error in minecraft_players, line 37 "playsers"

Btw, the python ones don't work... bug or ?

define don't work
it works here...

Ah, missing module simplejson and json :<

Code:

Traceback (most recent call last):
  File "/etc/munin/plugins/minecraft_playtime", line 3, in ?
    import sys, simplejson, urllib2, re
ImportError: No module named simplejson
2011/03/23-16:12:04 Plugin "minecraft_playtime" exited with status 256. ----
Traceback (most recent call last):
  File "/etc/munin/plugins/minecraft_blocks_per_user_destroyed", line 3, in ?
    import sys, json, urllib2
ImportError: No module named json
2011/03/23-16:12:04 Plugin "minecraft_blocks_per_user_destroyed" exited with status 256. ----

hmmm.. have editetd the file that used simplejson to use json

.....have to add that to apt-get install in the tutorial

but apt-get install python-simpejson to fixit

ahh hilarious, I've been running munin for a while now but will have to try and get this working!

Lightning sucks, sorry to hear that your server went out, do you need a new host?

hehe have allredy got an new one but have to find time to configrue it so will be back online in by to 18.00 it now 11.00 here

Rewrote into cleaner PHP:

PHP:

#!/usr/bin/php  
<?php
/* 
 * Original By Alexander Hansen (alexander@hackz0r.net) - with help from Erviker
 * Rewrote into PHP by Nijikokun <nijikokun@gmail.com>
 */
 
// Configuration
$url = "http://127.0.0.1/stats/mcstats.json";

// Functions
function out($string) {
    print($string . "\n");
}

function objectToArray($object) {
    if( !is_object($object) && !is_array($object) ) { return $object; }
    if( is_object($object) ) { $object = get_object_vars($object); }
    return array_map('objectToArray', $object);
}

function config() {
    out("graph_title Minecraft Blocks");
    out("graph_category Minecraft");
    out("graph_vlabel Blocks");
    out("graph_scale yes");
    out("graph_args --base 1000 -l 0");
    out("destroyed.type GAUGE");
    out("placed.type GAUGE");
    out("destroyed.label Destroyed Blocks");
    out("placed.label Placed Blocks");
}

// Do not edit if you dont know what you are doing
if ((count($argv) > 1) && ($argv[1] == 'config')) {
    config();
    exit();
}

$json = (array) json_decode(file_get_contents($url));

$playerStats = objectToArray($json['playerStats']);

$blocksDestroyed = 0;
$blocksPlaced = 0;

foreach ($playerStats as $tempone) {
    foreach ($tempone as $key => $temptwo)  {
        if ($key == "blocksDestroyed") {
            $blocksDestroyed = $blocksDestroyed + $temptwo;
        }
        
        if ($key == "blocksPlaced") {
            $blocksPlaced = $blocksPlaced + $temptwo;
        }
    }    
}

out('destroyed.value ' . $blocksDestroyed);
out('placed.value ' . $blocksPlaced);

?>

I re-wrote the python ones into php if you would like, since I couldn't get them to work as it kept giving issues with simplejson :/

PHP:

#!/usr/bin/php  
<?php
/* 
 * Original By Alexander Hansen (alexander@hackz0r.net) - with help from Erviker
 * Rewrote into PHP by Nijikokun <nijikokun@gmail.com>
 */
 
// Configuration
$url = "http://127.0.0.1/stats/mcstats.json";

// Functions
function out($string) {
    print($string . "\n");
}

function objectToArray($object) {
    if( !is_object($object) && !is_array($object) ) { return $object; }
    if( is_object($object) ) { $object = get_object_vars($object); }
    return array_map('objectToArray', $object);
}

function config() {
    out("graph_title Total playtime per user");
    out("graph_category Minecraft");
    out("graph_vlabel playtime (seconds)");
    out("graph_args --base 1000 -l 0");
}

function get_data() {
    global $url;
    
    $json = (array) json_decode(file_get_contents($url));
    return objectToArray($json['playerStats']);
}

function data_config() {
    foreach (get_data() as $player) {
        out("playtime_". $player['playerName'] .".type GAUGE");
        out("playtime_". $player['playerName'] .".draw AREASTACK");
        out("playtime_". $player['playerName'] .".label ". $player['playerName']);
    }
}

function data_values() {
    foreach (get_data() as $player) {
        out("playtime_". $player['playerName'] .".value ". $player['totalPlaytimeSeconds']);
    }
}

// Do not edit if you dont know what you are doing
if ((count($argv) > 1) && ($argv[1] == 'config')) {
    config();
    data_config();
    exit();
}

data_values();
?>

nice
i will commit that when im are up and running!
configuring servers atm!

Use github or google code for code source / collab; I have tons of these made

Insightful tip about symbolic links:

Code:

ln -s /usr/share/munin/plugins/minecraft_* /etc/munin/plugins/

Will create one for all matching minecraft_(whatever)

How do I set a different port?

Resolving home.erviker.hackz0r.net... failed: Name or service not known.
wget: unable to resolve host address âhome.erviker.hackz0r.netâ

Your download Link is broken

Forums download!

Ive got a functional debian6, apache and munin - so i tried to setup "minecraft munin"
I followed your manual to setup "minecraft munin".

But its not working atm.
I guess i have to adjust the "/etc/munin/plugin-conf.d/munin-node" file.

But this is not explained by your tutorial.


======================================

PS: ITS NOW WORKING
I had to grant rights for munin in /usr/share/munin/plugins