GoAccess (A Real-Time Apache and Nginx) Web Server Log Analyzer

GoAccess is an interactive and real time web server log analyzer program that quickly analyze and view web server logs. It comes as an open source and runs as a command line in Unix/Linux operating systems. It provides brief and beneficial HTTP (web server) statistics report for Linux administrators on the fly. It also take care of both the Apache and Ngnix web server log formats.

GoAccess parses and analyze the given web server log formats in preferred options including CLF (Common Log Format), W3C format (IIS) and Apache virtual hosts and then generate output of the data to the terminal.

GoAccess Features

It has the following features.

  1. General Statistics, bandwidth etc.
  2. Top Visitors, Visitors Time Distribution, Referring Sites & URLs and 404 or Not Found.
  3. Hosts, Reverse DNS, IP Location.
  4. Operating Systems, Browsers and Spiders.
  5. HTTP Status Codes
  6. Geo Location – Continent/Country/City
  7. Metrics per Virtual Host
  8. Support for HTTP/2 & IPv6
  9. Ability to output JSON and CSV
  10. Incremental log processing and support for large datasets + data persistence
  11. Different Color Schemes

How Do I Install GoAccess?

Presently, the most recent version of GoAccess 0.9.7 is not available from default system package repositories, so to install latest stable version, you need to manually download and compile it from source code under Linux systems as shown:

Install GoAccess from Source

# yum install ncurses-devel glib2-devel geoip-devel
# cd /usr/src
# wget http://tar.goaccess.io/goaccess-0.9.8.tar.gz
# tar zxvf goaccess-0.9.8.tar.gz
# cd goaccess-0.9.8/
# ./configure
# make; make install

Install GoAccess Using Package Manager

The easiest and preferred way to install GoAccess on Linux using the default package manager of your respective Linux distribution.

Note: As I said above, not all distributions will have the most recent version of GoAccess available in the system default repositories..

On RedHat, CentOS and Fedora
# yum install goaccess
# dnf install goaccess    [From Fedora 23+ versions]
On Debian and Ubuntu Systems

GoAccess utility is available since Debian Squeeze 6 and Ubuntu 11.04. To install just run the following command on the terminal.

# apt-get install goaccess

Note: The above command will not always provide you the most latest version. To get the latest stable version of GoAccess, add the official GoAccess Debian & Ubuntu repository as shown:

$ echo "deb http://deb.goaccess.io/ $(lsb_release -cs) main" | sudo tee -a /etc/apt/sources.list.d/goaccess.list
$ wget -O - http://deb.goaccess.io/gnugpg.key | sudo apt-key add -
$ sudo apt-get update
$ sudo apt-get install goaccess

How Do I Use GoAccess?

Once, goaccess is installed, execute ‘goaccess‘ command without any arguments will list the help menu.

# goaccess
Sample Output
GoAccess - 0.9.8

Usage: goaccess [ options ... ] -f log_file [-c][-M][-H][-q][-d][...]
The following options can also be supplied to the command:

Log & Date Format Options

  --log-format=        - Specify log format. Inner quotes need to
                                    be escaped, or use single quotes.
  --date-format=      - Specify log date format. e.g.,
  --time-format=      - Specify log time format. e.g.,

User Interface Options

  -c --config-dialog              - Prompt log/date/time configuration
  -i --hl-header                  - Color highlight active panel.
  -m --with-mouse                 - Enable mouse support on main dashboard.
  --color=<fg:bg[attrs, PANEL]>   - Specify custom colors. See manpage for
                                    more details and options.
  --color-scheme=<1|2>            - Color schemes: 1 => Grey, 2 => Green.
  --html-report-title=     - Set HTML report page title and header.
  --no-color                      - Disable colored output.
  --no-column-names               - Don't write column names in term
  --no-csv-summary                - Disable summary metrics on the CSV
  --no-progress                   - Disable progress metrics.
  --no-tab-scroll                 - Disable scrolling through panels on TAB.

File Options

  -f --log-file=        - Path to input log file.
  -l --debug-file=      - Send all debug messages to the specified
  -p --config-file=     - Custom configuration file.
  --invalid-requests=   - Log invalid requests to the specified
  --no-global-config              - Don't load global configuration

The easiest way to get the any web server statistics use the flag ‘f‘ with input log file name as shown below. The below command will give you general statistics of your web server logs.

# goaccess -f /var/log/httpd/tecmint.com
# goaccess -f /var/log/nginx/tecmint.com

The above command gives you an complete overview of web server metrics by showing summaries of various reports as panels on a one scrollable view as shown.

Apache Logs Overview

View Web Server Apache Logs
View Web Server Apache Logs

Apache Logs by Operating System – Overview

View Apache Logs By Operating System
View Apache Logs By Operating System

Apache Logs by Visitor Bandwidth – Overview

View Apache Visitor Bandwidth Usage
View Apache Visitor Bandwidth Usage

Apache Logs by Web Browser – Overview

View Apache Usage based on Browsers
View Apache Usage based on Browsers

How do I generate Apache HTML report?

To generate an HTML report of your Apache webserver logs, just run it against your web log file.

# goaccess -f /var/log/httpd/access_log > reports.html
Monitor Apache Logs Using Web Browser
GoAccess: Monitor Apache Logs Using Web Browser

For more information and usage please visit http://goaccess.io/.

If you liked this article, then do subscribe to email alerts for Linux tutorials. If you have any questions or doubts? do ask for help in the comments section.

If You Appreciate What We Do Here On TecMint, You Should Consider:

TecMint is the fastest growing and most trusted community site for any kind of Linux Articles, Guides and Books on the web. Millions of people visit TecMint! to search or browse the thousands of published articles available FREELY to all.

If you like what you are reading, please consider buying us a coffee ( or 2 ) as a token of appreciation.

Support Us

We are thankful for your never ending support.

14 thoughts on “GoAccess (A Real-Time Apache and Nginx) Web Server Log Analyzer”

  1. How it can be work in cpanel server, getting below error ?
    #goaccess -f /usr/local/cpanel/logs/access_log

    GoAccess – version 0.9.8 – May 20 2016 13:21:04
    Config file: /usr/local/etc/goaccess.conf

    Fatal error has occurred
    Error occured at: src/parser.c – verify_formats – 2215
    No time format was found on your conf file.

  2. Hi Ravi,

    I am getting the below error, please let me know where i have to make changes and I am not able to find out .goaccessrc file.

    [[email protected] goaccess-0.5]# goaccess -f /var/log/httpd/

    GoAccess – version 0.5 – Oct 16 2015 02:38:28

    An error has occurred
    Error occured at: goaccess.c – render_screens – 239
    Message: Nothing valid to process.

    • @Bheema,
      Change the format as shown in the configuration it should work..

      date_format %d/%b/%Y
      log_format %^, %h %^[%d:%^] "%r" %s %b "%R" "%u"
  3. Hi,

    i’ve installed goaccess on my apache machines.. would it be possible to send notification/alert email from goaccess ? .. if not could you suggest me any product (freeware).

  4. Hi

    Is it possible to parse the logs from remote server ie. if i have apache server running in and logs placed in /var/log/apache.log in the same server .is it possible to watch the stats from go access is installed)

    Please help me

    • Anand, I never tried on the remote machine, but you should give a try, if it works for you then it definitely works others too and don’t forget to post your output here, if you’ve tried.

  5. I had the same issue, however, I configured my log format/date in my: ~/.goaccessrc

    color_scheme 1
    date_format %d/%b/%Y
    log_format %h %^[%d:%^] %^ “%r” %s %b “%R” “%u”

  6. Interesting, but the terminal I use captures F10, which prevents specifying the log format. Log format cannot be specified on the command line either.


Got something to say? Join the discussion.

Have a question or suggestion? Please leave a comment to start the discussion. Please keep in mind that all comments are moderated and your email address will NOT be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.