https://github.com/jblond/mod_log_rotate
mod_log_rotate module for native log rotation for apache
https://github.com/jblond/mod_log_rotate
apache apache2 c httpd-logs log-rotation logrotate module
Last synced: 11 months ago
JSON representation
mod_log_rotate module for native log rotation for apache
- Host: GitHub
- URL: https://github.com/jblond/mod_log_rotate
- Owner: JBlond
- License: apache-2.0
- Created: 2012-09-22T12:01:24.000Z (almost 14 years ago)
- Default Branch: master
- Last Pushed: 2022-01-12T09:56:39.000Z (over 4 years ago)
- Last Synced: 2025-04-15T03:45:29.577Z (about 1 year ago)
- Topics: apache, apache2, c, httpd-logs, log-rotation, logrotate, module
- Language: C
- Homepage:
- Size: 34.2 KB
- Stars: 8
- Watchers: 6
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mod_log_rotate
Original from andya ät apache.org
Modified version from Mario Brandt / JBlond
## INTRODUCTION
If you host a lot of virtual servers on a single Apache box and use the supplied rotatelogs
program to rotate the access logs you'll notice that your process table is cluttered up with an instance
of rotatelogs for each virtual server. With mod_log_rotate the log rotation is handled by the server
process so you save a bunch of processes and file descriptors.
Note: error log files can not be rotated with this module.
## BUILD
See [build.md](build.md)
## INSTALL
Copy mod_log_rotate.so to your Apache 2.4.x modules folder
.../apache24/modules/mod_log_rotate.so
## USAGE:
```
LoadModule log_rotate_module modules/mod_log_rotate.so
RotateLogs On
```
You can specify a strftime() format string as the log file name.
```
CustomLog logs/%Y%m%d-%H%M%S.access.log common
```
## CONFIGURATION DIRECTIVES:
RotateLogs On|Off Enable / disable automatic log rotation. Once enabled
mod_log_rotate takes responsibility for all log output
server wide even if RotateLogs Off is subsequently
used. That means that the BufferedLogs directive that
is implemented by mod_log_config will be ignored.
RotateLogsLocalTime Normally the log rotation interval is based on UTC.
For example an interval of 86400 (one day) will cause
the logs to rotate at UTC 00:00. When this option is
on, log rotation is timed relative to the local time.
RotateInterval Set the interval in seconds for log rotation. The
default is 86400 (one day). The shortest interval that
can be specified is 60 seconds. An optional second
argument specifies an offset in minutes which is
applied to UTC (or local time if RotateLogsLocalTime
is on). For example RotateInterval 86400 60 will
cause logs to be rotated at 23:00 UTC.
## Bugs
A wrong configured placeholder for strftime causes a crash in the module.
So if you use Y% instead of %Y apache crashes with a segfault. This bug is confirmed on Windows
and might happen on *nix based systems, too.
On Windows it is the call of strftime in timestr.c (APR) line ~ 190 [win32_strftime_extra]
## AVAILABILITY
### AVAILABILITY of the original
mod_log_rotate.c original source code under the Apache License Version 2.0
is no longer available.
### AVAILABILITY of the modified version
https://github.com/JBlond/mod_log_rotate
### AVAILABILITY Windows binary x86 and x64
https://www.apachehaus.com/cgi-bin/download.plx
## Contribute
Contributers are welcome. Open Pull request or file an issue.