1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
FISG - Fast IRC Stats Generator
===============================
Word of warning
===============
FISG is _not_ a drop-in replacement for PISG. Please don't expect
it to be or expect that it will become one. It won't.
Introduction
============
If you know PISG (Perl IRC Statistics Generator, http://pisg.sf.net/),
then you know what FISG is (mostly) about. It all started with big IRC
logfiles (40 - 100MB) and PISG, which is quite nice in what it does.
But the problem for me was that PISG does it so SLOW and takes lots
of memory, ~100M or more for ~30M logs.
Also, PISG did somewhat more than I really needed, like the useless
"most used word"-stats. What I really wanted, was a FAST and light
analyzer for IRC logs - in 1 day, core of FISG was written and it
proved to be lot faster than PISG.
Downside of FISG is the lack of some features and it currently supports
just few logfile formats. In most cases you can specify new formats
yourself, though, so it's not too big problem.
If you want speed and less RAM usage, at cost of some features - choose
FISG. If you need the features, don't mind about bloatness and have Perl
installed, try PISG.
Usage
=====
After installation (see INSTALL), basic usage is quite simple if you
are familiar with commandline.
First step is to use your favorite editor to create configuration
and user-files for the channel you want to have the statistics for.
After that, you need to run FISG, specifying the configuration and
logfiles.
For example, if you have log for channel #kewlchan produced by Irssi
in directory "~/irclogs/IRCNet/" (aka under your home directory),
you could use the following:
./fisg -c kewlchan.cfg ~/irclogs/IRCNet/#kewlchan.log -o kewlstats.html
Simple enough. If there are multiple logfiles, you need to specify all.
Under UNIX you might want to use find(1) -command, for example:
./fisg -c kewlchan.cfg `find ~/irclogs -iname "*kewlchan.*"` -o kewlstats.html
"Irssi" is the default format used by FISG. If your logs are in some
other format, you need to specify it:
./fisg -f eggdrop -c ...
In some cases you may have many logfiles of different formats, but
we can handle them all. All files given after "-f" option are interpreted
as the given format. Example:
./fisg -f eggdrop ~/mybot/logs/kewlchan.* -f irssi ~/irclogs/IRCnet/#kewlchan.log
For more information, read FISG's commandline help (fisg --help), the example
configuration- and user-files (example.cfg and users.cfg) and the FAQ.
License
=======
FISG is distributed under GNU General Public License version 2,
see COPYING for more information.
If you like FISG, you can thank me by distributing message
about it's existence and voting it on freshmeat.net (search for FISG)
Also, try out XMMS-SID plugin if you are interested in SID-music
(c64 music) and use XMMS player.
Contact
=======
For suggestions, bug-reports, etc.
e-mail: ccr@tnsp.org
New versions will be available from FISG's homepage:
http://www.tnsp.org/fisg.php
FISG on freshmeat.net:
http://freshmeat.net/projects/fisg
---------------------------
Have fun! - ccr/TNSP ' 2003
|
