add warning about enabling debug channels in logger (bug #4732)

git-svn-id: http://svn.digium.com/svn/asterisk/trunk@6172 f38db490-d61c-443f-a65b-d21fe96a405b

1 files changed, 12 insertions, 0 deletions

diff --git a/configs/logger.conf.sample b/configs/logger.conf.sample
index 8c850edd5..fc000a103 100755
--- a/configs/logger.conf.sample
+++ b/configs/logger.conf.sample
@@ -43,6 +43,18 @@
 ;
 ; Special filename "console" represents the system console
 ;
+; We highly recommend that you DO NOT turn on debug mode if you
+; are simply running a production system.  Debug mode turns on a
+; LOT of extra messages, most of which you are unlikely to understand
+; without an understanding of the underlying code.  Do NOT report
+; debug messages as code issues, unless you have a specific issue that
+; you are attempting to debug.  They are messages for just that --
+; debugging -- and do not rise to the level of something that merit
+; your attention as an Asterisk administrator.  Debug messages are also
+; very verbose and can and do fill up logfiles quickly; this is another
+; reason not to have debug mode on a production system unless you are
+; in the process of debugging a specific issue.
+;
 ;debug => debug
 console => notice,warning,error
 ;console => notice,warning,error,debug