/usr/bin/logconv.py

usage: 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]
                  [-j] [-l {DEBUG,INFO,WARNING,ERROR,CRITICAL}]
                  [logs ...]

Analyze server access logs to generate statistics and reports.

positional arguments:
  logs                  Single or multiple (*) access logs

options:
  -h, --help            show this help message and exit

General options:
  -v, --version         Display log analyzer version
  -V, --verbose         Enable verbose mode for detailed statistic processing
  -s, --sizeLimit SIZE_LIMIT
                        Number of results to return per category.

Connection options:
  -d, --rootDN ROOT_DN  Specify the Directory Managers DN.
                        Default: "cn=Directory Manager"
  -B, --bind BIND_DN    Generate a bind report for specified DN.
                        Options: [ALL | ANONYMOUS | Actual bind DN]
  -X, --exclude_ip EXCLUDE_IP
                        Exclude specific IP address(s) from log analysis

Time options:
  -S, --startTime START_TIME
                        Start analysing logfile from a specific time.
                        E.g. "[04/Jun/2024:10:31:20.014629085 +0200]"
                        E.g. "[04/Jun/2024:10:31:20 +0200]"
  -E, --endTime END_TIME
                        Stop analysing logfile at this time.
                        E.g. "[04/Jun/2024:11:30:05.435779416 +0200]"
                        E.g. "[04/Jun/2024:11:30:05 +0200]"

Reporting options:
  -m, --reportFileSecs SEC_STATS_FILENAME
                        Capture operation stats at second intervals and write to csv file
  -M, --reportFileMins MIN_STATS_FILENAME
                        Capture operation stats at minute intervals and write to csv file

Miscellaneous options:
  -j, --recommends      Display log analysis recommendations

DEBUG mode:
  -l, --loglevel {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Set logging level (default: INFO)

    Examples:

    Analyze logs in verbose mode:
        logconv.py -V /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 127.0.0.1 -X 1.2.3.4 /var/log/dirsrv/slapd-host/access*

    Analyze logs within a specific range:
        logconv.py -S "2025-07-09T14:00:56.682303279 +0000"  -E "2025-07-09T14:02:50.693400135 +0000" /var/log/dirsrv/slapd-host/access*
        logconv.py -S "[09/Jul/2025:13:58:20.945149534 +0000]"  -E "[09/Jul/2025:13:58:23.226704200 +0000]" /var/log/dirsrv/slapd-host/access*

    Limit results to 10 entries per category:
        logconv.py --sizeLimit 10 /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 for log analysis:
        logconv.py -j /var/log/dirsrv/slapd-host/access*