add warning about enabling debug channels in logger (bug #4732)
[asterisk/asterisk.git] / configs / logger.conf.sample
1 ;
2 ; Logging Configuration
3 ;
4 ; In this file, you configure logging to files or to
5 ; the syslog system.
6 ;
7 ; "logger reload" at the CLI will reload configuration
8 ; of the logging system.
9
10 [general]
11 ; Customize the display of debug message time stamps
12 ; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS)
13 ; see strftime(3) Linux manual for format specifiers
14 ;dateformat=%F %T
15 ;
16 ; This appends the hostname to the name of the log files.
17 ;appendhostname = yes
18 ;
19 ; This determines whether or not we log queue events to a file (defaults to yes).
20 ;queue_log = no
21 ;
22 ; This determines whether or not we log generic events to a file (defaults to yes).
23 ;event_log = no
24 ;
25 ;
26 ; For each file, specify what to log.
27 ;
28 ; For console logging, you set options at start of
29 ; Asterisk with -v for verbose and -d for debug
30 ; See 'asterisk -h' for more information.
31 ;
32 ; Directory for log files is configures in asterisk.conf
33 ; option astlogdir
34 ;
35 [logfiles]
36 ;
37 ; Format is "filename" and then "levels" of debugging to be included:
38 ;    debug
39 ;    notice
40 ;    warning
41 ;    error
42 ;    verbose
43 ;
44 ; Special filename "console" represents the system console
45 ;
46 ; We highly recommend that you DO NOT turn on debug mode if you
47 ; are simply running a production system.  Debug mode turns on a
48 ; LOT of extra messages, most of which you are unlikely to understand
49 ; without an understanding of the underlying code.  Do NOT report
50 ; debug messages as code issues, unless you have a specific issue that
51 ; you are attempting to debug.  They are messages for just that --
52 ; debugging -- and do not rise to the level of something that merit
53 ; your attention as an Asterisk administrator.  Debug messages are also
54 ; very verbose and can and do fill up logfiles quickly; this is another
55 ; reason not to have debug mode on a production system unless you are
56 ; in the process of debugging a specific issue.
57 ;
58 ;debug => debug
59 console => notice,warning,error
60 ;console => notice,warning,error,debug
61 messages => notice,warning,error
62 ;full => notice,warning,error,debug,verbose
63
64 ;syslog keyword : This special keyword logs to syslog facility 
65 ;
66 ;syslog.local0 => notice,warning,error
67 ;