Request shield: the log
Setup > Request shield > Log (/requestshield/log) lists what the shield wrote to its log: every request it
refused, sent to the browser check or, in monitor mode, would have refused. Newest first. You need the policy
requestshield/read.
Contents
Choosing what to see
- Period: the last 1, 6, 24, 72 or 168 hours.
- Decision: All, Refused, Browser check, Watched (monitor) or Other, each with its count.
- Newer and Older page through the lines, 50 at a time.
The columns
| Column | What it shows |
|---|---|
| Time | when the shield decided |
| Client | the client's network as the log wrote it |
| Request | the method, host and path |
| Decision | what the shield did (refused, browser check, a monitor-... decision in monitor mode ...) |
| Status | the HTTP status the client got |
| Rule and reason | the rule ID that decided (EXP-SYSVIEW, EXP-LOGIN, SITE-DASH ...) and why |
The Client column shows the address as the log wrote it: by default its network (IPv4 /24, IPv6 /48, the
library's set log-ip masked), never a person's full address.
The rule ID is the thread to pull. It tells whoever looks after the rules which line decided; trace on the server
shows the same decision step by step (The rules).
A link to one view
Every choice is a link with view parameters, so you can send a colleague exactly what you see:
/requestshield/log/(hours)/72/(group)/refused/(offset)/50The log file
The shield writes var/request-shield/log/shield.log (with the shipped rules), one line per decision, rotated at the
library's log-max-size. It is a plain file on the server; tail -f follows it. If the page says the log does not
exist or cannot be read, the rules name no log file, or the web server cannot read it
(Troubleshooting).
The record of who used the switches is a different file, var/log/requestshield.log, shown in Setup > Log files.
Settings of the log page
In settings/override/requestshield.ini.append.php, [AdminSettings]:
| Setting | Default | Meaning |
|---|---|---|
LogHours[] | 1, 6, 24, 72, 168 | the periods to choose from |
LogPageSize | 50 | lines per page |