forked from allinurl/goaccess
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
91 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,94 @@ | ||
goaccess | ||
GoAccess | ||
======== | ||
|
||
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/ | ||
|
||
![Alt text](http://goaccess.prosoftcorp.com/images/goaccess_screenshot1M-03L.png) | ||
|
||
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 | ||
* 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. | ||
|
||
Briefly, the shell commands `./configure; make; make install` should configure, build, and install GoAccess. | ||
An INSTALL file is attached within the package for more-detailed instructions. | ||
|
||
http://goaccess.prosoftcorp.com/download#installation | ||
|
||
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 | ||
|
||
|
||
Enjoy! |