RAILS LOG ANALYZER
developer version 1 - 08/03/2006
User Guide
 
Launch the application
 
To Launch rails_log_analyzer, double-click on the application icon. This will open the rails_log_analyzer output window (on the right here after) and your default browser window with the application indicating the data is loading.
 
 
If you don’t have Flash Player 9 (PowerPC)
 
If you don’t have the latest Flash Player 9 and are on a PowerPC Macs your browser will display the following
 
Click “Yes” to install the Flash Player 9.
 
If you don’t have Flash Player 9 (Intel)
 
If you don’t have the latest Flash Player 9 version and are on Intel version please goto http://www.adobe.com/products/flashplayer/public_beta/ and follow the instructions to install the Flash Player 9 Beta for OSX intel.  
 
Load your Rails production.log file.
 
Click Then enter the file name with full path in the File name field. I.e. and press the Load button.
Depending on you file size and computer, you may need to be patient. Don't click the cancel or load button again, nor refresh the browser as this would just 'ovrerload' the server. But go to the 'rails_log_analyzer' window and check the output window.
Note that the little progress indicator on the rails_log_analyzer output window, doesn't indicate activity it just running until the application is closed. This is implemented by Platypus the tool I used to wrap the app as an OSX application.  
 
Loading a 20MB log file takes less than one minute on my MacBookPro and 5 minutes on an old PowerBook g4 500 Mhz.
 
When loaded successfully the UI is in data analysis mode. If an error occurred the load file mode with the appropriate error message is displayed.
 
 
Load Geoip data
 
On the data analysis screen the GeoIp graph is empty until you press the button. Same thing, be patient and check the rails_log_analyzer output window. Note, I still dump too much information. When the charts appears, that's it's loaded.
 
 
Period Selection
 
You can use the period selector to query the database with a given time range.
Press 30 and you see the last 30 days. Again be patient wait the graphs are updated. It takes 4 seconds on the MBP and 15 seconds on the old PB. Well, even 4 seconds is a little long...I guess I will have to reorganize and optimize all the queries I perform to retrieve all the data. Note it still provides useful information :-)
 
 
Controller/Action drill down
Click on the Controllers graph to filter the Actions graph:
 
 
Closing the application
To close the application you can press quit on the Dock icons menus:
 
,
You can also press the cancel button in the rails_log_analyzer output window.
Note sometimes you have to kill the application manually if the port is not released.
 
 
That's all there is to it. Have fun with it and provide feedback...the bad and the good.
 
Enjoy,
Daniel.