LOGCONV.PY(1) General Commands Manual LOGCONV.PY(1)

# [NAME](#NAME)

logconv.py - Analyzes Directory Server access log files

# [SYNOPSIS](#SYNOPSIS)

**logconv.py** \[*-h*] \[*-v*] \[*-V*] \[*-s SIZE\_LIMIT*] \[*-d ROOT\_DN*] \[*-B BIND\_DN*] \[*-X EXCLUDE\_IP*] \[*-S START\_TIME*] \[*-E END\_TIME*] \[*-m SEC\_STATS\_FILENAME*] \[*-M MIN\_STATS\_FILENAME*] \[ *access log(s)*]

# [DESCRIPTION](#DESCRIPTION)

Analyzes Directory Server access log files for specific information defined on the command line.

# [OPTIONS](#OPTIONS)

[**-h, --help**](#h,)

help/usage.

[**-v, --version**](#v,)

Display log analyzer version.

[**-V, --verbose**](#V,)

Enable verbose mode for detailed statistic processing.

[**-s, --sizeLimit SIZE\_LIMIT**](#s,)

Number of results to return per category.  
DEFAULT: 20

[**-d, --rootDN ROOT\_DN**](#d,)

Directory Managers DN.  
DEFAULT: "cn=Directory Manager"

[**-B, --bind BIND\_DN**](#B,)

Generates an activity report based specified bind DN.  
Options: <ALL | ANONYMOUS | "Actual bind DN">

[**-X, --excludeIP EXCLUDE\_IP**](#X,)

IP address to exclude from analysis, could be used to exclude load balancers.  
To specify multiple IP addresses you could use: -X 192.168.1.1 -X 10.1.2.1

[**-S, --startTime START\_TIME**](#S,)

Time to begin analysing logfile from.  
Copy and paste a timestamp from the access logs:  
"\[04/Jun/2024:10:31:20.014629085 +0200]"  
or  
Use common log format:  
"\[04/Jun/2024:10:31:20 +0200]"'

[**-E, --endTime END\_TIME**](#E,)

Time to stop analysing logfile.  
Copy and paste a timestamp from the access logs:  
"\[04/Jun/2024:11:30:05.435779416 +0200]"  
or  
Use common log format:  
"\[04/Jun/2024:11:30:05 +0200]"

[**-m, --reportFileSecs SEC\_STATS\_FILENAME**](#m,)

Capture operation stats at second intervals and write to csv file.

[**-M, --reportFileMins MIN\_STATS\_FILENAME**](#M,)

Capture operation stats at minute intervals and write to csv file.

[**-j, --recommends**](#j,)

Provide some preformance recommendations post analysis.

# [USAGE](#USAGE)

Examples:

Analyze logs in verbose mode  
logconv.py **-V** /var/log/dirsrv/slapd-host/access*

Limit results to 10 entries per category  
logconv.py --sizeLimit 10 /var/log/dirsrv/slapd-host/access*

Specify a custom root DN  
logconv.py **--rootDN** "cn=custom manager" /var/log/dirsrv/slapd-host/access*

Generate a report for anonymous binds  
logconv.py **-B** ANONYMOUS /var/log/dirsrv/slapd-host/access*

Exclude specific IP address(s) from log analysis  
logconv.py **-X** 192.168.1.1 **--exclude\_ip** 11.22.33.44 /var/log/dirsrv/slapd-host/access*

Analyze logs within a specific time range  
logconv.py **-S** "\[04/Jun/2024:10:31:20.014629085 +0200]" **--endTime** "\[04/Jun/2024:11:30:05 +0200]" /var/log/dirsrv/slapd-host/access*

Generate performance stats at second intervals  
logconv.py **-m** log-second-stats.csv /var/log/dirsrv/slapd-host/access*

Generate performance stats at minute intervals  
logconv.py **-M** log-minute-stats.csv /var/log/dirsrv/slapd-host/access*

Display recommendations post log analysis  
logconv.py **-j** /var/log/dirsrv/slapd-host/access*

# [AUTHOR](#AUTHOR)

logconv.py was written by the 389 Project.

# [REPORTING BUGS](#REPORTING_BUGS)

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

# [COPYRIGHT](#COPYRIGHT)

Copyright © 2001 Sun Microsystems, Inc. Used by permission.  
Copyright © 2025 Red Hat, Inc.  
This manual page was written by Michele Baldessari <michele@pupazzo.org>, for the Debian project (but may be used by others).  
This is free software. You may redistribute copies of it under the terms of the Directory Server license found in the LICENSE file of this software distribution. This license is essentially the GNU General Public License version 2 with an exception for plug-in distribution.

January 22, 2025

---

Document: logconv.py(1) from 389-ds-base 3.3.1-r9 (Chainguard OS)
Source: https://github.com/389ds/389-ds-base.git