goaccess(1)
NAME
goaccess - a fast and open source Apache Web Log Analyzer
SYNOPSIS
goaccess [-f input-file ] [-b] [-s] [-e]
DESCRIPTION
goaccess is a free (GPL) and open source Apache web log analyzer that
provides fast and valuable HTTP statistics for system administrators
that require a visual report on the fly. GoAccess will parse the wellknown Apache access log file, then it will collect data from the parsed
file and it will display it to the console or the X terminal. The collected information will be displayed to the user in a visual/interactive window. The collected information includes:
- General Statistics:
- Total number of valid requests, Total number of invalid requests, Total time to analyze the data, Total unique visitors, Total unique requests files, Total unique static files (css,ico,jpg,js,swf,gif,png) Total unique HTTP referrers (URLs), Total unique 404s (not found), Size of the parsed log file, Total bandwidth consumption.
- Unique visitors:
- HTTP requests having the same IP, same date and same agent will be considered a unique visit. (including spiders). {Detail view} is available for this module
- Requested files
- The totals are based on unique requested files. This is based on the premise that HTTP requests having the same IP, same date and same agent will be considered a unique visit. {Detail view} is available for this module
- Requested static files
- The totals are based on unique requested files. Includes files such as: jpg, css, swf, js, gif, png etc. Unique requests are based on the premise that HTTP requests having the same IP, same date and same agent will be considered a unique visit. {Detail view} is available for this module
- Referrers URLs
- The URL where the request came from. Totals are not based on the above premise, but instead, based on the total number of requests. {Detail view} is available for this module
- 404 or Not Found
- The total number is based on total requests. {Detail view} is available for this module
- Operating Systems
- The total number is based on unique visitors. As version 0.1, the total number of different operating systems is 20. {Detail view} is available for this module
- Browsers
- The total number is based on unique visitors. As version 0.1, the total number of different browsers and spiders combined is 56. {Detail view} is available for this module
- Hosts The total number is based on total requests. {Detail view} isavailable for this module. {Detail view} for each IP can display extra information for the particular host, including reverse dns, and geolocation of the IP.
- HTTP Status Codes
Totals are based on total requests. {Detail view} is available for this module - Referring Sites
This module will display only the host but not the whole URL. The total number is based on total requests. {Detail view} is available for this module
OPTIONS
- -b Enable total bandwidth consumption. To achieve faster parsing,
- do not enable this flag. This has been disabled by default.
- -f input-file
path to input log filename - -s Enable/report HTTP status codes. To avoid overhead while pars ing, this has been disabled by default.
- -e Exclude an IP from being count it under the HOST module. This has been disabled by default.
INTERACTIVE MENU
F1 Main help.
q Quit the program or the current {detail view} (window).
o Open a {detail view} for the current active module.
TAB Forward iteration of modules. Starts from current active module.
- SHIFT + TAB
- Backward iteration of modules. Starts from current active module.
- RIGHT ARROW
Open a {detail view} for the current active module. - 0-9 Activate module so the user can open a {detail view} with either ^o^ or ^RIGHT ARROW^.
- s Sort unique visitors by date. This will only work on the Unique visitors module(1).
- S Sort unique visitors by hits. This will only work on the Unique visitors module(1).
- / Search forward on any {detail view} window for the occurrence of typed pattern.
- n Find the position of the next occurrence on any {detail view} window.
- t Move to the first item on any {detail view} window.
- b Move to the last item on any {detail view} window.
NOTES
On each {detail view} window, the total number of items displayed is 100. Visit http://goaccess.prosoftcorp.com for future implementations.
BUGS
If you think you have found a bug, please send me an email to goaccess@prosoftcorp.com
AUTHOR
- Gerardo Orellana <goaccess@prosoftcorp.com> For more details about it,
or new releases, please visit http://goaccess.prosoftcorp.com