The log element configures the logging subsystem. This element may appear zero or one time within the server element. For more information, see server.
The log element can contain the following subelements:
Table 3–33 List of log Subelements
Element |
Occurrences |
Description |
---|---|---|
log-stdout |
0 or 1 |
Determines whether the server logs data that applications write to stdout. The default value is true. |
log-stderr |
0 or 1 |
Determines whether the server logs data that applications write to stderr. The default value is true. |
log-virtual-server-name |
0 or 1 |
Determines whether the server includes the virtual server name in log messages. The default value is false. |
create-console |
0 or 1 |
Determines whether the server creates a console window (Windows only). The default value is false. |
log-to-console |
0 or 1 |
Determines whether the server writes log messages to the console. The default value is true. |
log-to-syslog |
0 or 1 |
Determines whether the server writes log messages to syslog (UNIX only ) or Event Viewer (Windows only). The default value is false. |
date-format |
0 or 1 |
The date format for log message timestamps. The default value is %d/%b/%Y:%H:%M:%S. For more information, see Appendix D, Using Time Formats. |
archive-suffix |
0 or 1 |
The suffix appended to rotated log file names. The default value is %Y%m%d%H%M. |
archive-command |
0 or 1 |
The command executed after the server rotates a log file. The program is passed the post-rotation file name of the log file as an argument. The value is a program command line. For example, <archive-command>gzip</archive-command> or <archive-command>"c:\Program Files\Perl\perl.exe" archive.pl</archive-command> |
log-level |
0 or 1 |
The log verbosity for the server. The value can be finest (most verbose), finer, fine, info, warning, failure, config, security, or catastrophe (least verbose). |
log-file |
0 or 1 |
Defines the log file for the server. The value is the file name of the log file, for example, ../logs/errors. If a relative path is used, it is relative to the server's config directory. |