| 
									
										
										
										
											2002-02-11 04:25:04 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Logging Configuration | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-01-28 21:13:50 +00:00
										 |  |  | ; In this file, you configure logging to files or to | 
					
						
							|  |  |  | ; the syslog system. | 
					
						
							| 
									
										
										
										
											2005-03-17 15:56:55 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; "logger reload" at the CLI will reload configuration | 
					
						
							|  |  |  | ; of the logging system. | 
					
						
							| 
									
										
										
										
											2004-05-18 05:47:27 +00:00
										 |  |  | 
 | 
					
						
							|  |  |  | [general] | 
					
						
							| 
									
										
										
										
											2007-08-17 16:39:41 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-05-18 05:47:27 +00:00
										 |  |  | ; Customize the display of debug message time stamps | 
					
						
							|  |  |  | ; this example is the ISO 8601 date format (yyyy-mm-dd HH:MM:SS) | 
					
						
							| 
									
										
										
										
											2007-08-17 16:39:41 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; see strftime(3) Linux manual for format specifiers.  Note that there is also | 
					
						
							|  |  |  | ; a fractional second parameter which may be used in this field.  Use %1q | 
					
						
							|  |  |  | ; for tenths, %2q for hundredths, etc. | 
					
						
							| 
									
										
										
										
											2009-05-28 14:39:21 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2007-08-17 16:39:41 +00:00
										 |  |  | ;dateformat=%F %T       ; ISO 8601 date format | 
					
						
							|  |  |  | ;dateformat=%F %T.%3q   ; with milliseconds | 
					
						
							| 
									
										
										
										
											2004-09-05 03:48:05 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; This appends the hostname to the name of the log files. | 
					
						
							|  |  |  | ;appendhostname = yes | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; This determines whether or not we log queue events to a file | 
					
						
							|  |  |  | ; (defaults to yes). | 
					
						
							| 
									
										
										
										
											2005-03-11 08:49:01 +00:00
										 |  |  | ;queue_log = no | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2010-07-20 23:23:25 +00:00
										 |  |  | ; Determines whether the queue_log always goes to a file, even | 
					
						
							|  |  |  | ; when a realtime backend is present (defaults to no). | 
					
						
							|  |  |  | ;queue_log_to_file = yes | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2006-09-26 17:09:01 +00:00
										 |  |  | ; Set the queue_log filename | 
					
						
							|  |  |  | ; (defaults to queue_log) | 
					
						
							|  |  |  | ;queue_log_name = queue_log | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2007-08-28 20:03:48 +00:00
										 |  |  | ; Log rotation strategy: | 
					
						
							|  |  |  | ; sequential:  Rename archived logs in order, such that the newest | 
					
						
							| 
									
										
										
										
											2010-07-20 23:23:25 +00:00
										 |  |  | ;              has the highest sequence number [default].  When | 
					
						
							|  |  |  | ;              exec_after_rotate is set, ${filename} will specify | 
					
						
							|  |  |  | ;              the new archived logfile. | 
					
						
							| 
									
										
										
										
											2007-08-28 20:03:48 +00:00
										 |  |  | ; rotate:  Rotate all the old files, such that the oldest has the | 
					
						
							|  |  |  | ;          highest sequence number [this is the expected behavior | 
					
						
							| 
									
										
										
										
											2010-07-20 23:23:25 +00:00
										 |  |  | ;          for Unix administrators].  When exec_after_rotate is | 
					
						
							|  |  |  | ;          set, ${filename} will specify the original root filename. | 
					
						
							| 
									
										
										
										
											2007-08-28 20:03:48 +00:00
										 |  |  | ; timestamp:  Rename the logfiles using a timestamp instead of a | 
					
						
							|  |  |  | ;             sequence number when "logger rotate" is executed. | 
					
						
							| 
									
										
										
										
											2010-07-20 23:23:25 +00:00
										 |  |  | ;             When exec_after_rotate is set, ${filename} will | 
					
						
							|  |  |  | ;             specify the new archived logfile. | 
					
						
							| 
									
										
										
										
											2007-08-28 20:03:48 +00:00
										 |  |  | ;rotatestrategy = rotate | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; Run a system command after rotating the files.  This is mainly | 
					
						
							|  |  |  | ; useful for rotatestrategy=rotate. The example allows the last | 
					
						
							|  |  |  | ; two archive files to remain uncompressed, but after that point, | 
					
						
							|  |  |  | ; they are compressed on disk. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; exec_after_rotate=gzip -9 ${filename}.2 | 
					
						
							| 
									
										
										
										
											2006-10-02 17:54:21 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-01-28 21:13:50 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; For each file, specify what to log. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; For console logging, you set options at start of | 
					
						
							|  |  |  | ; Asterisk with -v for verbose and -d for debug | 
					
						
							|  |  |  | ; See 'asterisk -h' for more information. | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; Directory for log files is configures in asterisk.conf | 
					
						
							|  |  |  | ; option astlogdir | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2002-02-11 04:25:04 +00:00
										 |  |  | [logfiles] | 
					
						
							|  |  |  | ; | 
					
						
							|  |  |  | ; Format is "filename" and then "levels" of debugging to be included: | 
					
						
							|  |  |  | ;    debug | 
					
						
							|  |  |  | ;    notice | 
					
						
							|  |  |  | ;    warning | 
					
						
							|  |  |  | ;    error | 
					
						
							| 
									
										
										
										
											2004-01-28 21:13:50 +00:00
										 |  |  | ;    verbose | 
					
						
							| 
									
										
										
										
											2005-08-22 21:19:59 +00:00
										 |  |  | ;    dtmf | 
					
						
							| 
									
										
										
										
											2010-07-26 19:51:39 +00:00
										 |  |  | ;    fax | 
					
						
							| 
									
										
										
										
											2002-02-11 04:25:04 +00:00
										 |  |  | ; | 
					
						
							|  |  |  | ; Special filename "console" represents the system console | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2009-05-15 18:43:42 +00:00
										 |  |  | ; Filenames can either be relative to the standard Asterisk log directory | 
					
						
							| 
									
										
										
										
											2009-05-08 14:06:15 +00:00
										 |  |  | ; (see 'astlogdir' in asterisk.conf), or absolute paths that begin with | 
					
						
							|  |  |  | ; '/'. | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2010-05-19 15:29:28 +00:00
										 |  |  | ; Special level name "*" means all levels, even dynamic levels registered | 
					
						
							|  |  |  | ; by modules after the logger has been initialized (this means that loading | 
					
						
							|  |  |  | ; and unloading modules that create/remove dynamic logger levels will result | 
					
						
							|  |  |  | ; in these levels being included on filenames that have a level name of "*", | 
					
						
							|  |  |  | ; without any need to perform a 'logger reload' or similar operation). Note | 
					
						
							|  |  |  | ; that there is no value in specifying both "*" and specific level names for | 
					
						
							|  |  |  | ; a filename; the "*" level means all levels, and the remaining level names | 
					
						
							|  |  |  | ; will be ignored. | 
					
						
							|  |  |  | ; | 
					
						
							| 
									
										
										
										
											2005-10-04 22:51:59 +00:00
										 |  |  | ; 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. | 
					
						
							| 
									
										
										
										
											2005-07-20 00:16:15 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2002-02-11 04:25:04 +00:00
										 |  |  | ;debug => debug | 
					
						
							|  |  |  | console => notice,warning,error | 
					
						
							| 
									
										
										
										
											2003-09-28 20:05:12 +00:00
										 |  |  | ;console => notice,warning,error,debug | 
					
						
							| 
									
										
										
										
											2002-02-11 04:25:04 +00:00
										 |  |  | messages => notice,warning,error | 
					
						
							| 
									
										
										
										
											2010-07-26 19:51:39 +00:00
										 |  |  | ;full => notice,warning,error,debug,verbose,dtmf,fax | 
					
						
							| 
									
										
										
										
											2003-11-26 22:00:07 +00:00
										 |  |  | 
 | 
					
						
							| 
									
										
										
										
											2009-05-28 14:39:21 +00:00
										 |  |  | ;syslog keyword : This special keyword logs to syslog facility | 
					
						
							| 
									
										
										
										
											2003-11-26 22:00:07 +00:00
										 |  |  | ; | 
					
						
							| 
									
										
										
										
											2004-01-12 05:05:35 +00:00
										 |  |  | ;syslog.local0 => notice,warning,error | 
					
						
							|  |  |  | ; |