Exclusions

A matched request is not stored anywhere, on either plane, and cannot be recovered later.

Exclusions are requests Loghound never records at all. A matched request is not stored as a hit, not folded into a visit, not counted anywhere, and it cannot be recovered later, because nothing was written down.

This is a refusal, not a filter

To tidy what you watch without losing anything, use the filters on the Live page instead: they hide requests from the live stream and store everything. See Live.

01 · Adding a rule
  1. Open Settings › Exclusions.
  2. In the empty row, pick a Hostname, or leave every host for a rule that applies everywhere.
  3. Pick a Field: Request path, Client address, User-Agent, Client, Method, Status, Query string or Signed-in email.
  4. Type the Pattern: a regular expression with no slashes and no flags. Matching ignores case.
  5. Press Save exclusions. The card shows how many rules are in force.
  • The pattern * on Request path excludes a hostname entirely. It is the only place a bare star means anything.
  • Method, Status and Client only apply to traffic read from your access logs. A beacon report carries none of them.
  • Both planes are covered: the reader applies the rules to every log line, and the beacon collector to every report.
  • The beacon collector uses a change at once. The reader uses it from its next restart or reload.
  • Untick On to pause a rule without deleting it; tick Remove to delete it.
02 · Keeping your own visits out

Signed-in email is the one field that takes an exact address instead of a pattern, matched without regard to case, for every host or for one. It is how you keep your own visits out of your numbers.

  1. Make your site pass the signed-in visitor’s email to the beacon in data-ident. Identity & signed-in shows how.
  2. Add a rule with the field Signed-in email and your address as the pattern.
  3. Let the beacon run in your own browser: switch off any blocker for your own site, or there is nothing to match.

When a beacon report carries that address, from a site this installation measures, the whole visit it belongs to is excluded on both planes. Nothing more of it is written, and what the reader had already written for it is deleted within a minute. Only that one visit is touched, so a forged address can hide nothing but the forger’s own visit.

Rules travel between installations as a CSV file: Rule lists as CSV.

Settings

Loghound is open source and MIT licensed. Questions about the Opensolr half — the account, the indexes, the plan — go to opensolr.com/contact; questions about the software itself belong on GitHub.

Loghound Documentation