Add note that the logging collector can block backends in high load situations.

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index dd37586f1c05b8d3f3db8cbe3f3c35d71d17f47d..c9603419ae4c8de0375a5515a4a579cdee6fe0e5 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -1,4 +1,4 @@
-<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.225 2009/09/08 17:08:36 tgl Exp $ -->
+<!-- $PostgreSQL: pgsql/doc/src/sgml/config.sgml,v 1.226 2009/09/10 15:02:46 alvherre Exp $ -->
 
 <chapter Id="runtime-config">
   <title>Server Configuration</title>
@@ -2422,6 +2422,19 @@ local0.*    /var/log/postgresql
          is dynamic-linker failure messages).
          This parameter can only be set at server start.
        </para>
+
+       <note>
+        <para>
+          The logging collector is designed to never lose messages.  This means
+          that in case of extremely high load, server processes could be
+          blocked due to trying to send additional log messages when the
+          collector has fallen behind.  In contrast, <application>syslog</>
+          prefers to drop messages if it cannot write them, which means it's
+          less reliable in those cases but it will not block the rest of the
+          system.
+        </para>
+       </note>
+
       </listitem>
      </varlistentry>