traffic_logstats [options]


traffic_logstats is a log parsing utility, that is intended to produce metrics for total and per origin requests. Currently, this utility only supports parsing and processing the Squid binary log format, or a custom format that is compatible with the initial log fields of the Squid format.

Output can either be a human readable text file, or a JSON format. Parsing can be done incrementally, and traffic_logstats supports restarting where it left off previously (state is stored in an external file). This is useful when collecting metrics periodically into a stats processing system, and also supports the case where a log file is rotated.

The per-URL metrics (-u) requires that you specify a size of the LRU used for keeping the counters. This is to assure that traffic_logstats does not consume an exorbitant amount of memory.


-f FILE, --log_file FILE

Specific logfile to parse

-o LIST, --origin_list LIST

Only show stats for listed Origins

-O FILE, --origin_file FILE

File listing Origins to show

-M COUNT, --max_origins COUNT

Max number of Origins to show

-u COUNT, --urls COUNT

Produce JSON stats for URLs, argument is LRU size

-U COUNT, --show_urls COUNT

Only show max this number of URLs

-A, --as_object

Produce URL stats as a JSON object instead of array

-C, --concise

Eliminate metrics that can be inferred from other values

-i, --incremental

Incremental log parsing

-S FILE, --statetag FILE

Name of the state file to use

-t, --tail

Parse the last <sec> seconds of log

-s, --summary

Only produce the summary

-j, --json

Produce JSON formatted output

-c, --cgi

Produce HTTP headers suitable as a CGI

-m, --min_hits

Minimum total hits for an Origin

-a, --max_age

Max age for log entries to be considered

-l COUNT, --line_len COUNT

Output line length

-T TAGS, --debug_tags TAGS

Colon-Separated Debug Tags

-r, --report_per_user

Report stats per username of the authenticated client caun instead of host, see squid log format

-n, --no_format_check

Don’t validate the log format field names according to the squid log format. This would allow squid format fields to be replaced, i.e. the username of the authenticated client caun with a random header value by using cqh, or to remove the client’s host IP address from the log for privacy reasons.

-h, --help

Print usage information and exit.

-V, --version

Print version information and exit.