webdruid(1)

📦 version 0.5.4, in debian bookworm, ubuntu jammy, ubuntu noble

👑 webdruid — the manual page, but make it make sense 💅

okay bestie, gather round, because we're talking about webdruid — a web site log file analysis tool. yes, the whole manual. no skipping. let's go 🦋

✨ SYNOPSIS ✨

webdruid [ option ... ] [ log-file1 ] [ log-file2 ] ...

webdruid-resolve [ option ... ] [ log-file1 ] [ log-file2 ] ...

that's it. that's the whole vibe. you give it options, you give it log files, it does the thing 🌸

💖 DESCRIPTION 💖

The WebDruid is a web site log file analysis program that spits out usage statistics in HTML format so you can look at them in a browser. and the results come in both columnar and graphical format, which is genuinely so helpful for actually interpreting what you're looking at — no cap 🫶

you get yearly, monthly, daily and hourly usage statistics, plus the ability to display usage by:

  • site
  • URL
  • referrer
  • user agent (browser)
  • username
  • search strings
  • entry/exit pages
  • country

lowkey a whole personality. tho fair warning: some of that info might just not be available if it's not present in the log file you're processing. it's not being shady, it literally can't read what isn't there 🙈

🌈 log formats it eats for breakfast

The WebDruid supports CLF (common log format) log files, plus Combined log formats as defined by NCSA and others, and variations of those which it attempts to handle intelligently. it's giving "i can fix him" but in a good way ✨

and it also supports W3C formatted log files, which means it can parse IIS log files. iconique.

logs may also be compressed via gzip. if a compressed log file is detected, it will be automatically uncompressed while it is read — you don't have to do anything, it just handles it 💅

important: compressed logs must have the standard gzip extension of .gz. no .gz, no autodetect. periodt.

🎀 path graphs & users flow graphs

The WebDruid, when used with the graphviz tools, can produce path graphs and users flow graphs.

  • Path graph — lets you see the preferred path your users take when browsing on your web site. main character route reveal 🧚
  • Users flow — draws lines between the urls, each line being balanced by the number of hits.

for more info, see 'Using path & users flox graphs' in the README file. (yes, it says "flox". we don't fix typos here, we respect them. 💀)

🦋 what about webdruid-resolve?

webdruid-resolve is normally just a symbolic link to webdruid. when run as webdruid-resolve, only DNS file creation/updates are performed, and the program will exit once complete.

all normal options and configuration directives are available — however, many will not be used. so like, they're invited to the party, they're just not on aux 🎧

📚 the actual docs

The WebDruid main documentation is located in the README file. it contains instructions on operating with the software, plus a reference for all the /etc/webdruid/webdruid.conf config file directives and command line options. go read it, i'm serious, it's the good stuff ⭐

🔥 BUGS 🔥

found a bug? report bugs to fabien@juliana-multimedia.com.

Copyright (C) 2003-2004 by Fabien Chevalier.

Original Copyright (C) 1997-2000 by Bradford L. Barrett.

Distributed under the GNU GPL. see the files "COPYING" and "Copyright", supplied with all distributions for additional information.

🌸 AUTHOR 🌸

Fabien Chevalier <fabien@juliana-multimedia.com>

and that's the whole page bestie, you ate it, you understood it, you're literally a sysadmin now 👑

Version 0.5.4 — 22-Jun-2004 💖 mwah, go read your logs, ilysm 🎀✨

📦 where this page comes from