logswan(1)

logswan1

Fast web log analyzer using probabilistic data structures

Usage

logswan [-ghv] [-d db] logfile

Overview

logswan is a fast Web log analyzer using probabilistic data structures. It is targeted at very large log files, typically APIs logs. It has constant memory usage regardless of the log file size, and takes approximatively 4MB of RAM.

Unique visitors counting is performed using two HyperLogLog counters (one for IPv4, and another one for IPv6), providing a relative accuracy of 0.10%.

If file is a single dash (`-'), logswan reads from the standard input.

The options are as follows:

-d db

Specify path to a GeoIP database.

-g

Enable GeoIP lookups.

-h

Display usage.

-v

Display version.

Examples

The following script can be used to process all log files in the current directory and save the output in a file:

#!/bin/sh
for file in $(ls *.log)
do
	logswan $file > $file.json
done
exit 0

Releases

4 releases since Debian 10 (Buster); the text changed 3 times.

  1. 10
  2. 11
  3. 12
  4. 13

-d since Debian 11 (Bullseye).

Authors

logswan was written by Frederic Cambus.

From logswan 2.1.15-1 in Debian 13 (Trixie). Parsed by carta from the page's mdoc source.