70b95c
.TH HALOG "1" "July 2013" "halog" "User Commands"
70b95c
.SH NAME
70b95c
halog \- HAProxy log statistics reporter
70b95c
.SH SYNOPSIS
70b95c
.B halog
70b95c
[\fI-h|--help\fR]
70b95c
.br
70b95c
.B halog
70b95c
[\fIoptions\fR] 
70b95c
.SH DESCRIPTION
70b95c
.B halog
70b95c
reads HAProxy log data from stdin and extracts and displays lines matching
70b95c
user-specified criteria.
70b95c
.SH OPTIONS
70b95c
.SS Input filters \fR(several filters may be combined)
70b95c
.TP
70b95c
\fB\-H\fR
70b95c
Only match lines containing HTTP logs (ignore TCP)
70b95c
.TP
70b95c
\fB\-E\fR
70b95c
Only match lines without any error (no 5xx status)
70b95c
.TP
70b95c
\fB\-e\fR
70b95c
Only match lines with errors (status 5xx or negative)
70b95c
.TP
70b95c
\fB\-rt\fR|\fB\-RT\fR <time>
70b95c
Only match response times larger|smaller than <time>
70b95c
.TP
70b95c
\fB\-Q\fR|\fB\-QS\fR
70b95c
Only match queued requests (any queue|server queue)
70b95c
.TP
70b95c
\fB\-tcn\fR|\fB\-TCN\fR 
70b95c
Only match requests with/without termination code 
70b95c
.TP
70b95c
\fB\-hs\fR|\fB\-HS\fR <[min][:][max]>
70b95c
Only match requests with HTTP status codes within/not within min..max. Any of
70b95c
them may be omitted. Exact code is checked for if no ':' is specified.
70b95c
.SS
70b95c
Modifiers
70b95c
.TP
70b95c
\fB\-v\fR
70b95c
Invert the input filtering condition
70b95c
.TP
70b95c
\fB\-q\fR
70b95c
Don't report errors/warnings
70b95c
.TP
70b95c
\fB\-m\fR <lines>
70b95c
Limit output to the first <lines> lines
70b95c
.SS
70b95c
Output filters \fR\- only one may be used at a time
70b95c
.TP
70b95c
\fB\-c\fR
70b95c
Only report the number of lines that would have been printed
70b95c
.TP
70b95c
\fB\-pct\fR
70b95c
Output connect and response times percentiles
70b95c
.TP
70b95c
\fB\-st\fR
70b95c
Output number of requests per HTTP status code
70b95c
.TP
70b95c
\fB\-cc\fR
70b95c
Output number of requests per cookie code (2 chars)
70b95c
.TP
70b95c
\fB\-tc\fR
70b95c
Output number of requests per termination code (2 chars)
70b95c
.TP
70b95c
\fB\-srv\fR
70b95c
Output statistics per server (time, requests, errors)
70b95c
.TP
70b95c
\fB\-u\fR*
70b95c
Output statistics per URL (time, requests, errors)
70b95c
.br
70b95c
Additional characters indicate the output sorting key:
70b95c
.RS
70b95c
.TP
70b95c
\fB\-u\fR
70b95c
URL
70b95c
.TP
70b95c
\fB\-uc\fR
70b95c
Request count
70b95c
.TP
70b95c
\fB\-ue\fR
70b95c
Error count
70b95c
.TP
70b95c
\fB\-ua\fR
70b95c
Average response time
70b95c
.TP
70b95c
\fB\-ut\fR
70b95c
Average total time
70b95c
.TP
70b95c
\fB\-uao\fR, \fB\-uto\fR
70b95c
Average times computed on valid ('OK') requests
70b95c
.TP
70b95c
\fB\-uba\fR
70b95c
Average bytes returned
70b95c
.TP
70b95c
\fB\-ubt\fR
70b95c
Total bytes returned
70b95c
.RE
70b95c
.SH "SEE ALSO"
70b95c
.BR haproxy (1)
70b95c
.SH AUTHOR
70b95c
.PP
70b95c
\fBhalog\fR was written by Willy Tarreau <w@1wt.eu> and is part of \fBhaproxy\fR(1).
70b95c
.PP
70b95c
This  manual page was written by Apollon Oikonomopoulos <apoikos@gmail.com> for the Debian project (but may
70b95c
be used by others).
70b95c