Introducing the log message unique call identifiers feature
[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 ;
12 ; Customize the display of debug message time stamps
13 ; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS)
14 ;
15 ; see strftime(3) Linux manual for format specifiers.  Note that there is also
16 ; a fractional second parameter which may be used in this field.  Use %1q
17 ; for tenths, %2q for hundredths, etc.
18 ;
19 ;dateformat=%F %T       ; ISO 8601 date format
20 ;dateformat=%F %T.%3q   ; with milliseconds
21 ;
22 ;
23 ; This makes Asterisk write callids to log messages
24 ; (defaults to yes)
25 ;use_callids = no
26 ;
27 ; This appends the hostname to the name of the log files.
28 ;appendhostname = yes
29 ;
30 ; This determines whether or not we log queue events to a file
31 ; (defaults to yes).
32 ;queue_log = no
33 ;
34 ; Determines whether the queue_log always goes to a file, even
35 ; when a realtime backend is present (defaults to no).
36 ;queue_log_to_file = yes
37 ;
38 ; Set the queue_log filename
39 ; (defaults to queue_log)
40 ;queue_log_name = queue_log
41 ;
42 ; Log rotation strategy:
43 ; sequential:  Rename archived logs in order, such that the newest
44 ;              has the highest sequence number [default].  When
45 ;              exec_after_rotate is set, ${filename} will specify
46 ;              the new archived logfile.
47 ; rotate:  Rotate all the old files, such that the oldest has the
48 ;          highest sequence number [this is the expected behavior
49 ;          for Unix administrators].  When exec_after_rotate is
50 ;          set, ${filename} will specify the original root filename.
51 ; timestamp:  Rename the logfiles using a timestamp instead of a
52 ;             sequence number when "logger rotate" is executed.
53 ;             When exec_after_rotate is set, ${filename} will
54 ;             specify the new archived logfile.
55 ;rotatestrategy = rotate
56 ;
57 ; Run a system command after rotating the files.  This is mainly
58 ; useful for rotatestrategy=rotate. The example allows the last
59 ; two archive files to remain uncompressed, but after that point,
60 ; they are compressed on disk.
61 ;
62 ; exec_after_rotate=gzip -9 ${filename}.2
63 ;
64 ;
65 ; For each file, specify what to log.
66 ;
67 ; For console logging, you set options at start of
68 ; Asterisk with -v for verbose and -d for debug
69 ; See 'asterisk -h' for more information.
70 ;
71 ; Directory for log files is configures in asterisk.conf
72 ; option astlogdir
73 ;
74 [logfiles]
75 ;
76 ; Format is "filename" and then "levels" of debugging to be included:
77 ;    debug
78 ;    notice
79 ;    warning
80 ;    error
81 ;    verbose(<level>)
82 ;    dtmf
83 ;    fax
84 ;    security
85 ;
86 ; Special filename "console" represents the system console
87 ;
88 ; Filenames can either be relative to the standard Asterisk log directory
89 ; (see 'astlogdir' in asterisk.conf), or absolute paths that begin with
90 ; '/'.
91 ;
92 ; Special level name "*" means all levels, even dynamic levels registered
93 ; by modules after the logger has been initialized (this means that loading
94 ; and unloading modules that create/remove dynamic logger levels will result
95 ; in these levels being included on filenames that have a level name of "*",
96 ; without any need to perform a 'logger reload' or similar operation). Note
97 ; that there is no value in specifying both "*" and specific level names for
98 ; a filename; the "*" level means all levels, and the remaining level names
99 ; will be ignored.
100 ;
101 ; Verbose takes an additional argument, in the form of an integer level.
102 ; Messages with higher levels will be ignored.  If verbose is specified at
103 ; all, it will default to 3.
104 ;
105 ; We highly recommend that you DO NOT turn on debug mode if you are simply
106 ; running a production system.  Debug mode turns on a LOT of extra messages,
107 ; most of which you are unlikely to understand without an understanding of
108 ; the underlying code.  Do NOT report debug messages as code issues, unless
109 ; you have a specific issue that you are attempting to debug.  They are
110 ; messages for just that -- debugging -- and do not rise to the level of
111 ; something that merit your attention as an Asterisk administrator.  Debug
112 ; messages are also very verbose and can and do fill up logfiles quickly;
113 ; this is another reason not to have debug mode on a production system unless
114 ; you are in the process of debugging a specific issue.
115 ;
116 ;debug => debug
117 ;security => security
118 console => notice,warning,error
119 ;console => notice,warning,error,debug
120 messages => notice,warning,error
121 ;full => notice,warning,error,debug,verbose,dtmf,fax
122
123 ;syslog keyword : This special keyword logs to syslog facility
124 ;
125 ;syslog.local0 => notice,warning,error
126 ;