Logstalgia(1) | General Commands Manual | Logstalgia(1) |
NAME¶
Logstalgia - a web server access log visualization toolSYNOPSIS¶
logstalgia [-f] [-WIDTHxHEIGHT] [options] logfileDESCRIPTION¶
logstalgia is a visualization tool that replays or streams web server access logs as a retro arcade game simulation.REQUIREMENTS¶
logstalgia's display is rendered using OpenGL and requires a 3D accelerated video card to run.OPTIONS¶
- -f
- Fullscreen.
- -WIDTHxHEIGHT
- Set the window size. If -f is also supplied, will attempt to set the video mode to this also.
- -b, --background
- Background colour in hex.
- -x --full-hostnames
- Show full request ip/hostname.
- -s, --speed
- Simulation speed. Defaults to 1 (1 second-per-second).
- -u, --update-rate
- Page Summary update speed. Defaults to 5 (5 seconds).
- -g name,regex,percent[,colour]
- Urls matching the given regex will appear under a new
section with the given name using the given percentage of the screen.
Colour may optionally be supplied in the common hexadecimal format (eg
FF0000 for red)
- --paddle-mode MODE
- Paddle mode (pid, vhost, single).
- --paddle-position POSITION
- Paddle position as a fraction of the view width (0.25 - 0.75).
- --sync
- Read from STDIN, ignoring entries before the current time.
- --start-position POSITION
- Begin at some position in the log file (between 0.0 and 1.0).
- --stop-position POSITION
- Stop at some position.
- --no-bounce
- No bouncing.
- --hide-response-code
- Hide response code.
- --hide-paddle
- Hide paddle.
- --hide-url-prefix
- Hide URL protocol and hostname prefix of requests.
- --disable-auto-skip
- Disable automatic skipping of empty time periods.
- --disable-progress
- Disable the progress bar.
- --disable-glow
- Disable the glow effect.
- --font-size SIZE
- Font size.
- --glow-duration
- Duration of the glow (between 0.0 and 1.0).
- --glow-multiplier
- Adjust the amount of glow.
- --glow-intensity
- Intensity of the glow.
- --output-ppm-stream FILE
- Write frames as PPM to a file ('-' for STDOUT).
- --output-framerate FPS
- Framerate of output (used with --output-ppm-stream).
- logfile
- The path to the access log file to read or '-' if you wish
to supply log entries via STDIN.
EXAMPLES¶
Watch an example access.log using the default settings:SUPPORTED LOG FORMATS¶
Logstalgia supports the following standardized log formats used by web servers like Apache and Nginx:"%h %l %u %t \"%r\" %>s %b"
"%v %h %l %u %t \"%r\" %>s %b"
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
"%v %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
CUSTOM LOG FORMAT¶
Logstalgia now supports a pipe ('|') delimited custom log file format:RECORDING VIDEOS¶
See the guide on the homepage for examples of recording videos with Logstalgia:INTERFACE¶
The time shown in the top left of the screen is set initially from the first log entry read and is incremented according to the simulation speed (-s).AUTHOR¶
Written by Andrew Caudwell Project Homepage: http://code.google.com/p/logstalgia/
COPYRIGHT¶
Copyright (C) 2008 Andrew Caudwell (acaudwell@gmail.com) This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
ACKNOWLEDGEMENTS¶
Catalyst IT (catalyst.net.nz) For supporting the development and promotion of Logstalgia!