I think this is ready to be committed now.It's been a long and tiresome
road ;-)
Last-minute comments welcome.
cheers
andrew
Index: doc/src/sgml/config.sgml
===
RCS file: /cvsroot/pgsql/doc/src/sgml/config.sgml,v
retrieving revision 1.136
diff -c -r1.136 config.sgml
*** doc/src/sgml/config.sgml 4 Aug 2007 01:26:53 - 1.136
--- doc/src/sgml/config.sgml 11 Aug 2007 02:00:58 -
***
*** 2253,2259
PostgreSQL supports several methods
for logging server messages, including
! stderr and
syslog. On Windows,
eventlog is also supported. Set this
parameter to a list of desired log destinations separated by
--- 2253,2259
PostgreSQL supports several methods
for logging server messages, including
! stderr, csvlog and
syslog. On Windows,
eventlog is also supported. Set this
parameter to a list of desired log destinations separated by
***
*** 2262,2278
This parameter can only be set in the postgresql.conf
file or on the server command line.
!
! redirect_stderr (boolean)
!redirect_stderr configuration parameter
! This parameter allows messages sent to stderr to be
captured and redirected into log files.
This method, in combination with logging to stderr,
is often more useful than
--- 2262,2285
This parameter can only be set in the postgresql.conf
file or on the server command line.
+ If log_destination is set to csvlog,
+ the log is output as comma seperated values. The format is:
+ timestamp with milliseconds, username, database name, session id, host:port number,
+ process id, per process line number, command tag, session start time, transaction id,
+ error severity, SQL state code, statement/error message.
+
!
! start_log-collector (boolean)
!start_log_collector configuration parameter
! This parameter allows messages sent to stderr,
! and CSV logs, to be
captured and redirected into log files.
This method, in combination with logging to stderr,
is often more useful than
***
*** 2280,2285
--- 2287,2293
might not appear in syslog output (a common example
is dynamic-linker failure messages).
This parameter can only be set at server start.
+ It is required to be on if CSV logs are to be generated.
***
*** 2291,2298
! When redirect_stderr is enabled, this parameter
! determines the directory in which log files will be created.
It can be specified as an absolute path, or relative to the
cluster data directory.
This parameter can only be set in the postgresql.conf
--- 2299,2306
! When start_log_collector is enabled,
! this parameter determines the directory in which log files will be created.
It can be specified as an absolute path, or relative to the
cluster data directory.
This parameter can only be set in the postgresql.conf
***
*** 2308,2315
! When redirect_stderr is enabled, this parameter
! sets the file names of the created log files. The value
is treated as a strftime pattern,
so %-escapes can be used to specify time-varying
file names. (Note that if there are
--- 2316,2323
! When start_log_collector is enabled,
! this parameter sets the file names of the created log files. The value
is treated as a strftime pattern,
so %-escapes can be used to specify time-varying
file names. (Note that if there are
***
*** 2324,2329
--- 2332,2344
This parameter can only be set in the postgresql.conf
file or on the server command line.
+
+ If log_destination is set to csvlog,
+ .csv will be appended to the file name, to obtain the lofile
+ name for CSV logs, unless the filename ends with .log,
+ in which case the suffix is just overwritten. In the case of the example above, the
+ file name will be server_log.1093827753.csv
+
***
*** 2334,2341
! When redirect_stderr is enabled, this parameter
! determines the maximum lifetime of an individual log file.
After this many minutes have elapsed, a new log file will