Git Product home page Git Product logo

goaccess's Introduction

GoAccess Build Status

What is it?

GoAccess is an open source real-time web log analyzer and interactive viewer that *runs in a terminal in nix systems. It provides fast and valuable HTTP statistics for system administrators that require a visual server report on the fly. More info at: http://goaccess.prosoftcorp.com/

GoAccess Main Dashboard

Features

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

  • General Statistics, bandwidth etc.
  • Time taken to serve the request (useful to track pages that are slowing down your site)
  • Top Visitors
  • Requested files
  • Requested static files, images, swf, js, etc.
  • Referrers URLs
  • 404 or Not Found
  • Operating Systems
  • Browsers and Spiders
  • Hosts, Reverse DNS, IP Location
  • HTTP Status Codes
  • Referring Sites
  • Keyphrases
  • Support for IPv6
  • Different Color Schemes
  • Unlimited log file size
  • Custom log format
  • Output statistics to a file.

Nearly all web log formats...

GoAccess allows any custom log format string. Predefined options include, but not limited to:

  • Common Log Format (CLF) Apache
  • Combined Log Format (XLF/ELF) Apache
  • W3C format (IIS).
  • Amazon CloudFront (Download Distribution).
  • Apache virtual hosts

Why GoAccess?

The main idea behind GoAccess is being able to quickly analyze and view web server statistics in real time without having to generate an HTML report. Although it is possible to generate an HTML report, by default it outputs to a terminal.

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

Installation

GoAccess can be compiled and used on Linux, OSX, OpenBSD, NetBSD, FreeBSD.

Download, extract and compile GoAccess with:

$ wget http://downloads.sourceforge.net/project/goaccess/0.6.1/goaccess-0.6.1.tar.gz
$ tar -xzvf goaccess-0.6.1.tar.gz
$ cd goaccess-0.6.1/
$ ./configure --enable-geoip --enable-utf8 
$ make
# make install

Build from GitHub (Development)

$ git clone https://github.com/allinurl/goaccess.git 
$ cd goaccess 
$ autoreconf -fi 
$ ./configure --enable-geoip --enable-utf8 
$ make
# make install

Usage

The simplest and fastest usage would be:

# goaccess -f access.log

That will generate an interactive text-only output.

To generate an HTML report:

# goaccess -f access.log -a > report.html

To generate full statistics we can run GoAccess as:

# goaccess -f access.log -a

The -a flag indicates that we want to process an agent-list for every host parsed. The -c flag will prompt the date and log format configuration window. Only when curses is initialized.

Now if we want to add more flexibility to GoAccess, we can do a series of pipes. For instance:

If we would like to process all access.log.*.gz we can do:

# zcat access.log.*.gz | goaccess 
OR
# zcat -f access.log* | goaccess

Another useful pipe would be filtering dates out of the web log

The following will get all HTTP requests starting on 05/Dec/2010 until the end of the file.

# sed -n '/05\/Dec\/2010/,$ p' access.log | goaccess -a

For more examples, please check GoAccess' man page: http://goaccess.prosoftcorp.com/man

Contributing

Any help on GoAccess is welcome. Feel free to use the Github issue tracker and pull requests to discuss and submit code changes.

Enjoy!

goaccess's People

Contributors

abgit avatar allinurl avatar chilledheart avatar holys avatar markberger avatar octo avatar stephanepechard avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.