Skip to content

goaccess

Analyses web server logs and shows visitors, requested pages, status codes and bandwidth, live in the terminal or as an HTML report.

goaccess output

Syntax

goaccess [OPTION]... [LOGFILE]...

Options

Option Description
--log-format=COMBINED The format of the log, COMBINED for nginx and Apache defaults
-o report.html Write an HTML report instead of the terminal view
--real-time-html Keep the HTML report updated live
- Read the log from standard input, e.g. from zcat
--ignore-crawlers Leave out known bots

Examples

Analyse the access log in the terminal:

sudo goaccess /var/log/nginx/access.log --log-format=COMBINED
  Dashboard - Overall Analyzed Requests (14/Oct/2026 - 26/Oct/2026)            [Active Panel: Visitors]

  Total Requests  1204551 Unique Visitors  18342 Requested Files 2841 Referrers     412
  Valid Requests  1203998 Init. Proc. Time 4s    Static Files    1204 Log Size  4.98 GiB
  Failed Requests 553     Excl. IP Hits    0     Not Found       9012 Bandwidth 38.21 GiB
  Log Source      /var/log/nginx/access.log

  > 2 - Requested Files (URLs)                                         Total: 366/2841

  Hits     h%  Vis.    v%   Tx. Amount Mtd    Proto    Data
  -------- --- ------- ---- ---------- ------ -------- ----
  412318   34% 15204   83%    4.12 GiB GET    HTTP/2.0 /
  204551   17% 12988   71%    1.83 GiB GET    HTTP/2.0 /shop/
  98210     8% 9012    49%  642.10 MiB GET    HTTP/2.0 /shop/cart

Create an HTML report:

sudo goaccess /var/log/nginx/access.log --log-format=COMBINED -o /tmp/report.html
ls -lh /tmp/report.html
-rw-r--r-- 1 root root 612K Oct 26 10:42 /tmp/report.html

Copy the file to your computer, for example with scp, and open it in the browser.

When do I need it?

  • To see which pages are requested how often, without a tracking tool
  • When a site is slow or overloaded: which client or page causes the load?
  • For a quick report for a customer, as an HTML file

Include rotated logs

zcat /var/log/nginx/access.log.*.gz | goaccess --log-format=COMBINED - analyses the compressed old logs as well.

Reports contain IP addresses

The HTML report lists visitors with their IP addresses. Don't put it on a public web server, or use --anonymize-ip.

Distribution differences

Debian Ubuntu RHEL Arch
Package goaccess goaccess from EPEL goaccess

lnav · zcat · awk