How do I run it?

First, you should install PerformanceMonster on your system.

Running PerformanceMonster

Open a command prompt, go to your PerformanceMonster installation directory, run "performancemonster.sh" (Unix/Linux) or "performancemonster.bat" (Windows). If it doesn't work "out of the box", you might need to edit the startup script to point to the correct Java Runtime Environment (version 6 or newer required).

Running a test program

There's also a tiny test program included. To test Performance Monster, you should first define a log4j configuration file, like this:

log4j.rootLogger=DEBUG, PERFORMANCE_MONSTER

log4j.appender.PERFORMANCE_MONSTER=performancemonster.loghandler.MonsterAppender
log4j.appender.PERFORMANCE_MONSTER.RemoteHost=localhost
log4j.appender.PERFORMANCE_MONSTER.Port=4446
log4j.appender.PERFORMANCE_MONSTER.ReconnectionDelay=10

Save this to a file called "perfmonster.configuration". Then start the test program by typing

java -cp ./lib/*:./performancemonster.jar:./performancemonster-log4j.jar -Dlog4j.configuration=file:///(path)/perfmonster.configuration perfmonstertest.LogGeneratorWithInstrumentation

Clicking the buttons in the window of the test program will send log information to PerformanceMonster.