SARG介绍

SARG的全称是:Squid Analysis Report Generator

SARG是非常好用的Squid日志分析工具,它输出html格式, 可以详细列出每一位用户访问internet的站点信息,排名,连接次数,访问量,访问量等。

软件的主页:http://sarg.sourceforge.net/sarg.php 目前最新的版本是sarg-2.2.7.1.tar.gz

安装

下载了sarg的最新安装包以后,进入下载的目录,执行以下的操作进行安装:

tar zxvf sarg-2.0.3.tar.gz #解压缩安装软件包

cd sarg-2.0.2 #进入解压后的目录,

./configure --prefix=/usr/local/sarg --enable-bindir=/usr/local/sarg/bin

make

make install

cp /usr/local/sarg/bin/sarg /usr/bin/ #sarg的命令拷贝到系统目录中去以后执行sarg就可以不要加路径了。

#安装成功后,在/usr/local/sarg/目录中,有一个配置文件为sarg.conf,我们通过修改配置文件的参数,来达到对日志进行有规则的分析。也可以通过命令行参数实现。

#sarg配置文件的方法和squid配置文件的配置方法类似,只要修改带有关键字的行:

"language english"

    指定网页报告文件的语言类型,很可惜不支持中文网页。

"access_log /var/log/squid/access.log"

    指定squid日志文件绝对路径。

"title "squid 使用报告"

    指定网页标题。

"temporary_dir /var/tmp"

    指定临时文件目录,请确认该目录所在的分区足够大先,1g以上。

"output_dir /var/www/html/sarg"

    指定网页报告文件输出路径。

"topuser_sort_field connect reverse bytes reverse"

    top排序中,指定连接次数(connect),访问字节数(bytes)采用降序排列,升序请使用normal替代reverse

"user_sort_field connect reverse"

    对于每个用户的访问纪录,连接次数按降序排列

"exclude_hosts /usr/local/sarg/norecords"

    指定不计入排序的站点列表文件名为/usr/local/sarg/norecords,对于客户端 访问的这些站点,将不会被top排序中,norecords文件样本:

    google.com

    csdn.net

    microsoft.com

"date_format e"

    启动sarg进程是如果使用日期参数-d时,请使用和配置文件一致的日期格:

    e (europe=dd/mm/yy),

    u (usa=mm/dd/yy),

    w (weekly=yy.ww)

"topuser_fields num date_time userid connect bytes %bytes in-cache-out used_time milisec %time total average"

    指定top排序的域,可以取掉一些不关紧要的域:in-cache-out used_time

"weekdays 1-5"

    指定top排序星期周期为星期一到星期五,0表示星期天

"hours 9-11,13-16"

    指定top排序的时间周期为9:00-11:5913:00-16:59

    至此,sarg.conf文件的配置基本完成了,也可以直接参考附件。

还建立一个存放记录的地方

mkdir /var/www/html/sarg/

mkdir /var/www/html/sarg/daily

mkdir /var/www/html/sarg/weekly

mkdir /var/www/html/sarg/monthly

sarg的命令行解释如下:

   sarg -h

  sarg: usage [options...]

  -a hostname or ip address

  指定不计入排序的主机名称或地址

  -b useragent log

  用户代理日志文件输出

  -c exclude file

  指定不计入排序的站点列表文件名为/usr/local/sarg/norecords,对于客户端访问的这

  些站点,将不会被top排序中

  -d date dd/mm/yyyy-dd/mm/yyyy

  指定日期范围

  -e email address to send reports (stdout for console)

  指定报告接收者邮件

  -f config file (/usr/local/sarg/sarg.conf)

  指定配置文件

  -g date format [e=europe -> dd/mm/yy, u=usa -> mm/dd/yy]

  指定输入的日期格式

  -h help (this...)

  列帮助信息

  -i reports by user and ip address

  指定客户端排序采用用户名或者ip地址

  -l input log

  指定squid日志文件绝对路径。

  -o output dir

  指定网页报告文件输出路径,推荐使用webmaster或其他非admin用户运行

  sarg

  -p use ip address instead userid (reports)

  使用ip地址作为userid

  -w temporary dir

  指定临时文件目录,请确认该目录所在的分区足够大先,1g以上。

运行

    一般来说,我们希望系统可以自动生成报告在sarg的主页上可以找到日//年的自动生成脚本

sarg -d //-// #执行sarg的这个命令就可生成你想要的时间段的上网情况

也可以使用crontab来每日自动执行

首先建立执行脚本分为日、周、月三个文件

vi /usr/local/sarg/bin/daily

内容如下:

#!/bin/bash

#Get yesterday date

YESTERDAY=$(date --date "1 day ago" +%d/%m/%Y)

export LC_ALL=C

/usr/local/sarg/bin/sarg -o /var/www/html/sarg/daily -d $YESTERDAY > /dev/null 2>&1

exit 0

vi /usr/local/sarg/bin/monthyl

内容如下:

#!/bin/bash

#Get yesterday date

YESTERDAY=$(date --date "1 day ago" +%d/%m/%Y)

#Get 1 month ago date

MONTHAGO=$(date --date "1 month ago" +%d/%m/%Y)

/usr/local/sarg/bin/sarg -o /var/www/html/sarg/monthly -d $MONTHAGO-$YESTERDAY  > /dev/null 2>&1

/usr/local/squid/sbin/squid -k rotate

exit 0

vi /usr/local/sarg/bin/weekly

内容如下:

#!/bin/bash

#Generate Access.log for correct weekly reports

cat /var/log/squid/access.log.0 /var/log/squid/access.log > /var/log/squid/access.log.week

#Get yesterday date

YESTERDAY=$(date --date "1 days ago" +%d/%m/%Y)

#Get one week ago date

WEEKAGO=$(date --date "7 days ago" +%d/%m/%Y)

/usr/local/sarg/bin/sarg -l /var/log/squid/access.log.week -o /var/www/html/sarg/weekly -d $WEEKAGO-$YESTERDAY > /dev/null 2>&1

/usr/local/squid/sbin/squid -k rotate

exit 0

然后运行

crontab -e

内容如下:

30 1 * * * /usr/local/sarg/bin/daily

01 0 * * 1 /usr/local/sarg/bin/weekly

01 3 1 * * /usr/local/sarg/bin/monthly

这样在每天都会自动生成一个配置文件来查看

为文件曾加刻执行的权限

chmod 755 /usr/local/sarg/bin/daily

chmod 755 /usr/local/sarg/bin/weekly

chmod 755 /usr/local/sarg/bin/monthly

好了现在你就可以等着第二天一大早来查看你的网络前一天的上网情况。

http://www.bobo365.com/sarg/

汉化

将附件chinese.txt的后缀去掉变为chinese保存在/usr/local/sarg/languages/即可

配置文件实例

sarg.txt改名为sarg.conf并保存在/usr/local/sarg/

所转发的文件均未找到chinese.txt文件。故无法提供内容。