1LOGCONV.PL(1)               General Commands Manual              LOGCONV.PL(1)
2
3
4

NAME

6       logconv.pl - analyzes Directory Server access log files
7

SYNOPSIS

9       logconv.pl  [-h]  [-d  <rootDN>] [-s <size limit>] [-v] [-V] [-S <start
10       time>] [-E <end time>] [-T <min etime>] [-efcibaltnxgjuU] [ access  log
11       ... ... ]
12

DESCRIPTION

14       Analyzes  Directory  Server  access  log files for specific information
15       defined on the command line
16

OPTIONS

18       A summary of options is included below:
19
20       -h, --help
21              help/usage
22
23       -d, --rootDN <Directory Managers DN>
24              DEFAULT -> cn=directory manager
25
26       -D, --data <Location for temporary data files>
27              DEFAULT -> /tmp
28              TIP -> If there is enough RAM, a RAM disk can be used instead:
29
30                     mkdir /dev/shm/logconv, and use this  directory  for  the
31              "-D" value.
32
33       -s, --sizeLimit <Number of results to return per category>
34              DEFAULT -> 20
35
36       -X, --excludeIP <IP address to exclude from connection stats>
37              E.g. Load balancers
38
39       -v, --version show version of tool
40              Print version of the tool
41
42       -S, --startTime <time to begin analyzing logfile from>
43              Time  to begin analyzing logfile from E.g. [28/Mar/2002:13:14:22
44              -0800]
45
46       -E, --endTime <time to stop analyzing logfile>
47              Time to stop analyzing logfile from  E.g.  [28/Mar/2002:13:24:62
48              -0800]
49
50       -T, --minEtime <minimum etime to report unindexed searches>
51              The  minimum  etime  that is required to record and report on an
52              unindexed search.  Default is zero.
53
54       -M, --reportFileMins <CSV output file>
55              This option creates a CSV report for spreadsheets.
56
57       -m, --reportFileSecs <CSV output file>
58              This option creates a CSV report for spreadsheets.
59
60       -B, --bind <ALL | ANONYMOUS | Bind DN >
61              This generates a report based on either ALL bind dn's, anonymous
62              binds, or a specific DN.
63
64       -V,  --verbose <enable verbose output - includes all stats listed below
65       except U>
66              Verbose output
67
68       -[efcibaltnxgjuU]
69              e Error Code stats
70              f Failed Login Stats
71              c Connection Code Stats
72              i Client Stats
73              b Bind Stats
74              a Search Base Stats
75              l Search Filter Stats
76              t Etime Stats
77              n Nentries Stats
78              x Extended Operations
79              r Most Requested Attribute Stats
80              g Abandoned Operation Stats
81              j Recommendations
82              u Unindexed Search Stats (very detailed)
83              y Connection Latency Stats
84              p Open Connection ID Stats
85              U Unindexed Search Summary
86

USAGE

88       Examples:
89
90              logconv.pl -s 10 -V access
91
92              logconv.pl          -d          "cn=directory           manager"
93              /var/log/dirsrv/slapd-host/access*
94
95              logconv.pl -s 50 -ibgju access*
96
97              logconv.pl      -S     "[28/Mar/2002:13:14:22     -0800]"     -E
98              "[28/Mar/2002:13:50:05 -0800]" -e access
99

AUTHOR

101       logconv.pl was written by the 389 Project.
102

REPORTING BUGS

104       Report bugs to https://github.com/389ds/389-ds-base/issues/new
105

107       Copyright © 2001 Sun Microsystems, Inc. Used by permission.
108       Copyright © 2017 Red Hat, Inc.
109       This    manual    page    was    written    by    Michele    Baldessari
110       <michele@pupazzo.org>,  for the Debian project (but may be used by oth‐
111       ers).
112       This is free software.  You may redistribute copies  of  it  under  the
113       terms of the Directory Server license found in the LICENSE file of this
114       software distribution.  This license is  essentially  the  GNU  General
115       Public License version 2 with an exception for plug-in distribution.
116
117
118
119                                March 31, 2017                   LOGCONV.PL(1)
Impressum