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>