The fields argument

Here's a typical access log line:

178.133.125.122 - - [21/Jan/2021:05:49:52 +0000] "HEAD /broot/download/x86_64-pc-windows-gnu/broot.exe HTTP/1.1" 200 0 "-" "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)"

Rhit can show tables on the following fields:

  • date,
  • time,
  • method
  • status
  • (remote) IP
  • referer
  • path

You can specify the list of fields on which you want sorted tables.

If you specify nothing, the default is to show dates, status, referers and paths.

Fields are refered either by their name (eg ip) or by their initial (eg i).

The syntax is best explained with a few examples

Goal Argument
Only the paths --field path or -f path or -f p
IP and paths -f path+ip or -f p+i
The default fields and the IP -f +ip or -f +i
The default fields and IP and status -f +ip+status or -f +i+s
The default fields minus dates  -f -d
The default fields with IP but not dates -f +i-d
Default fields but paths moved to the end -f +p
All fields except the paths -f all-paths or -f a-p
All the fields, with dates moved to the end f all+dates or -f a+d

Date

This field is shown by an histogram.

You choose it with --field date, that you may shorten in -f date or -f d:

date

By default the length of the bars is based on the hit counts (in pink). You may base it on sent bytes by changing the sorting key.

Time

This field is shown by an histogram with 24 bars: one per hour.

You choose it with --field time, that you may shorten in -f d.

Note that the time is the the server's time.

Remote IP

The remote adresses table isn't displayed by default.

To see it alone use rhit -f i. To see it with default fields, use rhit -f +i

ip

As for most fields, you see the number of different values (here the 24,691 remote adresses), the most frequent ones, of for each of them the hits, bytes sent, histogram per day and maybe a trend.

If you want more frequent adresses, use the --length field, for example rhit -l 3.

Method

The HTTP method table isn't displayed by default.

To see it use rhit -f +m:

method

As you'd see by exporting the lines with rhit -m other --lines, the "other" methods are usually client errors, that is malformed requests.

Path

The path is displayed by default.

If you want to see only the path, use rhit -f p:

path

By default some paths are filtered from that tables: the images, scripts, etc.

If you don't want this filter, use the --all argument:

path

Referer

The referer is one of the default fields. If you want ot see it alone, do rhit -f ref

(yes, it's called "referer" and not "referrer" in the HTTP protocol, so I'll use this spelling everywhere in this documentation for consistency)

referer

Status

The status is one of the default fields. If you want ot see it alone, do rhit -f status

status