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>] [-efcibaltnxgjuU] [ access log ... ... ]
11

DESCRIPTION

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

OPTIONS

17       A summary of options is included below:
18
19       -h, --help
20              help/usage
21
22       -d, --rootDN <Directory Managers DN>
23              DEFAULT -> cn=directory manager
24
25       -D, --data <Location for temporary data files>
26              DEFAULT -> /tmp
27              TIP  ->  If  there  is  not  enough  RAM, a RAM disk can be used
28              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       -M, --reportFileMins <CSV output file>
51              This option creates a CSV report for spreadsheets.
52
53       -m, --reportFileSecs <CSV output file>
54              This option creates a CSV report for spreadsheets.
55
56       -B, --bind <ALL | ANONYMOUS | Bind DN >
57              This generates a report based on either ALL bind dn's, anonymous
58              binds, or a specific DN.
59
60       -V, --verbose <enable verbose output - includes all stats listed  below
61       except U>
62              Verbose output
63
64       -[efcibaltnxgjuU]
65              e Error Code stats
66              f Failed Login Stats
67              c Connection Code Stats
68              i Client Stats
69              b Bind Stats
70              a Search Base Stats
71              l Search Filter Stats
72              t Etime Stats
73              n Nentries Stats
74              x Extended Operations
75              r Most Requested Attribute Stats
76              g Abandoned Operation Stats
77              j Recommendations
78              u Unindexed Search Stats (very detailed)
79              y Connection Latency Stats
80              p Open Connection ID Stats
81              U Unindexed Search Summary
82

USAGE

84       Examples:
85
86              logconv.pl -s 10 -V access
87
88              logconv.pl           -d          "cn=directory          manager"
89              /export/server4/slapd-host/logs/access*
90
91              logconv.pl -s 50 -ibgju access*
92
93              logconv.pl     -S     "[28/Mar/2002:13:14:22     -0800]"      -E
94              "[28/Mar/2002:13:50:05 -0800]" -e access
95

AUTHOR

97       logconv.pl was written by the 389 Project.
98

REPORTING BUGS

100       Report bugs to http://bugzilla.redhat.com.
101

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