Loghound Traffic Analytics Setup

Install it, wire up the logs, and tune what it finds

Loghound — traffic analytics

Loghound now has its own documentation.

It used to be this single page. It is a separate product — a separate repository, its own installer, its own panel — so it is now a full documentation set of its own: opensolr.com/loghound-docs. This page is kept so that older links still work.

Loghound is an open-source, MIT-licensed traffic analyser for Apache, nginx and Caddy access logs. It reads the logs your web server already writes, correlates them with an optional JavaScript beacon, and stores everything in two Opensolr indexes it provisions for you — so an Opensolr account is required, and the free plan is enough to start.

It exists to do two things that conventional analytics does badly or not at all: detect headless Chrome on rotating residential proxies, which every other analytics product counts as human traffic, and measure how long a visitor was actually reading rather than how long a tab existed.

Where everything went

If you came here for…It is now at
What Loghound is, and the three-plane modelWhat Loghound is · The three-plane model
Installing itRequirements · From a shell · From a browser
The two Opensolr indexes it provisionsWhy an account is required · Provisioning · Joining a pair you have
Log sources and the recommended LogFormatLog sources · The recommended LogFormat
The beacon, identity, search terms, another serverInstalling the beacon · Every option · Identity · A site on another server
The four timing numbersThe four time numbers
How the scoring worksThe fingerprint cluster · The scoring rules · False positives
Signing in, and two-factorSigning in & two-factor
The panel, view by viewHow the panel works, then a page for each view
Analytics over your own Opensolr indexesIndex analytics · Query analysis · Who is querying
Privacy, retention and how history is sized to your planPrivacy · Retention & disk
Running it, the commands, uninstallingRunning it · Command reference · Uninstalling

Read the full Loghound documentation →

Source, issues and releases: github.com/phpcip/loghound. Product overview: opensolr.com/loghound.