User:Spot/Packaging/LogFiles

From FedoraProject

< User:Spot(Difference between revisions)
Jump to: navigation, search
m (Log Files on the Filesystem)
Line 1: Line 1:
 
== Fedora Log Files ==
 
== Fedora Log Files ==
 
In Fedora, a log file is defined as a text file that an application outputs into in the /var/log/ directory.
 
 
=== Log Files on the Filesystem ===
 
  
 
Packages which generate log files must write out their logfiles in a package-specific (and package owned) directory under /var/log. Unless the software being packaged rotates its own logs, it must also ship a logrotate config file to rotate its log file(s).
 
Packages which generate log files must write out their logfiles in a package-specific (and package owned) directory under /var/log. Unless the software being packaged rotates its own logs, it must also ship a logrotate config file to rotate its log file(s).
Line 21: Line 17:
 
}
 
}
 
</pre>
 
</pre>
 
{{admon/tip|Debugging logrotate file|You can debug your logrotate file by running
 
<pre># logrotate -d -f /etc/logrotate.d/example.conf</pre>from the command line.}}
 

Revision as of 17:01, 23 May 2013

Fedora Log Files

Packages which generate log files must write out their logfiles in a package-specific (and package owned) directory under /var/log. Unless the software being packaged rotates its own logs, it must also ship a logrotate config file to rotate its log file(s).

Logrotate config file

Logrotate config files should be named in a way that matches the daemon/software which is generating the logs, which is usually (though not always) the same name as the package. When unsure, use "%{name}.conf". These files must be placed in /etc/logrotate.d, and should use standard file permissions (0644) and ownership (root:root).

Example minimal logrotate config file

/var/log/example/*log {
	missingok		# If the log file is missing, go on to the next one without issuing an error message
	notifempty		# Don't do any rotation if the logfile is empty
	compress		# Compress older files with gzip
	delaycompress		# Don't compress yesterdays files
}