Debian Codegraph @

upstream/debian-unstable/man5/auditd.cron.5

raw
1 .TH AUDITD.CRON "5" "Feb 2025" "Red Hat" "System Administration Utilities"
2 .SH NAME
3 auditd.conf \- time-based rotation of audit logs
4 .SH DESCRIPTION
5 By default, the audit daemon (auditd) supports size-based log rotation, where logs are rotated once they reach a specified size, as configured in
6 .I /etc/audit/auditd.conf.
7 This manual describes an alternative method: time-based log rotation using
8 .B cron.
9 Using this approach, audit logs can be rotated at specified intervals (hourly, daily, weekly or on a custom date), regardless of their size.
10
11 .SH CONFIGURATION
12
13 .B 1.Disable Size-Based Rotation:
14
15 To enable time-based log rotation, first disable \fBauditd's\fP built-in size-based rotation by setting the following parameter in
16 .I /etc/audit/auditd.conf:
17
18 .RS
19 max_log_file_action = ignore
20 .RE
21
22 .B 2. Configure Log Retention:
23
24 The
25 .B num_logs
26 parameter determines the number of rotated log files to keep. For daily rotation, setting
27
28 .RS
29 num_logs = 7
30 .RE
31
32 ensures that logs from the last seven days are retained. However, on busy systems, audit logs may grow rapidly, potentially leading to a lack of disk space. To prevent this, ensure that the
33 .B space_left_action
34 parameter is configured to handle low-disk-space situations appropriately.
35
36 .B 3. Apply Configuration Changes:
37
38 After modifying the main auditd configuration file, reload auditd to apply the changes:
39
40 .RS
41 auditctl --signal reload
42 .RE
43
44 .B 4. Deploy the Rotation Script:
45
46 Copy the provided
47 .B auditd.cron
48 script to the appropriate cron directory (
49 .IR cron.daily
50 or
51 .IR cron.hourly
52 or
53 .IR cron.weekly
54 , depending on your rotation preference). Then, ensure the file has the correct SELinux labels:
55
56 .RS
57 cp /usr/share/doc/audit/auditd.cron /etc/cron.daily
58 .RE
59
60 .SH "SEE ALSO"
61 .BR auditd.conf (5),
62 .BR auditd (8),
63 .BR cron(8).
64
65 .SH AUTHOR
66 Attila Lakatos