FMS的log日志设置


Server.xml (全局设置)

<!-- Overall logging configuration. This section contains only information that is  -->
<!-- that controls the overall logging behaviour. Specific logging configuration is -->
<!-- 全局log日志配置,这节只包含控制全局log日志收集情况,具体的配置文件包含在	    -->
<!-- Logger.xml这个文件中							    -->
<!-- located in Logger.xml.                                                         -->
<Logging>
<!-- The time field in a log file can be either in utc (gmt) or local (default).-->
<!-- 在时间方面日志文件是以GMT(格林尼治)时间或本地时间(默认是本地时间)		-->
<Time>local</Time>
	<Access>
		<!-- Whether access logging is enabled.                                     -->
		<!-- 服务器访问日志是否启用设置						    -->
        	<Enable>true</Enable>

        	<!-- The logging scope determines whether a log file is written out for     -->
        	<!-- each vhost or just one for the entire server. It may be either server  -->
        	<!-- or vhost.                                                              -->
		<!-- 日志范围的确定,是每个虚拟主机分开记录还是只对整个服务器记录,选项可以   -->
		<!-- server或者vhost							    -->
        	<Scope>server</Scope>
        </Access>
        <Diagnostic>
        	<!-- Whether diagnostic logging is enabled.                                 -->
		<!-- 诊断日志是否启用设置						    -->
        	<Enable>true</Enable>
        </Diagnostic>
        <Application>
        	<!-- Whether application logging is enabled.                                -->
		<!-- 应用程序日志是否启用设置						    -->
        	<Enable>true</Enable>
        </Application>
</Logging>

======================================================================================

Logger.xml (日志文件具体设置)

<Logger>
	<Access>
		<!-- This section configures the server to send log msgs to a   -->
		<!-- remote logging server. To enable this feature, set the     -->
		<!-- "enable" attribute to true. You can choose the type of     -->
		<!-- connection to use by specifying the "type" attribute which -->
		<!-- can be set to either "udp" or "tcp". Default is udp.       -->
		<!-- 本节配置服务器发送日志信息到一个远程日志服务器,要实现这个这-->
		<!-- 个功能,可以设置"enable"的属性为"true".你可以选择使用何种连 -->
		<!-- 接方式,可以设定为"udp"或者"tcp",默认是udp                  -->
		<LogServer enable="false" type="udp">
			<!-- Specify the IP and port of the server to log to.       -->
			<!-- 明确日志服务器的IP和端口                               -->
			<!-- For example,                                           -->
			<!-- <HostPort>xxx.xxx.xxx.xxx:1234</HostPort>              -->
			<HostPort></HostPort>
		
			<!-- This is an identifier used to identify the server that -->
			<!-- the log came from. By default, this is the IP address  -->
			<!-- of this server.                                        -->
			<!-- 这是用来设置标识log日志中服务器的来源,默认是这个服务器 -->
			<!-- IP地址.                                                -->
			<ServerID></ServerID>

			<!-- This specifies how many lines to log before including  -->
			<!-- the fields header again.                               -->
			<DisplayFieldsHeader>100</DisplayFieldsHeader>
		</LogServer>

		<!-- Directory in which log files will be placed, by default they are       -->
		<!-- placed in logs/ in the server installation directory.                  -->
		<!-- 日志文件得存放路径,默认日志文件会存放在服务器安装得根目录下的logs目录  -->
		<Directory>${LOGGER.LOGDIR}</Directory>

		<!-- Access log file name, everything inside the square brackets will be    -->
		<!-- substituted.                                                           -->
		<!-- Y represents Year, only YYYY is allowed                                -->
		<!-- M represents Month, only M or MM are allowed                           -->
		<!-- D represents Day, only D or DD are allowed                             -->
		<!-- N represents Version, there is no limit on number of N                 -->
		<!-- The number of each letter represents number of digits, for example     -->
		<!-- April in M is 4 and in MM is 04                                        -->	
		<!-- 访问日志名称规则,方括号内可以用以下替代				    -->
		<!-- Y 代表连,只有 YYYY 才被允许					    -->
		<!-- M 代表月,只有 M 或者 MM 才被允许					    -->
		<!-- D 代表日,只有 D 或者 DD 才被允许					    -->
		<!-- N 代表版本号,这里没有针对N数量的限制				    -->
		<!-- 每个字母的数量代表一些数字,举例					    -->
		<!-- 4月 用 M 表示就是4 用MM表示就是04					    -->
		<FileName>access.[NN].log</FileName>

		<!-- The time field in a log file can be either in utc or local time. The   -->
		<!-- setting here can be used to override the server-wide configuration,    -->
		<!-- see <Logging> in Server.xml.                                           -->
		<!-- 在日志里的时间字段,可以设置为UTC或者当地时间,这个设置可以覆盖服务器配置-->
		<!-- 中logging段中的全局设置						-->
		<Time></Time>

		<Rotation>
		<!-- Maximum file size in kilobytes (1024 bytes)                          -->
		<!-- 日志轮循设置,设置每个轮循日志的最大文件大小KB			-->
		<MaxSize>10240</MaxSize>

		<!-- Rotation Time, there are 2 types					-->
		<!-- If type="daily", rotation only occurs every 24 hours, and the format -->
		<!-- is hh:mm, for example 00:00 will rotates every midnight          -->
		<!-- If type="duration", rotation occurs when the duration of the log 	-->
		<!-- exceed a certain length, duration takes a number in minutes  	-->
		<!-- 轮循间隔时间,这里有2种方式					-->
		<!-- 如果方式为"daily",就每隔24小时轮循一次,后面的时间参数是hh:mm,比如-->
		<!-- 00:00 代表每天0点轮循						-->
		<!-- 如果方式为"duration",就是当超过一定时间就轮循			-->
		<Schedule type="daily">00:00</Schedule>

		<!-- Max number of log files to keep, files will be named access.01.log,  -->
		<!-- access.02.log, access.03.log etc.                                    -->
		<!-- 如果日志命名为access.01.log,access.03.log,access.03.log时,日志文件的 -->
		<!-- 最大保存数量							-->
		<History>5</History>
		</Rotation>

		<!-- The following describes which events to be logged. The various events  -->
		<!-- are as follows,                                                        -->
		<!--    Event Name						Category        -->
		<!--    ==========						========        -->
		<!--    1. connect-pending              session                             -->
		<!--    2. connect                      session                             -->
		<!--    3. disconnect                   session                             -->
		<!--    4. publish                      stream                              -->
		<!--    5. unpublish                    stream                              -->
		<!--    6. play                         stream                              -->
		<!--    7. pause                        stream                              -->
		<!--    8. unpause                      stream                              -->
		<!--    9. seek                         stream                              -->
		<!--   10. stop                         stream                              -->
		<!--   11. record                       stream                              -->
		<!--   12. recordstop                   stream                              -->
		<!--   13. server-start                 server                              -->
		<!--   14. server-stop                  server                              -->
		<!--   15. vhost-start                  vhost                               -->
		<!--   16. vhost-stop                   vhost                               -->
		<!--   17. app-start                    application                         -->
		<!--   18. app-stop                     application                         -->
		<!-- The desired events are specified as a semi-colon separated list.       -->
		<!-- Specifying * will log all events.                                      -->
		<!-- 以下事件行为将被记录到日志中,各项时间行为包括		            -->
		<!-- 略									    -->
		<!-- 如果指定为 * 则记录所有的事件行为					    -->
		<Events>connect;disconnect;play;pause;unpause;stop</Events>


		<!-- The following describes what information gets logged for each event.   -->
		<!-- Not all fields make sense for all events in which case they will be    -->
		<!-- empty in the log file. The possible fields are,                        -->
		<!--    1. x-event          Type of event                                   -->
		<!--    2. x-category       Event category                                  -->
		<!--    3. date             Date at which the event occurred                -->
		<!--    4. time             Time at which the event occurred                -->
		<!--    5. tz               Time zone information                           -->
		<!--    6. x-ctx            event dependant context information             -->
		<!--    7. x-pid            server process id                               -->
		<!--    8. x-cpu-load       cpu load                                        -->
		<!--    9. x-mem-load       memory load (as reported in getServerStats)     -->
		<!--   10. x-adaptor        adaptor name                                    -->
		<!--   11. x-vhost          vhost name                                      -->
		<!--   12. x-app	        application name                            -->
		<!--   13. x-appinst        application instance name                       -->
		<!--   14. c-ip             client ip address                               -->
		<!--   15. c-proto          connection protocol - rtmp or rtmpt             -->
		<!--   16. s-uri            uri of the fms application                      -->
		<!--   17. c-referrer       uri of the referrer                             -->
		<!--   18. c-user-agent     user agent                                      -->
		<!--   19. c-client-id      client id                                       -->
		<!--   20. cs-bytes         bytes transferred from client to server         -->
		<!--   21. sc-bytes         bytes transferred from server to client         -->
		<!--   22. x-sname          stream name                                     -->
		<!--   23. x-file-size      stream size in bytes                            -->
		<!--   24. x-file-length    stream length in seconds                        -->
		<!--   25. x-spos           stream position                                 -->
		<!--   26. cs-stream-bytes  stream bytes transferred from client to server  -->
		<!--   27. sc-stream-bytes  stream bytes transferred from server to client  -->
		<!--   28. s-ip		ip address[es] of the server                    -->
		<!--   29. x-duration	duration of an event/session                    -->
		<!--   30. x-status		status code				-->
		<!--   31. cs-uri-stem      stem of s-uri                               -->
		<!--   32. cs-uri-query     query portion of s-uri                          -->
		<!--   33. x-sname-query    query portion of stream uri                     -->
		<!--   34. x-file-name      Full file path of recorded stream               -->
		<!--   35. x-file-ext       stream type (flv or mp3)                        -->
		<!--   36. x-suri-query		Same as x-sname-query			    -->
		<!--   37. x-suri-stem		cs-uri-stem + x-sname + x-file-ext	    -->
		<!--   38. x-suri			x-suri-stem + x-suri-query	    -->
		<!--   39. x-sc-qos-bytes	bytes transferred from server to client for quality of service	-->
    		<!-- The field specification is a semi-colon separated list of one or more  -->
    		<!-- and the special key word * indicates that all fields are to be logged. -->
    		<!-- When customizing the fields to be logged, it is strongly recommended   -->
    		<!-- to always at least log the type, category, date and time fields.       -->
		<!-- 下列哪些信息将被记录到每个事件行为中,不是所有的信息都可能传送到日志中  -->
		<!-- 所有可能有部分是空白的,在日志中.					    -->
    		<!-- 如果指定为 * 则记录所有的事件行为					    -->
    		<Fields>x-category;x-event;date;time;x-pid;c-ip;cs-bytes;sc-bytes;x-sname;sc-stream-bytes;x-file-size;x-file-length</Fields>

		<!-- Delimiter is used to separate between fields                           -->
		<!-- Recommended: tab or ' '. If no delimiter is specified, default is tab  -->
		<!-- Not Recommended: '#', because it is used as comment tag in W3C format  -->
		<!-- Disallowed: ''', '"', '.', ':', '-', '\' and all alpha-numeric         -->
		<!-- (a-z, A-Z, 0-9).  Character ':' and '-' are not allowed because ':' is -->
		<!-- used in the time field and '-' is used in the date field and fields    -->
		<!-- with empty value.                                                      -->
    		<Delimiter></Delimiter>

		<!-- This is an optional flag to control if the fields need to be quoted    -->
		<!-- when space or delimiter are found in the fields.  It can be set to     -->
		<!-- enable or disable.  By default, it is set to disable                   -->
		<!-- 这个选项是控制时候需要启用引用,当在log日志中显示的信息字段中发现空格键 -->
		<!-- 可以设置为enable或者disable 默认是disable				    -->
		<QuoteFields>disable</QuoteFields>

		<!-- This is an optional flag to control if the fields need to be escaped   -->
		<!-- when unsafe characters are found in the fields.  It can be set to      -->
		<!-- enable or disable.  By default, it is set to enable                   -->
		<!-- Based on rfc1738, unsafe characters are space, <, >, ", #, %, {, }, |, -->
		<!-- ^, ~, [, ], `                                                          -->	
		<EscapeFields>enable</EscapeFields>

  	</Access>
  	<Diagnostic>
		<!-- Directory in which log files will be placed, by default they are       -->
		<!-- placed in logs/ in the server installation directory.                  -->
		<!-- 诊断日志文件得存放路径,默认日志文件会存放在服务器安装得根目录下的logs  -->
		<!-- 目录								    -->
		<Directory>${LOGGER.LOGDIR}</Directory>

    		<!-- The time field in a log file can be either in utc or local time. The   -->
    		<!-- setting here can be used to override the server-wide configuration,    -->
    		<!-- see <Logging> in Server.xml.                                           -->
		<!-- 在日志里的时间字段,可以设置为UTC或者当地时间,这个设置可以覆盖服务器配置-->
		<!-- 中logging段中的全局设置						    -->
    		<Time></Time>

		<Rotation>
	  	<!-- Maximum file size in kilobytes (1024 bytes)                          -->
	  	<!-- 日志轮循设置,设置每个轮循日志的最大文件大小KB			  -->
	  	<MaxSize>10240</MaxSize>

	  	<!-- Rotation Time, there are 2 types					-->
	  	<!-- If type="daily", rotation only occurs every 24 hours, and the format -->
	  	<!-- is hh:mm, for example 00:00 will rotates every midnight              -->
	  	<!-- If type="duration", rotation occurs when the duration of the log 	-->
	  	<!-- exceed a certain length, duration takes a number in minutes  	-->
	  	<!-- 轮循间隔时间,这里有2种方式						-->
	  	<!-- 如果方式为"daily",就每隔24小时轮循一次,后面的时间参数是hh:mm,比如	-->
	  	<!-- 00:00 代表每天0点轮循						-->
	  	<!-- 如果方式为"duration",就是当超过一定时间就轮循			-->
	  	<Schedule type="daily">00:00</Schedule>

	  	<!-- Max number of log files to keep, files will be named admin.01.log,   -->
	  	<!-- admin.02.log, admin.03.log etc.                                      -->
	  	<!-- 如果日志命名为access.01.log,access.03.log,access.03.log时,日志文件的 -->
	  	<!-- 最大保存数量							-->
	 	<History>5</History>
		</Rotation>
  	</Diagnostic>
  	<Application>
		<!-- Directory in which log files will be placed, by default they are       -->
		<!-- placed in logs/ in the server installation directory.                  -->
		<!-- 应用程序日志文件得存放路径,默认日志文件会存放在服务器安装得根目录下的-->
		<!-- logs目录下								-->
		<Directory>${LOGGER.LOGDIR}</Directory>

    		<!-- The time field in a log file can be either in utc or local time. The   -->
    		<!-- setting here can be used to override the server-wide configuration,    -->
    		<!-- see <Logging> in Server.xml.                                           -->
		<!-- 在日志里的时间字段,可以设置为UTC或者当地时间,这个设置可以覆盖服务器配置-->
		<!-- 中logging段中的全局设置						-->
   		 <Time></Time>

		<Rotation>
	  	<!-- Maximum file size in kilobytes (1024 bytes)                        -->
	  	<!-- 日志轮循设置,设置每个轮循日志的最大文件大小KB			-->
	  	<MaxSize>10240</MaxSize>

	  	<!-- Rotation Time, there are 2 types					-->
	  	<!-- If type="daily", rotation only occurs every 24 hours, and the format -->
	  	<!-- is hh:mm, for example 00:00 will rotates every midnight              -->
	  	<!-- If type="duration", rotation occurs when the duration of the log 	-->
	  	<!-- exceed a certain length, duration takes a number in minutes  	-->
	  	<!-- 轮循间隔时间,这里有2种方式						-->
	  	<!-- 如果方式为"daily",就每隔24小时轮循一次,后面的时间参数是hh:mm,比如	-->
	  	<!-- 00:00 代表每天0点轮循						-->
	  	<!-- 如果方式为"duration",就是当超过一定时间就轮循			-->
	  	<Schedule type="daily">00:00</Schedule>

	  	<!-- Max number of log files to keep, files will be named                 -->
	  	<!-- application.01.log, application.02.log etc.                          -->
	  	<!-- 如果日志命名为access.01.log,access.03.log,access.03.log时,日志文件的 -->
	  	<!-- 最大保存数量							-->
	  	<History>5</History>
		</Rotation>
  	</Application>
</Logger>