monitoring goaccess web bash

What is it?

GoAccess is an open source real-time web log analyzer and interactive viewer that runs in a terminal in *nix systems or through your browser.

It provides fast and valuable HTTP statistics for system administrators that require a visual server report on the fly.


GoAccess parses the specified web log file and outputs the data to the X terminal. Features include:

  • Completely Real Time All panels and metrics are timed to be updated every 200 ms on the terminal output and every second on the HTML output.

  • No configuration needed You can just run it against your access log file, pick the log format and let GoAccess parse the access log and show you the stats.

  • Track Application Response Time Track the time taken to serve the request. Extremely useful if you want to track pages that are slowing down your site.

  • Nearly All Web Log Formats GoAccess allows any custom log format string. Predefined options include, Apache, Nginx, Amazon S3, Elastic Load Balancing, CloudFront, etc

  • Incremental Log Processing Need data persistence? GoAccess has the ability to process logs incrementally through the on-disk B+Tree database.

  • Only one dependency GoAccess is written in C. To run it, you only need ncurses as a dependency. That's it. It even has its own Web Socket server - http://gwsocket.io/.

  • Visitors Determine the amount of hits, visitors, bandwidth, and metrics for slowest running requests by the hour, or date.

  • Metrics per Virtual Host Have multiple Virtual Hosts (Server Blocks)? A panel that displays which virtual host is consuming most of the web server resources.

  • Color Scheme Customizable Tailor GoAccess to suit your own color taste/schemes. Either through the terminal, or by simply updating the stylesheet on the HTML output.

  • Support for large datasets GoAccess features an on-disk B+Tree storage for large datasets where it is not possible to fit everything in memory.

  • Docker support GoAccess comes with a default Docker (https://hub.docker.com/r/allinurl/goaccess/) that will listen for HTTP connections on port 7890. Although, you can still fully configure it, by using Volume mapping and editing goaccess.conf.

  • and more... visit https://goaccess.io for more details.

Why GoAccess?

GoAccess was designed to be a fast, terminal-based log analyzer. Its core idea is to quickly analyze and view web server statistics in real time without needing to use your browser (great if you want to do a quick analysis of your access log via SSH, or if you simply love working in the terminal).

While the terminal output is the default output, it has the capability to generate a complete real-time HTML report, as well as a JSON, and CSV report.

You can see it more of a monitor command tool than anything else.


The user can make use of the following keys:

  • ^F1^ or ^h^ Main help,
  • ^F5^ Redraw [main window],
  • ^q^ Quit the program, current window or module,
  • ^o^ or ^ENTER^ Expand selected module,
  • ^[Shift]0-9^ Set selected module to active,
  • ^Up^ arrow Scroll up main dashboard,
  • ^Down^ arrow Scroll down main dashboard,
  • ^j^ Scroll down within expanded module,
  • ^k^ Scroll up within expanded module,
  • ^c^ Set or change scheme color,
  • ^CTRL^ + ^f^ Scroll forward one screen within,
  • active module,
  • ^CTRL^ + ^b^ Scroll backward one screen within,
  • active module,
  • ^TAB^ Iterate modules (forward),
  • ^SHIFT^ + ^TAB^ Iterate modules (backward),
  • ^s^ Sort options for current module,
  • ^/^ Search across all modules,
  • ^n^ Find position of the next occurrence,
  • ^g^ Move to the first item or top of screen,
  • ^G^ Move to the last item or bottom of screen,

Examples can be found by running man goaccess.

Previous Post Next Post