GoAccess 实时日志监控详解

GoAccess 是一款开源的实时 Web 日志分析器和交互式查看器，能够快速分析服务器日志并以直观的方式呈现结果。以下是关于如何使用 GoAccess 进行实时日志监控的详细介绍：

1. GoAccess 主要特点

• 实时分析：能够实时处理和分析日志文件
• 多种输出格式：支持终端、HTML、JSON 和 CSV 输出
• 低资源消耗：采用 C 语言编写，性能高效
• 支持多种日志格式：Apache、Nginx、Amazon S3、CloudFront 等
• 无需数据库：直接解析日志文件，无需额外依赖

2. 安装 GoAccess

Linux 系统安装

# Ubuntu/Debian
sudo apt-get install goaccess

# CentOS/RHEL
sudo yum install goaccess

# 从源码编译安装
wget https://tar.goaccess.io/goaccess-1.4.tar.gz
tar -xzvf goaccess-1.4.tar.gz
cd goaccess-1.4/
./configure --enable-utf8 --enable-geoip=legacy
make
sudo make install

macOS 安装

brew install goaccess

3. 基本使用方法

实时监控日志文件

goaccess /var/log/nginx/access.log -c

生成 HTML 报告

goaccess /var/log/nginx/access.log -o report.html --log-format=COMBINED --real-time-html

实时 HTML 报告并启动 Web 服务器

goaccess /var/log/nginx/access.log -o /var/www/html/report.html --log-format=COMBINED --real-time-html --daemonize

4. 高级配置

配置文件 (~/.goaccessrc)

可以配置日志格式、忽略特定请求等：

time-format %H:%M:%S
date-format %d/%b/%Y
log-format %h %^[%d:%t %^] "%r" %s %b "%R" "%u"

常用参数

• --log-format=COMBINED：指定日志格式
• --real-time-html：启用实时 HTML 报告
• --daemonize：以守护进程模式运行
• --port=7890：指定实时 HTML 报告的端口
• --ws-url=wss://yourdomain.com：指定 WebSocket URL
• --ignore-crawlers：忽略爬虫请求
• --exclude-ip=192.168.0.1：排除特定 IP

5. 实时监控 Nginx 日志示例

goaccess /var/log/nginx/access.log \
  --log-format=COMBINED \
  --real-time-html \
  --port=7890 \
  --output=/var/www/html/report.html \
  --daemonize

然后可以通过浏览器访问 http://your-server-ip:7890/report.html 查看实时报告。

6. 监控多个日志文件

# 合并多个日志文件
zcat /var/log/nginx/access.log.*.gz | goaccess -a -o report.html

# 监控多个实时日志
tail -f /var/log/nginx/access.log /var/log/nginx/access.log.1 | goaccess -

7. 集成到 Web 服务器

可以将生成的 HTML 报告集成到现有 Web 服务器中：

1. 生成报告到 Web 目录
2. 配置 Web 服务器提供静态文件服务
3. 设置定时任务或守护进程保持实时更新

8. 安全考虑

• 限制对实时报告的访问（IP 限制、密码保护）
• 不要在生产环境使用默认端口
• 考虑使用 HTTPS 加密通信

9. 常见问题解决

日志格式不匹配

使用 --debug 参数调试日志格式问题：

goaccess /var/log/nginx/access.log --debug

实时 HTML 报告不更新

确保： 1. WebSocket 连接正常 2. GoAccess 进程正在运行 3. 防火墙允许指定端口通信

GoAccess 是一个功能强大且高效的日志分析工具，特别适合需要实时监控 Web 服务器访问情况的环境。通过合理配置，可以快速搭建一个实时的访问统计和分析平台。