Skip to content

Custom Log Format

Andrew Caudwell edited this page Aug 10, 2015 · 1 revision

Use Logstalgia to visualize other data sources via the custom log format option

Overview

Logstalgia can be used to visualize other sources of data using a simple pipe ('|') delimited custom log format.

Required fields

  • timestamp - A unix timestamp of when the request occurred.
  • hostname - hostname of the request.
  • path - path being required.
  • response code - response code.
  • response size - The size of the response in bytes.

Optional fields

  • success - 1 or 0 to indicate if the response was successful.
  • response colour - colour to use for response code to use in hex (#FFFFFF) format.
  • referrer url - the referrer url.
  • user agent - the user agent.
  • virtual host - the virtual host (to use with --paddle-mode vhost).
  • pid/other - process id or some other identifier (--paddle-mode pid).

Examples

Using the required fields:

1371769989|127.0.0.1|/index.html|200|1024

Including the optional fields:

1371769989|127.0.0.1|/index.html|200|1024|1|00FF00|http://www.example.com/|Mozilla/5.0|webserver|1234

Usage

This format is detected by Logstalgia, so to use your custom log file:

logstalgia custom.log

You can also setup a script that prints custom log entries to STDOUT, and pipe this into logstalgia in real time:

custom-log-script.pl | logstalgia --sync -

(--sync will show all entries with timestamps from the current time onwards)

Clone this wiki locally