LOGCONV.PY(1)

💖 LOGCONV.PY — the manual, but make it cute 💖

okay bestie, gather round 🫶 this is the manual page for logconv.py, living in section 1 of the General Commands Manual. Yes it's a shell command. Yes it's a whole vibe. Let's get into it ✨

---

🌸 NAME 🌸

logconv.py — literally analyzes Directory Server access log files. that's it. that's the job. 💅

---

✨ 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)]

(that line wrapping? not real, it's just the terminal being a drama queen. the options are all real tho 🎀)

---

🦋 DESCRIPTION 🦋

It analyzes Directory Server access log files for the specific info you defined on the command line. no cap. you tell it what you wanna know, it goes and finds it. 🕵️‍♀️

---

👑 OPTIONS 👑

• -h, --help — help/usage. the classic. when in doubt, ask for help 💖
• -v, --version — shows you the log analyzer version. so you know which era of this software you're living in ⭐
• -V, --verbose — turns on verbose mode for detailed statistic processing. it's giving "tell me EVERYTHING" energy 👑
• -s, --sizeLimit SIZE_LIMIT — how many results to return per category. DEFAULT: 20. that's the number, that's the default, don't come for me 🍓
• -d, --rootDN ROOT_DN — the Directory Manager's DN. DEFAULT: "cn=Directory Manager" 🌈
• -B, --bind BIND_DN — generates an activity report based on the specified bind DN. Options: <ALL | ANONYMOUS | "Actual bind DN"> — so pick your fighter 💅
• -X, --excludeIP EXCLUDE_IP — an IP address to exclude from the analysis, which lowkey is perfect for excluding load balancers. To specify multiple IP addresses you could use: -X 192.168.1.1 -X 10.1.2.1 🙈
• -S, --startTime START_TIME — the time to begin analysing the 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 — the time to stop analysing the 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 — captures operation stats at second intervals and writes them to a csv file. so many data points, so little time 💀
• -M, --reportFileMins MIN_STATS_FILENAME — captures operation stats at minute intervals and writes them to a csv file. chiller pace, same energy 🧚
• -j, --recommends — provides some preformance recommendations post analysis. yes. post. analysis. glow-up advice for your server ✨

---

🎀 USAGE 🎀

Examples, aka the receipts 📸:

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 💜

logconv.py was written by the 389 Project. respect the architects 🫡

---

🚨 REPORTING BUGS 🚨

Found a bug? not the vibe, but okay, we fix it. Report bugs to https://github.com/389ds/389-ds-base/issues/new 🔥

---

⭐ 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. periodt. 💅

---

ngl the whole thing is free software and that's iconic of it 🌈

okay that's the whole page bestie, tysm for reading, love you, bye 🫶💖

logconv.py, section 1, from the General Commands Manual, dated January 22, 2025 — signing off, mwah 😘✨