.\" Man page generated from reStructuredText.
.
.TH "TRAFFIC_LOGSTATS" "8" "Mar 08, 2019" "7.1" "Apache Traffic Server"
.SH NAME
traffic_logstats \- Traffic Server analyzer
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBtraffic_logstats\fP [options]
.SH DESCRIPTION
.sp
\fBtraffic_logstats\fP 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.
.sp
Output can either be a human readable text file, or a JSON format. Parsing can
be done incrementally, and \fBtraffic_logstats\fP 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.
.sp
The per\-URL metrics (\fI\-u\fP) requires that you specify a size of the LRU used
for keeping the counters. This is to assure that \fBtraffic_logstats\fP
does not consume an exorbitant amount of memory.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-f FILE, \-\-log_file FILE
.UNINDENT
.INDENT 0.0
.TP
.B \-o LIST, \-\-origin_list LIST
.UNINDENT
.INDENT 0.0
.TP
.B \-O FILE, \-\-origin_file FILE
.UNINDENT
.INDENT 0.0
.TP
.B \-M COUNT, \-\-max_origins COUNT
.UNINDENT
.INDENT 0.0
.TP
.B \-u COUNT, \-\-urls COUNT
.UNINDENT
.INDENT 0.0
.TP
.B \-U COUNT, \-\-show_urls COUNT
.UNINDENT
.INDENT 0.0
.TP
.B \-A, \-\-as_object
.UNINDENT
.INDENT 0.0
.TP
.B \-C, \-\-concise
.UNINDENT
.INDENT 0.0
.TP
.B \-i, \-\-incremental
.UNINDENT
.INDENT 0.0
.TP
.B \-S FILE, \-\-statetag FILE
.UNINDENT
.INDENT 0.0
.TP
.B \-t, \-\-tail
.UNINDENT
.INDENT 0.0
.TP
.B \-s, \-\-summary
.UNINDENT
.INDENT 0.0
.TP
.B \-j, \-\-json
.UNINDENT
.INDENT 0.0
.TP
.B \-c, \-\-cgi
.UNINDENT
.INDENT 0.0
.TP
.B \-m, \-\-min_hits
.UNINDENT
.INDENT 0.0
.TP
.B \-a, \-\-max_age
.UNINDENT
.INDENT 0.0
.TP
.B \-l COUNT, \-\-line_len COUNT
.UNINDENT
.INDENT 0.0
.TP
.B \-T TAGS, \-\-debug_tags TAGS
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
Print usage information and exit.
.UNINDENT
.INDENT 0.0
.TP
.B \-V, \-\-version
Print version information and exit.
.UNINDENT
.SH COPYRIGHT
2019, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.