Download Current Version: arlo-1.2.tgz
Version Tracker Listing (Please Leave A Review!)
What is it?
ARLO is a log analyzer, written in perl, that analyzes upload and download log files produced by Carracho.
Carracho is a mac only client/server chat, news, and file transfer software pakage available at http://www.carracho.com/. ARLO reads the server logs, and presents various statistical information to the user.
Features
ARLO can present the following information:
General stats for a user (uploads, downloads, leech rating).
All of the nicknames a user had when they made file transfers.
A list of files uploaded by a particular user.
A list of files downloaded by a particular user.
The leech ratings of all users on the server sorted by rating or by login name.
Server wide stats (uploads, downloads, leech rating, and 4 “top 10” lists.
Search for file uploaders by filename.
Search for file downloaders by filename.
ARLO supports a myriad of command line options. Combine these command line options with an output redirect to file ( the > operator ) and you have a great way to publish your server’s statistics on the web. Combine this with the cron job scheduler and you have a fully automated and customizable server reporter.
ARLO was benchmarked under MacOS X v10.1 running on a 400mhz G3 processor. It was able to analyze ~5MB log file set in 3.67 seconds. This makes ARLO the fastest Carracho log analyzer that I am aware of (feel free to prove me wrong). I also ran the Hotline Log Inspector application on the same logs (it also supports Carracho logs). It took over 40 minutes to parse them. Do the math.
What is a “leech rating”?
A leech rating is calculated as the number of uploads a user had made divided by the user’s download count, that figure multiplied by 100 and then subtracted from 100. This gives a rating of 100% for a user that has never uploaded. The higher the percentage the more of a leech the user is. The leech ratio does not take into account file sizes or a user’s bandwidth, as neither of these things are logged.
Requirements
ARLO should run on any platform with a perl interpreter (in theory). However it is intended for, and has only been tested on, MacOS X.
Starting with version 1.2, ARLO requires the GetOpt perl module. This should have come preinstalled with MacOS X, however, so this should not be an issue.
Installation
All interaction with ARLO is done via the command line (terminal) and it is assumed that the user is comfortable with this.
There are three ways to install this script. The first way is to simply copy the script into the same folder as your Carracho server logs. The second way is to copy the logs into the same directory as the script. The other way is to leave it wherever you want and use command line options (see -uploadslog and -downloadslog) to tell ARLO where to find your server logs.
After that is done, set the permissions of ARLO with the chmod command so that it is executable. For example, “chmod 755 arlo-1.2.pl” will allow anyone to use it.
Using ARLO
To use ARLO open the terminal, move to the directory ARLO is installed in, and run “./arlo-1.2.pl”. Once ARLO is running, the onscreen menu should be self-explanatory.
A reference of command line arguments is available. Please read it all the way through. You’re not getting the most out of ARLO unless you have.
Cost / Distribution
ARLO is free. But an email letting me know what you think would be nice.
Or even better.. How about purchasing some quality name brand discount ski equipmentand when you checkout mention in the comment section that “Phil” sent you, and that he should get a 10 percent commision. 😉
ARLO may be distributed via any method available so long as this readme.txt file is included with it.
Have Fun!
Change Log
1.2
Added non-interactive mode and myriad of command line options.
1.1
Clear screen between actions
Clear screen on quit.
Prompt for username if requesting user specific info and none is chosen.
Provide count of nicknames.
“Press Return Key To Continue” prompt now accepts any key.
Find a file’s uploader(s) by searching for the filename.
Find a file’s downloa(s) by searching for the filename.
Completely overhauled leech ratio math. (Thanks for pushing that, Cheule)
1.0
initial release