NAME
traffic_logstats - Traffic Server analyzer
SYNOPSIS
traffic_logstats [options]
DESCRIPTION
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.
OPTIONS
- -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.
COPYRIGHT
2026, [email protected]