forked from allinurl/goaccess
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
87 lines (75 loc) · 3.02 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
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.
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)
* Metrics for cumulative, average and slowest running requests
* Top visitors
* Requested files & static files
* 404 or Not Found
* Hosts, Reverse DNS, IP Location
* Operating Systems
* Browsers and Spiders
* Referring Sites & URLs
* Keyphrases
* Geo Location - Continent/Country/City
* Visitors Time Distribution
* HTTP Status Codes
* Metrics per Virtual Host
* Ability to output JSON and CSV
* Tailor GoAccess to suit your own color taste/schemes
* Incremental log processing
* Support for large datasets + data persistence
* Support for HTTP/2 & IPv6
* and more...
Nearly all web log formats...
GoAccess allows any custom log format string.
Predefined options include, but not limited to:
* Amazon CloudFront (Download Distribution).
* AWS Elastic Load Balancing
* Combined Log Format (XLF/ELF) Apache | Nginx
* Common Log Format (CLF) Apache
* Google Cloud Storage.
* Apache virtual hosts
* Squid Native Format.
* W3C format (IIS).
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 (great
if you want to do a quick analysis of your access log via SSH).
Although it is possible to generate an HTML, JSON, CSV report, by default it
outputs to a terminal.
You can see it more of a monitor command tool than anything else.
Keys
----
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`.