GoAccess-nginx日志分析工具

GoAccess-nginx日志分析工具

GoAccess 是一款开源、实时,运行在命令行终端下的 Web 日志分析工具。

该工具提供快速、多样的 HTTP 状态统计。

分析结果,可以通过 XShell 等客户端工具查看,并且可以生成 Html 报告。

GitHub 地址:https://github.com/allinurl/goaccess

官网地址:http://goaccess.io/

centos6.x

系统已经安装了LNMP

安装:

#  yum -y install glib2 glib2-devel ncurses ncurses-devel GeoIP GeoIP-devel
#  wget http://tar.goaccess.io/goaccess-1.2.tar.gz
#  tar -xzvf goaccess-1.2.tar.gz
#  cd goaccess-1.2/
#  ./configure --enable-geoip --enable-utf8
#  make && make install

默认配置文件在

# vi /usr/local/etc/goaccess.conf

根据你的日志格式,配置以下参数,这里只需要将 # 去掉即可。

time-format

date-format

log-format

接下来我们测试一下。现在就需要根据nginx的日志格式来写goaccess的规则

# goaccess  -f /usr/local/nginx/logs/access.log -a > /root/test/report.html

第二步:自定义配置

%x 一个匹配时间格式的日期和时间字段和日期格式变量。这是时使用时间戳是给定的日期和时间而不是在两个独立的变量。
%t time字段匹配时间格式的变量。
%d date字段匹配日期格式的变量。
%v The服务器名称根据规范名称设置块(服务器或虚拟主机)。
%e 用户标识的人请求文档由HTTP身份验证。
%h host(客户端IP地址,IPv4和IPv6)
%r 请求从客户端。这需要在请求特定的分隔符(单引号、双引号等)解析。否则,结合使用等特殊格式说明符%m  %U %q 和 %H解析单个字段。注意:使用 %r 得到完整的请求或 %m %U %q 和 %H形成你的请求,不同时使用。请求方法让

%m 请求的方法。
%U 请求URL路径。注意:如果查询字符串在%U,没有必要使用%q。然而,如果URL路径,不包括任何查询字符串,可以使用%q和查询字符串将被附加到请求。

%q 查询字符串。

%H 请求协议。
%s 服务器发送给客户机的状态代码。
%b 服务器发送发送给客户端的大小。
%R 来源
%u 用户代理HTTP请求头。
%D 服务请求的时间,以微秒为单位  $request_time
%T 服务请求的时间,以秒为单位  $request_time
%L 服务请求的时间,以毫秒为单位作为一个十进制数。
%^ 忽略这个领域。
%~ 前进通过日志字符串直到找到(!isspace)字符进行技术改造。
~h 主机(客户端IP地址,IPv4和IPv6)在X-Forwarded-For(XFF)领域。

For XFF, GoAccess uses a special specifier which consists of a tilde before the host specifier, followed by the character(s) that delimit the XFF field, which are enclosed by curly braces (i.e., ~h{,”}).
For example, ~h{,” } is used in order to parse “11.25.11.53, 17.68.33.17” field which is delimited by a double quote, a comma, and a space.
XFF,GoAccess使用特殊说明符由波浪号主机之前,紧随其后的是字符(s)划入XFF字段,由花括号封闭(即~ h { })。
例如,h ~ { }的使用是为了解析”11.25.11.53,17.68.33.17”字段由一个双引号分隔,逗号,和空间。

以上是官方给出的所有匹配参数,原版见
http://www.goaccess.io/man

网络上大部分的文章和介绍都只适合没任何修改的nginx日志格式,对自定义的log format都不怎么涉及。如果你采用的自定义的nginx日志格式,那么此处就需要特别注意,一旦log-format配置不对,goaccess分析的结果会差很大。

以我nginx日志格式为例:

log_format main      '$server_name $remote_addr - $remote_user [$time_local] "$request" $status $body_bytes_sent "$http_referer" "$http_user_agent" "$http_x_forwarded_for" $upstream_addr $request_time $upstream_response_time;

按照goaccess预设的log format,这样的日志是没法分析的,所以我们需要自定义log format。

我的log format为:

log-format %^ %h %^ %^ [%d:%t %^] “%r” %s %b “%R” “%u” “%^” %^ %T %^

为了设置正确的log format,踩了不少坑,先列出来避免大家重复碰到。
(1) log format默认是按照空格分隔日志信息的,所以,对于包含了特殊字符如空格等信息的字段,必须包含在“”里面。如字段request http_user_agent等
(2) nginx日志格式里面,采用空格分隔,但是此处一定注意,只能用一个空格。当时我有个地方用了两个空格,直接导致goaccess结果出错。
(3) nginx日志中的每一个字段都要和log format中的一一对应,如果log format中不需要nginx中的某一个信息,则用%^跳过该信息。
(4) 对于nginx日志中的每一个 – log format都需要一个%^来跳过, 如果是“-”, 则用“%^”
(5) 如果nginx日志信息中有:, 则需要在log format中也显示出来。例如nginx日志中$time_local就包含了:,所以在log format的相应位置也是 [%d:%t %^]


希望这些能帮助使用goaccess的朋友。

亲测成功:

以下是我自定义的nginx日志格式:
log_format  main_zdy  ‘$request_time – IP:$remote_addr – RealIP:$http_x_forwarded_for – [$time_local] $request – $status – $http_user_agent – $host – from:$http_referer’;
记录日志:
0.000 – IP:3.3.3.3 – RealIP:1.1.1.1, 2.2.2.2 – [28/Jul/2017:16:04:15 +0800] POST /site/index.html HTTP/1.1 – 200 – Apache-HttpClient/UNAVAILABLE (java 1.4) – www.111111111.com – from:http://www.111111111.com
0.216 – IP:4.4.4.4 – RealIP:5.5.5.5, 6.6.6.6 – [28/Jul/2017:15:53:04 +0800] GET /client/serverlist?jsonpCallback=jQuery18206177038959697163_1501228347875&gid=163&wid=196&_=1501228353156 HTTP/1.1 – 200 – Mozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/4.0; .NET CLR 2.0.50727) – www.111111111.com – from:http://www.1111111111111.com/

goaccess的格式:

log-format %T %^ IP:%^ %^ RealIP:~h{," } %^ [%d:%t %^] %m %U %H %^ %s %^ %u %^ %^ %^ from:%R

再做定时任务查看

GoAccess-nginx日志分析工具

ps:如果做定时任务的时候需要将错误的信息重定向到文件中,否则会出现goaccess后台卡死的问题

#vi /etc/crontab
#写入定时任务:
#######
#每天,每隔三小时goaccess统计一次日志
#0 1-23/3 * * *  backupall /data/conf/shell/goaccess_xxx.sh

/data/conf/shell/goaccess_xxx.sh文件中:

/usr/local/bin/goaccess -f /data/1.log -a > /data/zabbix/xxxxx/www.xxxxx.com-${today}.html 2> /data/tmp/www.xxxxx.com/err.log

参考:

GoAccess-nginx日志分析工具

nginx 日志分析工具goaccess的使用以及碰到的坑

http://www.goaccess.io/man

上一篇
下一篇